@skillsmith/cli 0.5.12 → 0.6.0

package/dist/src/templates/mcp-server.template.d.ts

@@ -70,7 +70,7 @@ export declare const EXAMPLE_TOOL_TS_TEMPLATE = "/**\n * Example Tool Implementa
 /**
  * README.md template for MCP server
  */
-export declare const MCP_README_TEMPLATE = "# {{name}}\n\n{{description}}\n\n## Installation\n\n```bash\nnpm install -g {{name}}\n```\n\nOr use directly with npx:\n\n```bash\nnpx {{name}}\n```\n\n## Configuration\n\nAdd to your Claude configuration (`~/.claude/settings.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"{{name}}\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"{{name}}\"]\n    }\n  }\n}\n```\n\n## Available Tools\n\n{{toolDocs}}\n\n## Development\n\n```bash\n# Install dependencies\nnpm install\n\n# Run in development mode\nnpm run dev\n\n# Build for production\nnpm run build\n\n# Run production build\nnpm start\n```\n\n## License\n\nMIT\n";
+export declare const MCP_README_TEMPLATE = "# {{name}}\n\n{{description}}\n\n## Installation\n\n```bash\nnpm install -g {{name}}\n```\n\nOr use directly with npx:\n\n```bash\nnpx {{name}}\n```\n\n## Configuration\n\nThis server is MCP-compatible \u2014 pick the snippet that matches your agent.\nSMI-4580: snippets are sourced from `@skillsmith/cli/templates/mcp-server.template.snippets`\nso docs and scaffolded READMEs can't drift.\n\n{{clientSnippets}}\n\n## Available Tools\n\n{{toolDocs}}\n\n## Development\n\n```bash\n# Install dependencies\nnpm install\n\n# Run in development mode\nnpm run dev\n\n# Build for production\nnpm run build\n\n# Run production build\nnpm start\n```\n\n## License\n\nMIT\n";
 /**
  * .gitignore template for MCP server
  */

package/dist/src/templates/mcp-server.template.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-server.template.d.ts","sourceRoot":"","sources":["../../../src/templates/mcp-server.template.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AAGH,YAAY,EACV,qBAAqB,EACrB,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,yBAAyB,CAAA;AAGhC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAA;AAgBpE;;GAEG;AACH,eAAO,MAAM,qBAAqB,QAoCjC,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,sBAAsB,4gBAmBlC,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,iBAAiB,0YAmB7B,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB,wnDAoE9B,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,uBAAuB,0iBA6BnC,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,wBAAwB,wsBA+BpC,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB,2nBAsD/B,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,sBAAsB,oPA2BlC,CAAA;AAMD;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,qBAAqB,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAoFzF"}
+{"version":3,"file":"mcp-server.template.d.ts","sourceRoot":"","sources":["../../../src/templates/mcp-server.template.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AAGH,YAAY,EACV,qBAAqB,EACrB,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,yBAAyB,CAAA;AAGhC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAA;AAgBpE;;GAEG;AACH,eAAO,MAAM,qBAAqB,QAoCjC,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,sBAAsB,4gBAmBlC,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,iBAAiB,0YAmB7B,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB,wnDAoE9B,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,uBAAuB,0iBA6BnC,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,wBAAwB,wsBA+BpC,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB,4pBA+C/B,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,sBAAsB,oPA2BlC,CAAA;AASD;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,qBAAqB,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAyFzF"}

package/dist/src/templates/mcp-server.template.js

@@ -294,18 +294,11 @@ npx {{name}}
 
 ## Configuration
 
-Add to your Claude configuration (\`~/.claude/settings.json\`):
-
-\`\`\`json
-{
-  "mcpServers": {
-    "{{name}}": {
-      "command": "npx",
-      "args": ["-y", "{{name}}"]
-    }
-  }
-}
-\`\`\`
+This server is MCP-compatible — pick the snippet that matches your agent.
+SMI-4580: snippets are sourced from \`@skillsmith/cli/templates/mcp-server.template.snippets\`
+so docs and scaffolded READMEs can't drift.
+
+{{clientSnippets}}
 
 ## Available Tools
 
@@ -362,6 +355,8 @@ npm-debug.log*
 # Test coverage
 coverage/
 `;
+// SMI-4580: per-client config snippet matrix
+import { renderAllSnippetsAsMarkdown } from './mcp-server.template.snippets.js';
 // ============================================================================
 // Main Render Function
 // ============================================================================
@@ -420,9 +415,14 @@ export function renderMcpServerTemplates(data) {
         files.set('src/tools/example.ts', EXAMPLE_TOOL_TS_TEMPLATE);
     }
     // README.md
+    // SMI-4580: interpolate per-client snippets so the scaffolded README
+    // covers every supported agent (Claude Code, Cursor, Copilot,
+    // Windsurf, Codex, cross-agent) — same source as the website docs.
+    const clientSnippets = renderAllSnippetsAsMarkdown(data.name);
     files.set('README.md', MCP_README_TEMPLATE.replace(/\{\{name\}\}/g, data.name)
         .replace(/\{\{description\}\}/g, data.description)
-        .replace(/\{\{toolDocs\}\}/g, toolDocs));
+        .replace(/\{\{toolDocs\}\}/g, toolDocs)
+        .replace(/\{\{clientSnippets\}\}/g, clientSnippets));
     // .gitignore
     files.set('.gitignore', MCP_GITIGNORE_TEMPLATE);
     return files;

package/dist/src/templates/mcp-server.template.js.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-server.template.js","sourceRoot":"","sources":["../../../src/templates/mcp-server.template.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"mcp-server.template.js","sourceRoot":"","sources":["../../../src/templates/mcp-server.template.ts"],"names":[],"mappings":"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"}

package/dist/src/templates/mcp-server.template.snippets.d.ts

@@ -0,0 +1,51 @@
+/**
+ * SMI-4580: Per-client MCP config snippets.
+ *
+ * Single source of truth for the install-time configuration block each
+ * agent expects. Same source feeds:
+ *   - the scaffolded mcp-server README (via mcp-server.template.ts)
+ *   - the website docs (`getting-started.astro`, `quickstart.astro`)
+ *   - the root README + packages/mcp-server/README.md
+ *
+ * Four of five clients accept the same `mcpServers` JSON shape.
+ * Codex needs TOML (separate `[mcp_servers.<name>]` table).
+ *
+ * @module @skillsmith/cli/templates/mcp-server.template.snippets
+ */
+import type { ClientId } from '@skillsmith/core/install';
+export type SnippetClientId = ClientId | 'codex';
+export interface ClientSnippet {
+    /** Display label for the per-client tab/section header */
+    label: string;
+    /** Path to the config file the user edits */
+    configPath: string;
+    /** File format hint for the syntax highlighter */
+    format: 'json' | 'toml';
+    /** Snippet body — interpolated with `{{name}}` for the package name */
+    body: string;
+    /** Notes shown beneath the snippet */
+    notes?: string;
+}
+/**
+ * Per-client snippet matrix. `name` placeholder is interpolated when the
+ * snippet is rendered; pass `'@skillsmith/mcp-server'` for the published
+ * package, or any other server name when scaffolding via the template.
+ */
+export declare const CLIENT_SNIPPETS: Record<SnippetClientId, ClientSnippet>;
+/**
+ * Render a single client snippet with the package name interpolated.
+ */
+export declare function renderSnippet(client: SnippetClientId, packageName: string): string;
+/**
+ * Render every snippet as a markdown section sequence — labelled with
+ * `<details>` + `<summary>` so the docs surface stays compact when no
+ * dedicated tabs component is available. Used by both the website
+ * markdown surfaces and the scaffolded mcp-server README.
+ */
+export declare function renderAllSnippetsAsMarkdown(packageName: string): string;
+/**
+ * Snippet IDs in display order. Use when a docs surface needs to
+ * render snippets without a `<details>` accordion (e.g. printable PDF).
+ */
+export declare const SNIPPET_DISPLAY_ORDER: ReadonlyArray<SnippetClientId>;
+//# sourceMappingURL=mcp-server.template.snippets.d.ts.map

package/dist/src/templates/mcp-server.template.snippets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-server.template.snippets.d.ts","sourceRoot":"","sources":["../../../src/templates/mcp-server.template.snippets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AAExD,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,OAAO,CAAA;AAEhD,MAAM,WAAW,aAAa;IAC5B,0DAA0D;IAC1D,KAAK,EAAE,MAAM,CAAA;IACb,6CAA6C;IAC7C,UAAU,EAAE,MAAM,CAAA;IAClB,kDAAkD;IAClD,MAAM,EAAE,MAAM,GAAG,MAAM,CAAA;IACvB,uEAAuE;IACvE,IAAI,EAAE,MAAM,CAAA;IACZ,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;;;GAIG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,eAAe,EAAE,aAAa,CAsGlE,CAAA;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAGlF;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAiBvE;AAED;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAE,aAAa,CAAC,eAAe,CAO/D,CAAA"}

package/dist/src/templates/mcp-server.template.snippets.js

@@ -0,0 +1,162 @@
+/**
+ * SMI-4580: Per-client MCP config snippets.
+ *
+ * Single source of truth for the install-time configuration block each
+ * agent expects. Same source feeds:
+ *   - the scaffolded mcp-server README (via mcp-server.template.ts)
+ *   - the website docs (`getting-started.astro`, `quickstart.astro`)
+ *   - the root README + packages/mcp-server/README.md
+ *
+ * Four of five clients accept the same `mcpServers` JSON shape.
+ * Codex needs TOML (separate `[mcp_servers.<name>]` table).
+ *
+ * @module @skillsmith/cli/templates/mcp-server.template.snippets
+ */
+/**
+ * Per-client snippet matrix. `name` placeholder is interpolated when the
+ * snippet is rendered; pass `'@skillsmith/mcp-server'` for the published
+ * package, or any other server name when scaffolding via the template.
+ */
+export const CLIENT_SNIPPETS = {
+    'claude-code': {
+        label: 'Claude Code',
+        configPath: '~/.claude/settings.json',
+        format: 'json',
+        body: `{
+  "mcpServers": {
+    "{{name}}": {
+      "command": "npx",
+      "args": ["-y", "{{name}}"],
+      "env": {
+        "SKILLSMITH_API_KEY": "sk_live_..."
+      }
+    }
+  }
+}`,
+        notes: 'Restart Claude Code after editing settings.json.',
+    },
+    cursor: {
+        label: 'Cursor',
+        configPath: '~/.cursor/mcp.json',
+        format: 'json',
+        body: `{
+  "mcpServers": {
+    "{{name}}": {
+      "command": "npx",
+      "args": ["-y", "{{name}}"],
+      "env": {
+        "SKILLSMITH_API_KEY": "sk_live_..."
+      }
+    }
+  }
+}`,
+        notes: 'Cursor 2.4+ required. Reload the window after saving.',
+    },
+    copilot: {
+        label: 'GitHub Copilot (VS Code)',
+        configPath: '.vscode/mcp.json (workspace)',
+        format: 'json',
+        body: `{
+  "mcpServers": {
+    "{{name}}": {
+      "command": "npx",
+      "args": ["-y", "{{name}}"],
+      "env": {
+        "SKILLSMITH_API_KEY": "sk_live_..."
+      }
+    }
+  }
+}`,
+        notes: 'VS Code 1.108+ required. Workspace-scoped config (commit to repo if team-shared, or use user settings.json instead).',
+    },
+    windsurf: {
+        label: 'Windsurf',
+        configPath: '~/.codeium/windsurf/mcp_config.json',
+        format: 'json',
+        body: `{
+  "mcpServers": {
+    "{{name}}": {
+      "command": "npx",
+      "args": ["-y", "{{name}}"],
+      "env": {
+        "SKILLSMITH_API_KEY": "\${env:SKILLSMITH_API_KEY}"
+      }
+    }
+  }
+}`,
+        notes: 'Supports `${env:VAR}` interpolation; export SKILLSMITH_API_KEY in your shell instead of inlining the secret.',
+    },
+    agents: {
+        label: 'Cross-agent (open standard)',
+        configPath: '~/.agents/mcp.json',
+        format: 'json',
+        body: `{
+  "mcpServers": {
+    "{{name}}": {
+      "command": "npx",
+      "args": ["-y", "{{name}}"],
+      "env": {
+        "SKILLSMITH_API_KEY": "sk_live_..."
+      }
+    }
+  }
+}`,
+        notes: 'Read by any agent honouring the cross-agent skill convention. Codex CLI users prefer the Codex-native TOML snippet below.',
+    },
+    codex: {
+        label: 'Codex CLI',
+        configPath: '~/.codex/config.toml',
+        format: 'toml',
+        body: `[mcp_servers.{{name}}]
+command = "npx"
+args = ["-y", "{{name}}"]
+
+[mcp_servers.{{name}}.env]
+SKILLSMITH_API_KEY = "sk_live_..."`,
+        notes: 'Codex uses TOML, not JSON. Skill discovery still reads ~/.agents/skills (set --client agents when installing via Skillsmith CLI).',
+    },
+};
+/**
+ * Render a single client snippet with the package name interpolated.
+ */
+export function renderSnippet(client, packageName) {
+    const snippet = CLIENT_SNIPPETS[client];
+    return snippet.body.replace(/\{\{name\}\}/g, packageName);
+}
+/**
+ * Render every snippet as a markdown section sequence — labelled with
+ * `<details>` + `<summary>` so the docs surface stays compact when no
+ * dedicated tabs component is available. Used by both the website
+ * markdown surfaces and the scaffolded mcp-server README.
+ */
+export function renderAllSnippetsAsMarkdown(packageName) {
+    const sections = Object.keys(CLIENT_SNIPPETS).map((id) => {
+        const snippet = CLIENT_SNIPPETS[id];
+        const body = renderSnippet(id, packageName);
+        const notes = snippet.notes ? `\n\n${snippet.notes}` : '';
+        return [
+            `<details>`,
+            `<summary><strong>${snippet.label}</strong> — \`${snippet.configPath}\`</summary>`,
+            ``,
+            `\`\`\`${snippet.format}`,
+            body,
+            `\`\`\`${notes}`,
+            ``,
+            `</details>`,
+        ].join('\n');
+    });
+    return sections.join('\n\n');
+}
+/**
+ * Snippet IDs in display order. Use when a docs surface needs to
+ * render snippets without a `<details>` accordion (e.g. printable PDF).
+ */
+export const SNIPPET_DISPLAY_ORDER = Object.freeze([
+    'claude-code',
+    'cursor',
+    'copilot',
+    'windsurf',
+    'codex',
+    'agents',
+]);
+//# sourceMappingURL=mcp-server.template.snippets.js.map

package/dist/src/templates/mcp-server.template.snippets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-server.template.snippets.js","sourceRoot":"","sources":["../../../src/templates/mcp-server.template.snippets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAmBH;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAA2C;IACrE,aAAa,EAAE;QACb,KAAK,EAAE,aAAa;QACpB,UAAU,EAAE,yBAAyB;QACrC,MAAM,EAAE,MAAM;QACd,IAAI,EAAE;;;;;;;;;;EAUR;QACE,KAAK,EAAE,kDAAkD;KAC1D;IACD,MAAM,EAAE;QACN,KAAK,EAAE,QAAQ;QACf,UAAU,EAAE,oBAAoB;QAChC,MAAM,EAAE,MAAM;QACd,IAAI,EAAE;;;;;;;;;;EAUR;QACE,KAAK,EAAE,uDAAuD;KAC/D;IACD,OAAO,EAAE;QACP,KAAK,EAAE,0BAA0B;QACjC,UAAU,EAAE,8BAA8B;QAC1C,MAAM,EAAE,MAAM;QACd,IAAI,EAAE;;;;;;;;;;EAUR;QACE,KAAK,EACH,sHAAsH;KACzH;IACD,QAAQ,EAAE;QACR,KAAK,EAAE,UAAU;QACjB,UAAU,EAAE,qCAAqC;QACjD,MAAM,EAAE,MAAM;QACd,IAAI,EAAE;;;;;;;;;;EAUR;QACE,KAAK,EACH,8GAA8G;KACjH;IACD,MAAM,EAAE;QACN,KAAK,EAAE,6BAA6B;QACpC,UAAU,EAAE,oBAAoB;QAChC,MAAM,EAAE,MAAM;QACd,IAAI,EAAE;;;;;;;;;;EAUR;QACE,KAAK,EACH,2HAA2H;KAC9H;IACD,KAAK,EAAE;QACL,KAAK,EAAE,WAAW;QAClB,UAAU,EAAE,sBAAsB;QAClC,MAAM,EAAE,MAAM;QACd,IAAI,EAAE;;;;;mCAKyB;QAC/B,KAAK,EACH,mIAAmI;KACtI;CACF,CAAA;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,MAAuB,EAAE,WAAmB;IACxE,MAAM,OAAO,GAAG,eAAe,CAAC,MAAM,CAAC,CAAA;IACvC,OAAO,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,eAAe,EAAE,WAAW,CAAC,CAAA;AAC3D,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,2BAA2B,CAAC,WAAmB;IAC7D,MAAM,QAAQ,GAAI,MAAM,CAAC,IAAI,CAAC,eAAe,CAAuB,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE;QAC9E,MAAM,OAAO,GAAG,eAAe,CAAC,EAAE,CAAC,CAAA;QACnC,MAAM,IAAI,GAAG,aAAa,CAAC,EAAE,EAAE,WAAW,CAAC,CAAA;QAC3C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;QACzD,OAAO;YACL,WAAW;YACX,oBAAoB,OAAO,CAAC,KAAK,iBAAiB,OAAO,CAAC,UAAU,cAAc;YAClF,EAAE;YACF,SAAS,OAAO,CAAC,MAAM,EAAE;YACzB,IAAI;YACJ,SAAS,KAAK,EAAE;YAChB,EAAE;YACF,YAAY;SACb,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACd,CAAC,CAAC,CAAA;IACF,OAAO,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;AAC9B,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAmC,MAAM,CAAC,MAAM,CAAC;IACjF,aAAa;IACb,QAAQ;IACR,SAAS;IACT,UAAU;IACV,OAAO;IACP,QAAQ;CACT,CAAC,CAAA"}

package/dist/src/templates/readme.md.template.d.ts

@@ -3,6 +3,6 @@
  *
  * Template for new skill README files.
  */
-export declare const README_MD_TEMPLATE = "# {{name}}\n\n{{description}}\n\n## Overview\n\nThis is a Claude Code skill that provides [describe functionality].\n\n## Installation\n\n### Via Skillsmith\n\n```bash\nskillsmith install {{author}}/{{name}}\n```\n\n### Manual Installation\n\n1. Clone or download this repository\n2. Copy to your skills directory:\n\n```bash\ncp -r {{name}} ~/.claude/skills/\n```\n\n## Quick Start\n\n1. Install the skill\n2. Start Claude Code\n3. Use the skill by [describe how to trigger]\n\n## Documentation\n\nSee [SKILL.md](./SKILL.md) for detailed documentation.\n\n## Development\n\n### Prerequisites\n\n- Node.js 18+\n- npm or pnpm\n\n### Setup\n\n```bash\n# Install dependencies (if any)\nnpm install\n\n# Run tests\nnpm test\n```\n\n### Project Structure\n\n```\n{{name}}/\n\u251C\u2500\u2500 SKILL.md          # Skill definition and documentation\n\u251C\u2500\u2500 README.md         # This file\n\u251C\u2500\u2500 scripts/          # Automation scripts\n\u2502   \u2514\u2500\u2500 example.js    # Example script\n\u251C\u2500\u2500 resources/        # Static resources\n\u2514\u2500\u2500 .gitignore        # Git ignore rules\n```\n\n## Contributing\n\n1. Fork the repository\n2. Create a feature branch\n3. Make your changes\n4. Submit a pull request\n\n## License\n\nMIT License\n\n## Author\n\nCreated with [Skillsmith](https://github.com/skillsmith/skillsmith)\n";
+export declare const README_MD_TEMPLATE = "# {{name}}\n\n{{description}}\n\n## Overview\n\nThis is an agent skill (SKILL.md format, MCP-compatible) that provides [describe functionality].\n\n## Installation\n\n### Via Skillsmith\n\n```bash\nskillsmith install {{author}}/{{name}}\n```\n\n### Manual Installation\n\n1. Clone or download this repository\n2. Copy to your skills directory:\n\n```bash\ncp -r {{name}} ~/.claude/skills/\n```\n\n## Quick Start\n\n1. Install the skill\n2. Start your MCP-compatible agent (Claude Code, Cursor, Copilot, Codex, Windsurf, etc.)\n3. Use the skill by [describe how to trigger]\n\n## Documentation\n\nSee [SKILL.md](./SKILL.md) for detailed documentation.\n\n## Development\n\n### Prerequisites\n\n- Node.js 18+\n- npm or pnpm\n\n### Setup\n\n```bash\n# Install dependencies (if any)\nnpm install\n\n# Run tests\nnpm test\n```\n\n### Project Structure\n\n```\n{{name}}/\n\u251C\u2500\u2500 SKILL.md          # Skill definition and documentation\n\u251C\u2500\u2500 README.md         # This file\n\u251C\u2500\u2500 scripts/          # Automation scripts\n\u2502   \u2514\u2500\u2500 example.js    # Example script\n\u251C\u2500\u2500 resources/        # Static resources\n\u2514\u2500\u2500 .gitignore        # Git ignore rules\n```\n\n## Contributing\n\n1. Fork the repository\n2. Create a feature branch\n3. Make your changes\n4. Submit a pull request\n\n## License\n\nMIT License\n\n## Author\n\nCreated with [Skillsmith](https://github.com/skillsmith/skillsmith)\n";
 export default README_MD_TEMPLATE;
 //# sourceMappingURL=readme.md.template.d.ts.map

package/dist/src/templates/readme.md.template.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"readme.md.template.d.ts","sourceRoot":"","sources":["../../../src/templates/readme.md.template.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAO,MAAM,kBAAkB,21CA8E9B,CAAA;AAED,eAAe,kBAAkB,CAAA"}
+{"version":3,"file":"readme.md.template.d.ts","sourceRoot":"","sources":["../../../src/templates/readme.md.template.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAO,MAAM,kBAAkB,47CA8E9B,CAAA;AAED,eAAe,kBAAkB,CAAA"}

package/dist/src/templates/readme.md.template.js

@@ -9,7 +9,7 @@ export const README_MD_TEMPLATE = `# {{name}}
 
 ## Overview
 
-This is a Claude Code skill that provides [describe functionality].
+This is an agent skill (SKILL.md format, MCP-compatible) that provides [describe functionality].
 
 ## Installation
 
@@ -31,7 +31,7 @@ cp -r {{name}} ~/.claude/skills/
 ## Quick Start
 
 1. Install the skill
-2. Start Claude Code
+2. Start your MCP-compatible agent (Claude Code, Cursor, Copilot, Codex, Windsurf, etc.)
 3. Use the skill by [describe how to trigger]
 
 ## Documentation

package/dist/src/utils/skills-directory.d.ts

@@ -3,6 +3,7 @@
  * from the global and local ~/.claude/skills directories.
  */
 import { type TrustTier } from '@skillsmith/core';
+import { type ClientId } from '@skillsmith/core/install';
 export interface InstalledSkill {
     name: string;
     path: string;
@@ -10,6 +11,12 @@ export interface InstalledSkill {
     trustTier: TrustTier;
     installDate: string;
     hasUpdates: boolean;
+    /**
+     * SMI-4578: which client's directory this skill was discovered under.
+     * `'local'` = repo-local `./.claude/skills`. Other values are
+     * `ClientId` from the multi-client install table.
+     */
+    installedVia: ClientId | 'local';
 }
 /**
  * Get skills from a specific directory.
@@ -18,17 +25,29 @@ export interface InstalledSkill {
  * whether a newer content hash has been recorded since the skill was installed.
  * Falls back to hasUpdates: false when the database is unavailable.
  *
- * @param skillsDir Directory to scan for installed skills
- * @param dbPath    Optional path to the Skillsmith SQLite database
+ * @param skillsDir   Directory to scan for installed skills
+ * @param dbPath      Optional path to the Skillsmith SQLite database
+ * @param installedVia SMI-4578: which client (or `'local'`) this directory
+ *                    represents — propagated onto each returned skill so
+ *                    callers can render "installed via Cursor" badges.
  */
-export declare function getSkillsFromDirectory(skillsDir: string, dbPath?: string): Promise<InstalledSkill[]>;
+export declare function getSkillsFromDirectory(skillsDir: string, dbPath?: string, installedVia?: ClientId | 'local'): Promise<InstalledSkill[]>;
 /**
- * Get list of installed skills from both global (~/.claude/skills) and
- * local (.claude/skills) directories.
+ * Get list of installed skills across every client directory.
  *
- * SMI-1630: Local skills take precedence over global skills with the same name.
+ * SMI-4578: scans the union of `CLIENT_NATIVE_PATHS` (claude-code,
+ * cursor, copilot, windsurf, agents) plus repo-local
+ * `./.claude/skills`. Results are deduplicated by `realpath` so a
+ * symlinked `~/.agents/skills/foo` pointing at `~/.claude/skills/foo`
+ * is reported once. Each entry carries `installedVia` so the caller
+ * can render "installed via Cursor" badges.
  *
- * @param dbPath Optional path to the Skillsmith SQLite database for update detection
+ * Precedence (first wins after dedup): local (repo) > claude-code >
+ * cursor > copilot > windsurf > agents. This keeps the SMI-1630
+ * promise that repo-local overrides global.
+ *
+ * @param dbPath Optional path to the Skillsmith SQLite database for
+ *               update detection.
  */
 export declare function getInstalledSkills(dbPath?: string): Promise<InstalledSkill[]>;
 //# sourceMappingURL=skills-directory.d.ts.map

package/dist/src/utils/skills-directory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skills-directory.d.ts","sourceRoot":"","sources":["../../../src/utils/skills-directory.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,EAML,KAAK,SAAS,EACf,MAAM,kBAAkB,CAAA;AAGzB,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,SAAS,EAAE,SAAS,CAAA;IACpB,WAAW,EAAE,MAAM,CAAA;IACnB,UAAU,EAAE,OAAO,CAAA;CACpB;AAoBD;;;;;;;;;GASG;AACH,wBAAsB,sBAAsB,CAC1C,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,cAAc,EAAE,CAAC,CAiG3B;AAED;;;;;;;GAOG;AACH,wBAAsB,kBAAkB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAsBnF"}
+{"version":3,"file":"skills-directory.d.ts","sourceRoot":"","sources":["../../../src/utils/skills-directory.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,EAML,KAAK,SAAS,EACf,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAIL,KAAK,QAAQ,EACd,MAAM,0BAA0B,CAAA;AAGjC,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,SAAS,EAAE,SAAS,CAAA;IACpB,WAAW,EAAE,MAAM,CAAA;IACnB,UAAU,EAAE,OAAO,CAAA;IACnB;;;;OAIG;IACH,YAAY,EAAE,QAAQ,GAAG,OAAO,CAAA;CACjC;AAiBD;;;;;;;;;;;;GAYG;AACH,wBAAsB,sBAAsB,CAC1C,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,MAAM,EACf,YAAY,GAAE,QAAQ,GAAG,OAA0B,GAClD,OAAO,CAAC,cAAc,EAAE,CAAC,CAmG3B;AAgBD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,kBAAkB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAwCnF"}

package/dist/src/utils/skills-directory.js

@@ -2,21 +2,18 @@
  * SMI-2713: Extracted from manage.ts — helpers for reading installed skills
  * from the global and local ~/.claude/skills directories.
  */
-import { readdir, readFile, stat } from 'fs/promises';
+import { readdir, readFile, realpath, stat } from 'fs/promises';
 import { createHash } from 'crypto';
 import { join } from 'path';
-import { homedir } from 'os';
 import { SkillParser, createDatabaseAsync, initializeSchema, SkillVersionRepository, } from '@skillsmith/core';
+import { CANONICAL_CLIENT, CLIENT_IDS, CLIENT_NATIVE_PATHS, } from '@skillsmith/core/install';
 import { DEFAULT_DB_PATH } from '../config.js';
 /**
- * SMI-1630: Search both global and local skill directories
- *
- * Global: ~/.claude/skills/
- * Local: ${process.cwd()}/.claude/skills/
- *
- * Local skills take precedence over global skills with the same name.
+ * SMI-1630 + SMI-4578: discovery scans every client directory
+ * (`CLIENT_NATIVE_PATHS`) plus repo-local `./.claude/skills`. Local
+ * skills take precedence over global; canonical (`claude-code`) takes
+ * precedence over secondary clients. See `getInstalledSkills` below.
  */
-const GLOBAL_SKILLS_DIR = join(homedir(), '.claude', 'skills');
 /**
  * Returns the local skills directory path.
  * Computed at call time to handle working directory changes.
@@ -31,10 +28,13 @@ function getLocalSkillsDir() {
  * whether a newer content hash has been recorded since the skill was installed.
  * Falls back to hasUpdates: false when the database is unavailable.
  *
- * @param skillsDir Directory to scan for installed skills
- * @param dbPath    Optional path to the Skillsmith SQLite database
+ * @param skillsDir   Directory to scan for installed skills
+ * @param dbPath      Optional path to the Skillsmith SQLite database
+ * @param installedVia SMI-4578: which client (or `'local'`) this directory
+ *                    represents — propagated onto each returned skill so
+ *                    callers can render "installed via Cursor" badges.
  */
-export async function getSkillsFromDirectory(skillsDir, dbPath) {
+export async function getSkillsFromDirectory(skillsDir, dbPath, installedVia = CANONICAL_CLIENT) {
     const skills = [];
     // Open the version repository if a db path was provided
     let versionRepo = null;
@@ -95,6 +95,7 @@ export async function getSkillsFromDirectory(skillsDir, dbPath) {
                         trustTier: parsed ? parser.inferTrustTier(parsed) : 'unknown',
                         installDate: skillMdStat.mtime.toISOString().split('T')[0] || 'Unknown',
                         hasUpdates,
+                        installedVia,
                     });
                 }
                 catch (error) {
@@ -113,6 +114,7 @@ export async function getSkillsFromDirectory(skillsDir, dbPath) {
                         trustTier: 'unknown',
                         installDate: dirStat.mtime.toISOString().split('T')[0] || 'Unknown',
                         hasUpdates: false,
+                        installedVia,
                     });
                 }
             }
@@ -129,30 +131,73 @@ export async function getSkillsFromDirectory(skillsDir, dbPath) {
     return skills;
 }
 /**
- * Get list of installed skills from both global (~/.claude/skills) and
- * local (.claude/skills) directories.
+ * Resolve a path through `realpath` defensively. Returns the resolved
+ * path on success, or the input path unchanged if the path is missing
+ * or unreadable — dedup keying still works either way (we just won't
+ * collapse symlinked aliases when the link is broken).
+ */
+async function safeRealpath(p) {
+    try {
+        return await realpath(p);
+    }
+    catch {
+        return p;
+    }
+}
+/**
+ * Get list of installed skills across every client directory.
  *
- * SMI-1630: Local skills take precedence over global skills with the same name.
+ * SMI-4578: scans the union of `CLIENT_NATIVE_PATHS` (claude-code,
+ * cursor, copilot, windsurf, agents) plus repo-local
+ * `./.claude/skills`. Results are deduplicated by `realpath` so a
+ * symlinked `~/.agents/skills/foo` pointing at `~/.claude/skills/foo`
+ * is reported once. Each entry carries `installedVia` so the caller
+ * can render "installed via Cursor" badges.
  *
- * @param dbPath Optional path to the Skillsmith SQLite database for update detection
+ * Precedence (first wins after dedup): local (repo) > claude-code >
+ * cursor > copilot > windsurf > agents. This keeps the SMI-1630
+ * promise that repo-local overrides global.
+ *
+ * @param dbPath Optional path to the Skillsmith SQLite database for
+ *               update detection.
  */
 export async function getInstalledSkills(dbPath) {
     const resolvedDbPath = dbPath ?? DEFAULT_DB_PATH;
-    // Get skills from both directories
-    const [globalSkills, localSkills] = await Promise.all([
-        getSkillsFromDirectory(GLOBAL_SKILLS_DIR, resolvedDbPath),
-        getSkillsFromDirectory(getLocalSkillsDir(), resolvedDbPath),
-    ]);
-    // Create a map for deduplication, local skills take precedence
-    const skillMap = new Map();
-    // Add global skills first
-    for (const skill of globalSkills) {
-        skillMap.set(skill.name, skill);
+    const localScan = getSkillsFromDirectory(getLocalSkillsDir(), resolvedDbPath, 'local');
+    const clientScans = CLIENT_IDS.map((client) => getSkillsFromDirectory(CLIENT_NATIVE_PATHS[client], resolvedDbPath, client));
+    const [localSkills, ...clientSkillsLists] = await Promise.all([localScan, ...clientScans]);
+    // Precedence order: local first, then canonical, then the rest.
+    const ordered = [...localSkills];
+    const canonicalIdx = CLIENT_IDS.indexOf(CANONICAL_CLIENT);
+    if (canonicalIdx >= 0 && clientSkillsLists[canonicalIdx]) {
+        ordered.push(...clientSkillsLists[canonicalIdx]);
+    }
+    for (let i = 0; i < CLIENT_IDS.length; i++) {
+        if (i === canonicalIdx)
+            continue;
+        const list = clientSkillsLists[i];
+        if (list)
+            ordered.push(...list);
     }
-    // Add local skills (overwrites global skills with same name)
-    for (const skill of localSkills) {
-        skillMap.set(skill.name, skill);
+    // Dedup by both skill name AND resolved path. Name-keying enforces the
+    // precedence rule (local > canonical > others) when two clients carry
+    // independently-installed copies of the same skill. Realpath-keying
+    // collapses symlinked aliases (e.g. `~/.agents/skills` → `~/.claude/skills`)
+    // so the symlinked entry doesn't appear twice when the second hop has a
+    // different `installedVia` label.
+    const seenNames = new Set();
+    const seenPaths = new Set();
+    const out = [];
+    for (const skill of ordered) {
+        if (seenNames.has(skill.name))
+            continue;
+        const realPath = await safeRealpath(skill.path);
+        if (seenPaths.has(realPath))
+            continue;
+        seenNames.add(skill.name);
+        seenPaths.add(realPath);
+        out.push(skill);
     }
-    return Array.from(skillMap.values());
+    return out;
 }
 //# sourceMappingURL=skills-directory.js.map

package/dist/src/utils/skills-directory.js.map

@@ -1 +1 @@
-{"version":3,"file":"skills-directory.js","sourceRoot":"","sources":["../../../src/utils/skills-directory.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"skills-directory.js","sourceRoot":"","sources":["../../../src/utils/skills-directory.ts"],"names":[],"mappings":"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"}

package/dist/tests/audit-collisions.test.d.ts

@@ -0,0 +1,42 @@
+/**
+ * @fileoverview SMI-4590 Wave 4 PR 5/6 — `sklx audit collisions` tests
+ * @module @skillsmith/cli/tests/audit-collisions
+ *
+ * Coverage:
+ *
+ * Typed-confirmation gate (`requireConfirmationPhrase`) — load-bearing per
+ * plan §235-239. Strict literal equality, NO normalization.
+ *   1. Exact phrase   ('APPLY ALL')              — RESOLVES.
+ *   2. Single-letter  ('Y')                      — REJECTS.
+ *   3. Lowercase word ('yes')                    — REJECTS.
+ *   4. Lowercase phrase ('apply all')            — REJECTS.
+ *   5. No-space variant ('APPLYALL')             — REJECTS.
+ *   6. Trailing whitespace ('APPLY ALL ')        — REJECTS (no trim).
+ *   7. Empty string                              — REJECTS.
+ *
+ * Both interactive (TTY) and piped-stdin paths route through the same
+ * `@inquirer/prompts` `input()` call, so the rejection invariant holds for
+ * both. We mock `input` to assert the contract — the prompt library
+ * receives the answer verbatim and our code applies strict equality.
+ *
+ * Interactive prompt loop (`runInteractiveLoop`):
+ *   8.  'apply' choice  → applyOneSuggestion called, status=applied.
+ *   9.  'skip'  choice  → outcome recorded as skipped, no apply call.
+ *   10. 'edit'  choice  → input prompts for custom name, applyRename
+ *                          receives `customName`.
+ *   11. 'quit'  choice  → loop terminates early; remaining suggestions
+ *                          are NOT processed.
+ *   12. Empty suggestion list → prints "No collisions found." and returns.
+ *
+ * Reset-ledger flow (`runResetLedger`):
+ *   13. Backs up an existing ledger to `~/.skillsmith/backups/ledger-*.json`
+ *       BEFORE clearing.
+ *   14. No backup file when no prior ledger exists.
+ *   15. Confirmation phrase mismatch → throws, NO writeLedger call.
+ *
+ * `--json` output (`runAuditCollisions`):
+ *   16. JSON mode prints `RunInventoryAuditResult` to stdout, no prompts,
+ *       no apply.
+ */
+export {};
+//# sourceMappingURL=audit-collisions.test.d.ts.map

package/dist/tests/audit-collisions.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-collisions.test.d.ts","sourceRoot":"","sources":["../../tests/audit-collisions.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG"}