skillpm 0.0.6 → 0.0.7

package/README.md

@@ -70,6 +70,29 @@ skillpm doesn't reinvent anything. It orchestrates three battle-tested tools: np
 
 Aliases: `i` for `install`, `rm`/`remove` for `uninstall`, `ls` for `list`.
 
+## Monorepo / npm workspace support
+
+If your repo is an **npm workspace monorepo** where each skill is a first-party package (e.g. `skills/<name>/` entries in the root `package.json` workspaces field), npm installs them as symlinks inside `node_modules/`:
+
+```
+node_modules/
+  @org/
+    my-skill → ../../skills/my-skill   ← symlink
+```
+
+`skillpm sync` (and `skillpm install`) automatically detects these symlinks and treats them as workspace packages:
+
+- Configs are copied from the symlinked skill's `configs/` directory into the workspace root, exactly as for externally installed skills.
+- Workspace packages are identified in log output: `Linking workspace package @org/my-skill@1.0.0`.
+
+This lets contributors regenerate deployed copies (agent definitions, prompts, rules) by running:
+
+```bash
+skillpm sync
+```
+
+No manual copy steps needed. Commit the regenerated files as usual.
+
 ## Creating a skill
 
 ```bash

package/dist/cli.js

@@ -7,7 +7,7 @@ import { publish } from './commands/publish.js';
 import { sync } from './commands/sync.js';
 import { mcp } from './commands/mcp.js';
 import { log } from './utils/index.js';
-const VERSION = '0.0.4';
+const VERSION = '0.0.7';
 const HELP = `
 skillpm — Agent Skill package manager
 

package/dist/commands/install.js

@@ -36,7 +36,8 @@ export async function wireSkills(cwd) {
     log.info(`Found ${skills.length} skill package(s)`);
     // Wire each skill into agent directories via skills CLI
     for (const skill of skills) {
-        log.info(`Linking ${log.skill(skill.name, skill.version)} into agent directories`);
+        const label = skill.workspace ? `workspace package ${log.skill(skill.name, skill.version)}` : log.skill(skill.name, skill.version);
+        log.info(`Linking ${label} into agent directories`);
         try {
             await npx(['skills', 'add', skill.skillDir, '--all', '-y'], { cwd });
             log.success(`Linked ${skill.name}`);
@@ -68,7 +69,8 @@ export async function wireSkills(cwd) {
     // Copy configs/ files (agents, prompts, rules) into workspace
     for (const skill of skills) {
         if (skill.configsDir) {
-            log.info(`Copying config files from ${log.skill(skill.name, skill.version)}`);
+            const label = skill.workspace ? `workspace package ${log.skill(skill.name, skill.version)}` : log.skill(skill.name, skill.version);
+            log.info(`Copying config files from ${label}`);
             try {
                 const copied = await copyConfigs(skill.configsDir, cwd, skill.name, skill.configPrefix);
                 log.success(`Copied ${copied.length} config file(s) from ${skill.name}`);

package/dist/manifest/schema.d.ts

@@ -29,4 +29,9 @@ export interface SkillInfo {
      * Declared via skillpm.configPrefix in package.json.
      */
     configPrefix?: string;
+    /**
+     * True when the package was found via a symlink in node_modules/ — typically
+     * an npm workspace package (first-party skill in the same monorepo).
+     */
+    workspace?: boolean;
 }

package/dist/scanner/index.d.ts

@@ -1,6 +1,8 @@
 import type { SkillInfo } from '../manifest/schema.js';
 /**
  * Scan node_modules/ for packages that contain a skills/<name>/SKILL.md file.
+ * Also follows symlinks — npm workspace packages appear as symlinks inside
+ * node_modules/ and are flagged with `workspace: true` on the returned SkillInfo.
  * Returns metadata for each discovered skill package.
  */
 export declare function scanNodeModules(cwd: string): Promise<SkillInfo[]>;

package/dist/scanner/index.js

@@ -1,8 +1,23 @@
-import { readdir, access } from 'node:fs/promises';
+import { readdir, access, lstat } from 'node:fs/promises';
 import { join } from 'node:path';
 import { readPackageJson, parseSkillpmField } from '../manifest/index.js';
+/**
+ * Return true if the given path is a symbolic link (or on Windows, a junction).
+ * Does NOT follow the link — uses lstat so the link itself is inspected.
+ */
+async function isSymlink(p) {
+    try {
+        const s = await lstat(p);
+        return s.isSymbolicLink();
+    }
+    catch {
+        return false;
+    }
+}
 /**
  * Scan node_modules/ for packages that contain a skills/<name>/SKILL.md file.
+ * Also follows symlinks — npm workspace packages appear as symlinks inside
+ * node_modules/ and are flagged with `workspace: true` on the returned SkillInfo.
  * Returns metadata for each discovered skill package.
  */
 export async function scanNodeModules(cwd) {
@@ -30,14 +45,16 @@ export async function scanNodeModules(cwd) {
             }
             for (const scopedEntry of scopedEntries) {
                 const pkgDir = join(scopeDir, scopedEntry);
-                const skill = await tryReadSkill(pkgDir);
+                const symlink = await isSymlink(pkgDir);
+                const skill = await tryReadSkill(pkgDir, symlink);
                 if (skill)
                     skills.push(skill);
             }
         }
         else {
             const pkgDir = join(nodeModulesDir, entry);
-            const skill = await tryReadSkill(pkgDir);
+            const symlink = await isSymlink(pkgDir);
+            const skill = await tryReadSkill(pkgDir, symlink);
             if (skill)
                 skills.push(skill);
         }
@@ -53,7 +70,7 @@ async function hasDir(dir) {
         return false;
     }
 }
-async function tryReadSkill(pkgDir) {
+async function tryReadSkill(pkgDir, workspace = false) {
     const pkg = await readPackageJson(pkgDir);
     if (!pkg)
         return null;
@@ -86,6 +103,7 @@ async function tryReadSkill(pkgDir) {
             mcpServers: skillpm?.mcpServers ?? [],
             configsDir: hasConfigs ? configsDir : undefined,
             configPrefix: skillpm?.configPrefix,
+            workspace: workspace || undefined,
         };
     }
     // Fallback: root SKILL.md (legacy format)
@@ -105,6 +123,7 @@ async function tryReadSkill(pkgDir) {
         legacy: true,
         configsDir: hasConfigs ? configsDir : undefined,
         configPrefix: skillpm?.configPrefix,
+        workspace: workspace || undefined,
     };
 }
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "skillpm",
-  "version": "0.0.6",
+  "version": "0.0.7",
   "description": "Package manager for Agent Skills. Built on npm.",
   "type": "module",
   "bin": {