skillpm 0.0.5 → 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,9 +69,10 @@ 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);
+                const copied = await copyConfigs(skill.configsDir, cwd, skill.name, skill.configPrefix);
                 log.success(`Copied ${copied.length} config file(s) from ${skill.name}`);
             }
             catch (err) {

package/dist/configs/index.d.ts

@@ -1,8 +1,20 @@
 /**
  * Copy all files from a skill's configs/ directory to the workspace,
- * auto-prefixing filenames with the package name.
+ * auto-prefixing filenames to avoid conflicts between installed skills.
+ *
+ * The prefix used is, in priority order:
+ *   1. `configPrefix` argument (from skillpm.configPrefix in package.json)
+ *   2. De-scoped package name (strips "@scope/" from scoped packages)
+ *
+ * Examples:
+ *   packageName="@mcaps/spt-iq-consumption", configPrefix="consumption"
+ *     → "consumption-briefing.md"
+ *   packageName="@mcaps/spt-iq-consumption", no configPrefix
+ *     → "spt-iq-consumption-briefing.md"
+ *   packageName="my-skill", no configPrefix
+ *     → "my-skill-briefing.md"
  */
-export declare function copyConfigs(configsDir: string, cwd: string, packageName: string): Promise<string[]>;
+export declare function copyConfigs(configsDir: string, cwd: string, packageName: string, configPrefix?: string): Promise<string[]>;
 /**
  * Remove all config files for a package using the manifest.
  */

package/dist/configs/index.js

@@ -2,6 +2,10 @@ import { readdir, copyFile, mkdir, unlink, readFile, writeFile, stat } from 'nod
 import { join, relative, dirname, basename } from 'node:path';
 const MANIFEST_DIR = '.skillpm';
 const MANIFEST_FILE = 'manifest.json';
+/** Normalize path separators to forward slashes for cross-platform consistency. */
+function normalizePath(p) {
+    return p.replace(/\\/g, '/');
+}
 async function readManifest(cwd) {
     try {
         const raw = await readFile(join(cwd, MANIFEST_DIR, MANIFEST_FILE), 'utf-8');
@@ -36,30 +40,55 @@ async function walkDir(dir, root) {
             files.push(...(await walkDir(full, root)));
         }
         else {
-            files.push(relative(root, full));
+            files.push(normalizePath(relative(root, full)));
         }
     }
     return files;
 }
 /**
- * Auto-prefix a filename with the package name to avoid conflicts.
- * e.g. "reviewer.md" with package "my-skill" → "my-skill--reviewer.md"
+ * Strip npm scope from a package name.
+ * e.g. "@mcaps/spt-iq-consumption" → "spt-iq-consumption"
+ *      "spt-iq-consumption"       → "spt-iq-consumption"
+ */
+function stripScope(packageName) {
+    if (packageName.startsWith('@')) {
+        const slash = packageName.indexOf('/');
+        return slash >= 0 ? packageName.slice(slash + 1) : packageName;
+    }
+    return packageName;
+}
+/**
+ * Auto-prefix a filename with the resolved prefix to avoid conflicts.
+ * e.g. "reviewer.md" with prefix "my-skill" → "my-skill-reviewer.md"
  */
-function prefixFilename(relPath, packageName) {
+function prefixFilename(relPath, prefix) {
     const dir = dirname(relPath);
     const file = basename(relPath);
-    const prefixed = `${packageName}--${file}`;
-    return dir === '.' ? prefixed : join(dir, prefixed);
+    const prefixed = `${prefix}-${file}`;
+    return normalizePath(dir === '.' ? prefixed : join(dir, prefixed));
 }
 /**
  * Copy all files from a skill's configs/ directory to the workspace,
- * auto-prefixing filenames with the package name.
+ * auto-prefixing filenames to avoid conflicts between installed skills.
+ *
+ * The prefix used is, in priority order:
+ *   1. `configPrefix` argument (from skillpm.configPrefix in package.json)
+ *   2. De-scoped package name (strips "@scope/" from scoped packages)
+ *
+ * Examples:
+ *   packageName="@mcaps/spt-iq-consumption", configPrefix="consumption"
+ *     → "consumption-briefing.md"
+ *   packageName="@mcaps/spt-iq-consumption", no configPrefix
+ *     → "spt-iq-consumption-briefing.md"
+ *   packageName="my-skill", no configPrefix
+ *     → "my-skill-briefing.md"
  */
-export async function copyConfigs(configsDir, cwd, packageName) {
+export async function copyConfigs(configsDir, cwd, packageName, configPrefix) {
+    const prefix = configPrefix ?? stripScope(packageName);
     const files = await walkDir(configsDir);
     const copied = [];
     for (const relPath of files) {
-        const prefixed = prefixFilename(relPath, packageName);
+        const prefixed = prefixFilename(relPath, prefix);
         const src = join(configsDir, relPath);
         const dest = join(cwd, prefixed);
         await mkdir(dirname(dest), { recursive: true });

package/dist/manifest/schema.d.ts

@@ -1,6 +1,7 @@
 import { z } from 'zod';
 export declare const SkillpmFieldSchema: z.ZodOptional<z.ZodObject<{
     mcpServers: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    configPrefix: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>>;
 export type SkillpmField = z.infer<typeof SkillpmFieldSchema>;
 export interface SkillPackageJson {
@@ -21,4 +22,16 @@ export interface SkillInfo {
     legacy?: boolean;
     /** Path to configs/ directory if present (mirrors workspace layout) */
     configsDir?: string;
+    /**
+     * Optional prefix override for config file naming.
+     * When set, used instead of the (de-scoped) package name.
+     * e.g. configPrefix: "consumption" → "consumption--briefing.md"
+     * 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/manifest/schema.js

@@ -2,6 +2,7 @@ import { z } from 'zod';
 export const SkillpmFieldSchema = z
     .object({
     mcpServers: z.array(z.string()).optional(),
+    configPrefix: z.string().optional(),
 })
     .strict()
     .optional();

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;
@@ -85,6 +102,8 @@ async function tryReadSkill(pkgDir) {
             skillDir,
             mcpServers: skillpm?.mcpServers ?? [],
             configsDir: hasConfigs ? configsDir : undefined,
+            configPrefix: skillpm?.configPrefix,
+            workspace: workspace || undefined,
         };
     }
     // Fallback: root SKILL.md (legacy format)
@@ -103,6 +122,8 @@ async function tryReadSkill(pkgDir) {
         mcpServers: skillpm?.mcpServers ?? [],
         legacy: true,
         configsDir: hasConfigs ? configsDir : undefined,
+        configPrefix: skillpm?.configPrefix,
+        workspace: workspace || undefined,
     };
 }
 /**

package/package.json

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