@pratikpsl/agent-skills 0.4.0 → 0.5.0

package/README.md

@@ -13,20 +13,28 @@ To setup agent skills in any target project, run:
 ```bash
 # In any .NET project root:
 npx @pratikpsl/agent-skills dotnet-setup
+
+# Install shared skills + one IDE entry-point only
+npx @pratikpsl/agent-skills dotnet-setup cursor      # → .cursor/rules/instructions.md
+npx @pratikpsl/agent-skills dotnet-setup claude       # → CLAUDE.md
+npx @pratikpsl/agent-skills dotnet-setup codex        # → AGENTS.md
+npx @pratikpsl/agent-skills dotnet-setup copilot      # → .github/copilot-instructions.md
+npx @pratikpsl/agent-skills dotnet-setup antigravity  # → .agents/GEMINI.md
 ```
 
 ### Other Commands
 
-| Command | Description |
-|---------|-------------|
-| `npx @pratikpsl/agent-skills init` | Scaffold an empty `AgentSkills/` folder and `index.json` |
-| `npx @pratikpsl/agent-skills list dotnet` | List available skills inside the dotnet pack |
-| `npx @pratikpsl/agent-skills add dotnet <skill>` | Copy a single skill into your project |
-| `npx @pratikpsl/agent-skills add dotnet --all` | Copy all skills (alternative to `dotnet-setup`) |
-| `npx @pratikpsl/agent-skills --help` | Show CLI help |
-| `npx @pratikpsl/agent-skills --version` | Show CLI version |
+| Command                                          | Description                                              |
+| ------------------------------------------------ | -------------------------------------------------------- |
+| `npx @pratikpsl/agent-skills init`               | Scaffold an empty `AgentSkills/` folder and `index.json` |
+| `npx @pratikpsl/agent-skills list dotnet`        | List available skills inside the dotnet pack             |
+| `npx @pratikpsl/agent-skills add dotnet <skill>` | Copy a single skill into your project                    |
+| `npx @pratikpsl/agent-skills add dotnet --all`   | Copy all skills (alternative to `dotnet-setup`)          |
+| `npx @pratikpsl/agent-skills --help`             | Show CLI help                                            |
+| `npx @pratikpsl/agent-skills --version`          | Show CLI version                                         |
 
 ### Options
+
 - `--force`: Overwrite existing skill and entry point files.
 - `--path <dir>`: Target project root (defaults to `process.cwd()`).
 

package/dist/bin/agent-skills.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import "../cli/index.js";
+//# sourceMappingURL=agent-skills.d.ts.map

package/dist/bin/agent-skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-skills.d.ts","sourceRoot":"","sources":["../../src/bin/agent-skills.ts"],"names":[],"mappings":";AAKA,OAAO,iBAAiB,CAAC"}

package/dist/bin/agent-skills.js

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+// src/bin/agent-skills.ts
+// Thin entrypoint for the `agent-skills` CLI.
+// Delegates immediately to cli/index.ts which wires up commander.
+import "../cli/index.js";
+//# sourceMappingURL=agent-skills.js.map

package/dist/bin/agent-skills.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-skills.js","sourceRoot":"","sources":["../../src/bin/agent-skills.ts"],"names":[],"mappings":";AACA,0BAA0B;AAC1B,8CAA8C;AAC9C,kEAAkE;AAElE,OAAO,iBAAiB,CAAC"}

package/dist/cli/commands/add.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from "commander";
+export declare function addCommand(program: Command): void;
+//# sourceMappingURL=add.d.ts.map

package/dist/cli/commands/add.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/add.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKzC,wBAAgB,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA8DjD"}

package/dist/cli/commands/add.js

@@ -0,0 +1,71 @@
+// src/cli/commands/add.ts
+// `agent-skills add <pack> <skillName|--all>`
+//
+// Copies a single named skill (or all skills with --all) from a pack into the
+// current project's AgentSkills/ folder.
+//
+// This is the generic command. `dotnet-setup` is a convenience wrapper over this.
+import path from "path";
+import { loadPack } from "../../core/load-pack.js";
+import { copySkills, ensureAgentSkillsDir } from "../../core/copy-skills.js";
+export function addCommand(program) {
+    program
+        .command("add <pack> [skillName]")
+        .description("Copy a skill (or all skills with --all) from a pack into this project")
+        .option("--all", "Copy all skills from the pack", false)
+        .option("--force", "Overwrite existing files", false)
+        .option("--path <dir>", "Target project root (default: cwd)", process.cwd())
+        .action((pack, skillName, options) => {
+        if (!skillName && !options.all) {
+            console.error("✗ Specify a skill name or pass --all to copy every skill.");
+            process.exit(1);
+        }
+        const targetDir = path.resolve(options.path);
+        const { packDir, manifest } = loadPackOrExit(pack);
+        let skillsToCopy;
+        if (options.all) {
+            skillsToCopy = manifest.skills;
+        }
+        else {
+            const found = manifest.skills.find((s) => s.name === skillName);
+            if (!found) {
+                const available = manifest.skills.map((s) => s.name).join(", ");
+                console.error(`✗ Skill "${skillName}" not found in pack "${pack}".`);
+                console.error(`  Available: ${available}`);
+                process.exit(1);
+            }
+            skillsToCopy = [found];
+        }
+        ensureAgentSkillsDir(targetDir);
+        console.log(`\nCopying from ${manifest.name}@${manifest.version} → ${targetDir}\n`);
+        const { written, skipped } = copySkills({
+            skills: skillsToCopy,
+            packDir,
+            targetDir,
+            force: options.force,
+        });
+        printSummary(written, skipped);
+        if (written.length === 0 && skipped.length > 0) {
+            // Everything was skipped — treat as a soft warning, not a hard error.
+            process.exit(0);
+        }
+    });
+}
+function loadPackOrExit(pack) {
+    try {
+        return loadPack(pack);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        console.error(`✗ ${message}`);
+        process.exit(1);
+    }
+}
+function printSummary(written, skipped) {
+    console.log("\n" + "─".repeat(50));
+    console.log(`✔ Done — ${written.length} written, ${skipped.length} skipped.`);
+    if (skipped.length > 0) {
+        console.log("  (Run with --force to overwrite skipped files.)");
+    }
+}
+//# sourceMappingURL=add.js.map

package/dist/cli/commands/add.js.map

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

package/dist/cli/commands/dotnet-setup.d.ts

@@ -0,0 +1,14 @@
+import type { Command } from "commander";
+import type { SkillEntry } from "../../core/manifest.js";
+/**
+ * Filters a skill list for a specific IDE:
+ *  - Keeps all non-entry-point skills (shared AgentSkills content).
+ *  - Keeps only the entry-point skill matching the given IDE.
+ *
+ * Exported for unit testing; contains no I/O.
+ *
+ * @throws When `ide` is not a recognised key in IDE_ENTRY_POINT_MAP.
+ */
+export declare function filterSkillsForIde(skills: SkillEntry[], ide: string): SkillEntry[];
+export declare function dotnetSetupCommand(program: Command): void;
+//# sourceMappingURL=dotnet-setup.d.ts.map

package/dist/cli/commands/dotnet-setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dotnet-setup.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/dotnet-setup.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGzC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAsBzD;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,UAAU,EAAE,EACpB,GAAG,EAAE,MAAM,GACV,UAAU,EAAE,CAYd;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAkEzD"}

package/dist/cli/commands/dotnet-setup.js

@@ -0,0 +1,110 @@
+// src/cli/commands/dotnet-setup.ts
+// `agent-skills dotnet-setup [ide]`
+//
+// Convenience command equivalent to:
+//   agent-skills add @pratikpsl/agent-skills-dotnet --all
+//
+// When an optional [ide] positional argument is supplied (cursor | claude |
+// codex | copilot | antigravity), only that IDE's entry-point file is written
+// together with all shared AgentSkills files. All other entry-point files are
+// skipped.
+//
+// Without [ide], all skills including every entry-point are copied (original
+// behaviour — no breaking change).
+import path from "path";
+import { loadPack } from "../../core/load-pack.js";
+import { copySkills, ensureAgentSkillsDir } from "../../core/copy-skills.js";
+const DOTNET_PACK = "@pratikpsl/agent-skills-dotnet";
+/**
+ * Maps the user-facing IDE name to the manifest skill name for that IDE's
+ * entry-point. Skills whose name starts with `entry-point:` but are NOT in
+ * this map are filtered out when an IDE is specified.
+ */
+const IDE_ENTRY_POINT_MAP = {
+    cursor: "entry-point:cursor",
+    claude: "entry-point:claude",
+    codex: "entry-point:codex",
+    copilot: "entry-point:copilot",
+    antigravity: "entry-point:antigravity",
+};
+const ENTRY_POINT_PREFIX = "entry-point:";
+/** Human-readable list of valid IDE names for error messages. */
+const VALID_IDE_NAMES = Object.keys(IDE_ENTRY_POINT_MAP).join(", ");
+/**
+ * Filters a skill list for a specific IDE:
+ *  - Keeps all non-entry-point skills (shared AgentSkills content).
+ *  - Keeps only the entry-point skill matching the given IDE.
+ *
+ * Exported for unit testing; contains no I/O.
+ *
+ * @throws When `ide` is not a recognised key in IDE_ENTRY_POINT_MAP.
+ */
+export function filterSkillsForIde(skills, ide) {
+    const targetSkillName = IDE_ENTRY_POINT_MAP[ide];
+    if (!targetSkillName) {
+        throw new Error(`Unknown IDE "${ide}". Valid options are: ${VALID_IDE_NAMES}`);
+    }
+    return skills.filter((s) => !s.name.startsWith(ENTRY_POINT_PREFIX) || s.name === targetSkillName);
+}
+export function dotnetSetupCommand(program) {
+    program
+        .command("dotnet-setup")
+        .description(`Install the full .NET/C# agent skill set (shortcut for: add ${DOTNET_PACK} --all).\n` +
+        `  Optionally pass an IDE name to install only that IDE's entry-point:\n` +
+        `  ${VALID_IDE_NAMES}`)
+        .argument("[ide]", `IDE entry-point to install (${VALID_IDE_NAMES}). Omit to install all.`)
+        .option("--force", "Overwrite existing files", false)
+        .option("--path <dir>", "Target project root (default: cwd)", process.cwd())
+        .action((ide, options) => {
+        const targetDir = path.resolve(options.path);
+        if (ide !== undefined) {
+            console.log(`\n🔧 Setting up .NET agent skills [${ide}] in: ${targetDir}\n`);
+        }
+        else {
+            console.log(`\n🔧 Setting up .NET agent skills in: ${targetDir}\n`);
+        }
+        const { packDir, manifest } = loadPackOrExit(DOTNET_PACK);
+        let skills;
+        if (ide !== undefined) {
+            try {
+                skills = filterSkillsForIde(manifest.skills, ide);
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                console.error(`✗ ${message}`);
+                process.exit(1);
+            }
+        }
+        else {
+            skills = manifest.skills;
+        }
+        ensureAgentSkillsDir(targetDir);
+        console.log(`Copying from ${manifest.name}@${manifest.version}\n`);
+        const { written, skipped } = copySkills({
+            skills,
+            packDir,
+            targetDir,
+            force: options.force,
+        });
+        console.log("\n" + "─".repeat(50));
+        console.log(`✔ .NET skills installed — ${written.length} written, ${skipped.length} skipped.`);
+        if (skipped.length > 0) {
+            console.log("  (Run with --force to overwrite skipped files.)");
+        }
+        if (written.length === 0 && skipped.length === 0) {
+            console.error("\n✗ No skills were copied. Check that the pack contains skill entries.");
+            process.exit(1);
+        }
+    });
+}
+function loadPackOrExit(pack) {
+    try {
+        return loadPack(pack);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        console.error(`✗ ${message}`);
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=dotnet-setup.js.map

package/dist/cli/commands/dotnet-setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dotnet-setup.js","sourceRoot":"","sources":["../../../src/cli/commands/dotnet-setup.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/init.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from "commander";
+export declare function initCommand(program: Command): void;
+//# sourceMappingURL=init.d.ts.map

package/dist/cli/commands/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/init.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAsClD"}

package/dist/cli/commands/init.js

@@ -0,0 +1,36 @@
+// src/cli/commands/init.ts
+// `agent-skills init`
+//
+// Scaffolds an empty AgentSkills/ folder + index.json in the current project
+// if one doesn't exist yet. Safe to run multiple times (idempotent).
+import { existsSync, mkdirSync, writeFileSync } from "fs";
+import path from "path";
+export function initCommand(program) {
+    program
+        .command("init")
+        .description("Scaffold an empty AgentSkills/ folder in the current project")
+        .option("--path <dir>", "Target project root (default: cwd)", process.cwd())
+        .option("--force", "Overwrite existing files", false)
+        .action((options) => {
+        const targetDir = path.resolve(options.path);
+        const agentSkillsDir = path.join(targetDir, "AgentSkills");
+        if (existsSync(agentSkillsDir) && !options.force) {
+            console.log(`AgentSkills/ already exists at ${agentSkillsDir}`);
+            console.log("Use --force to reinitialize.");
+            process.exit(0);
+        }
+        mkdirSync(agentSkillsDir, { recursive: true });
+        console.log(`✓ Created ${agentSkillsDir}`);
+        const indexPath = path.join(agentSkillsDir, "index.json");
+        if (!existsSync(indexPath) || options.force) {
+            const indexContent = {
+                skills: [],
+                _comment: "Add skills via `agent-skills add <pack> <skillName>` or `agent-skills dotnet-setup`",
+            };
+            writeFileSync(indexPath, JSON.stringify(indexContent, null, 2) + "\n", "utf8");
+            console.log(`✓ Created ${indexPath}`);
+        }
+        console.log("\n✔ AgentSkills initialized. Run `agent-skills dotnet-setup` to add .NET skills.");
+    });
+}
+//# sourceMappingURL=init.js.map

package/dist/cli/commands/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../../src/cli/commands/init.ts"],"names":[],"mappings":"AAAA,2BAA2B;AAC3B,sBAAsB;AACtB,EAAE;AACF,6EAA6E;AAC7E,qEAAqE;AAErE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;AAC1D,OAAO,IAAI,MAAM,MAAM,CAAC;AAGxB,MAAM,UAAU,WAAW,CAAC,OAAgB;IAC1C,OAAO;SACJ,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,8DAA8D,CAAC;SAC3E,MAAM,CAAC,cAAc,EAAE,oCAAoC,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC;SAC3E,MAAM,CAAC,SAAS,EAAE,0BAA0B,EAAE,KAAK,CAAC;SACpD,MAAM,CAAC,CAAC,OAAyC,EAAE,EAAE;QACpD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC7C,MAAM,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;QAE3D,IAAI,UAAU,CAAC,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YACjD,OAAO,CAAC,GAAG,CAAC,kCAAkC,cAAc,EAAE,CAAC,CAAC;YAChE,OAAO,CAAC,GAAG,CAAC,8BAA8B,CAAC,CAAC;YAC5C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,SAAS,CAAC,cAAc,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/C,OAAO,CAAC,GAAG,CAAC,aAAa,cAAc,EAAE,CAAC,CAAC;QAE3C,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,YAAY,CAAC,CAAC;QAC1D,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;YAC5C,MAAM,YAAY,GAAG;gBACnB,MAAM,EAAE,EAAE;gBACV,QAAQ,EACN,qFAAqF;aACxF,CAAC;YACF,aAAa,CACX,SAAS,EACT,IAAI,CAAC,SAAS,CAAC,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAC5C,MAAM,CACP,CAAC;YACF,OAAO,CAAC,GAAG,CAAC,aAAa,SAAS,EAAE,CAAC,CAAC;QACxC,CAAC;QAED,OAAO,CAAC,GAAG,CACT,kFAAkF,CACnF,CAAC;IACJ,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/cli/commands/list.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from "commander";
+export declare function listCommand(program: Command): void;
+//# sourceMappingURL=list.d.ts.map

package/dist/cli/commands/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/list.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIzC,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA+BlD"}

package/dist/cli/commands/list.js

@@ -0,0 +1,37 @@
+// src/cli/commands/list.ts
+// `agent-skills list [pack]`
+//
+// Lists available skills in an installed or available pack.
+// When no pack is specified, lists all packs the CLI knows about.
+import { resolvePack } from "../../core/resolve-pack.js";
+import { readManifest } from "../../core/manifest.js";
+export function listCommand(program) {
+    program
+        .command("list [pack]")
+        .description("List available skills in a pack (default: all known packs)")
+        .action((pack) => {
+        const packsToList = pack
+            ? [pack]
+            : ["dotnet"]; // Extend this array as new packs are added.
+        let exitCode = 0;
+        for (const packName of packsToList) {
+            try {
+                const packDir = resolvePack(packName);
+                const manifest = readManifest(packDir);
+                console.log(`\n📦 ${manifest.name}@${manifest.version}`);
+                console.log("─".repeat(50));
+                for (const skill of manifest.skills) {
+                    console.log(`  • ${skill.name.padEnd(28)} ${skill.description}`);
+                }
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                console.error(`\n✗ Could not list pack "${packName}": ${message}`);
+                exitCode = 1;
+            }
+        }
+        if (exitCode !== 0)
+            process.exit(exitCode);
+    });
+}
+//# sourceMappingURL=list.js.map

package/dist/cli/commands/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../src/cli/commands/list.ts"],"names":[],"mappings":"AAAA,2BAA2B;AAC3B,6BAA6B;AAC7B,EAAE;AACF,4DAA4D;AAC5D,kEAAkE;AAGlE,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEtD,MAAM,UAAU,WAAW,CAAC,OAAgB;IAC1C,OAAO;SACJ,OAAO,CAAC,aAAa,CAAC;SACtB,WAAW,CAAC,4DAA4D,CAAC;SACzE,MAAM,CAAC,CAAC,IAAa,EAAE,EAAE;QACxB,MAAM,WAAW,GAAG,IAAI;YACtB,CAAC,CAAC,CAAC,IAAI,CAAC;YACR,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,4CAA4C;QAE5D,IAAI,QAAQ,GAAG,CAAC,CAAC;QAEjB,KAAK,MAAM,QAAQ,IAAI,WAAW,EAAE,CAAC;YACnC,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC;gBACtC,MAAM,QAAQ,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;gBAEvC,OAAO,CAAC,GAAG,CAAC,QAAQ,QAAQ,CAAC,IAAI,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;gBACzD,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;gBAE5B,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;oBACpC,OAAO,CAAC,GAAG,CAAC,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;gBACnE,CAAC;YACH,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBACjE,OAAO,CAAC,KAAK,CAAC,4BAA4B,QAAQ,MAAM,OAAO,EAAE,CAAC,CAAC;gBACnE,QAAQ,GAAG,CAAC,CAAC;YACf,CAAC;QACH,CAAC;QAED,IAAI,QAAQ,KAAK,CAAC;YAAE,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/cli/index.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":""}

package/dist/cli/index.js

@@ -0,0 +1,29 @@
+// src/cli/index.ts
+// Wires up the root `commander` program and registers all sub-commands.
+// This file is the only place that imports commander; sub-commands receive
+// the program instance so they stay independently testable.
+import { Command } from "commander";
+import { createRequire } from "module";
+import { initCommand } from "./commands/init.js";
+import { listCommand } from "./commands/list.js";
+import { addCommand } from "./commands/add.js";
+import { dotnetSetupCommand } from "./commands/dotnet-setup.js";
+// Read version from our own package.json without a JSON import assertion
+// (works in Node 18 without the --experimental-json-modules flag).
+const require = createRequire(import.meta.url);
+const { version } = require("../../package.json");
+const program = new Command();
+program
+    .name("agent-skills")
+    .description("Scaffold and manage AI agent skills across projects")
+    .version(version);
+initCommand(program);
+listCommand(program);
+addCommand(program);
+dotnetSetupCommand(program);
+program.parseAsync(process.argv).catch((err) => {
+    const message = err instanceof Error ? err.message : String(err);
+    console.error(`\n✗ ${message}`);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAAA,mBAAmB;AACnB,wEAAwE;AACxE,2EAA2E;AAC3E,4DAA4D;AAE5D,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAEhE,yEAAyE;AACzE,mEAAmE;AACnE,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,oBAAoB,CAAwB,CAAC;AAEzE,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,cAAc,CAAC;KACpB,WAAW,CAAC,qDAAqD,CAAC;KAClE,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,WAAW,CAAC,OAAO,CAAC,CAAC;AACrB,WAAW,CAAC,OAAO,CAAC,CAAC;AACrB,UAAU,CAAC,OAAO,CAAC,CAAC;AACpB,kBAAkB,CAAC,OAAO,CAAC,CAAC;AAE5B,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;IACtD,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACjE,OAAO,CAAC,KAAK,CAAC,OAAO,OAAO,EAAE,CAAC,CAAC;IAChC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/core/copy-skills.d.ts

@@ -0,0 +1,28 @@
+import type { SkillEntry } from "./manifest.js";
+export interface CopyResult {
+    /** Files that were successfully written. */
+    written: string[];
+    /** Files that were skipped because they already exist. */
+    skipped: string[];
+}
+export interface CopySkillsOptions {
+    /** Skills to copy, filtered from the manifest (all or a single skill). */
+    skills: SkillEntry[];
+    /** Absolute path to the pack root. */
+    packDir: string;
+    /** Absolute path to the target project root. */
+    targetDir: string;
+    /** When true, overwrite existing files. */
+    force: boolean;
+}
+/**
+ * Copies a list of skill source directories into the target project.
+ */
+export declare function copySkills(options: CopySkillsOptions): CopyResult;
+/**
+ * Ensures the AgentSkills root directory exists in the target project.
+ *
+ * @returns Absolute path to AgentSkills/.
+ */
+export declare function ensureAgentSkillsDir(targetDir: string): string;
+//# sourceMappingURL=copy-skills.d.ts.map

package/dist/core/copy-skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"copy-skills.d.ts","sourceRoot":"","sources":["../../src/core/copy-skills.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD,MAAM,WAAW,UAAU;IACzB,4CAA4C;IAC5C,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,0DAA0D;IAC1D,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,0EAA0E;IAC1E,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,gDAAgD;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,2CAA2C;IAC3C,KAAK,EAAE,OAAO,CAAC;CAChB;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,UAAU,CA0CjE;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAI9D"}

package/dist/core/copy-skills.js

@@ -0,0 +1,60 @@
+// src/core/copy-skills.ts
+// Copies skill files from a pack into the target project's AgentSkills/ folder.
+//
+// Rules enforced here:
+//   - Never overwrite an existing file without --force; warn and skip instead.
+//   - Directories are created recursively as needed.
+//   - Returns a summary object for the caller to print: { written, skipped }.
+//
+// This module contains no pack-specific logic. The manifest tells it what
+// to copy; it does not inspect SKILL.md contents.
+import { cpSync, existsSync, mkdirSync, rmSync } from "fs";
+import path from "path";
+/**
+ * Copies a list of skill source directories into the target project.
+ */
+export function copySkills(options) {
+    const { skills, packDir, targetDir, force } = options;
+    const written = [];
+    const skipped = [];
+    for (const skill of skills) {
+        const src = path.join(packDir, skill.path);
+        // dest overrides where the file lands in the target project.
+        // Used for IDE entry-points (e.g. CLAUDE.md, .github/copilot-instructions.md)
+        // that must live outside AgentSkills/ at a specific root-relative path.
+        const destRelPath = skill.dest ?? skill.path;
+        const dest = path.join(targetDir, destRelPath);
+        if (!existsSync(src)) {
+            console.warn(`  ⚠ Source path for skill "${skill.name}" not found: ${src}`);
+            skipped.push(destRelPath);
+            continue;
+        }
+        if (existsSync(dest) && !force) {
+            console.warn(`  ⚠ Skipping "${skill.name}" — destination already exists. Use --force to overwrite.`);
+            skipped.push(destRelPath);
+            continue;
+        }
+        mkdirSync(path.dirname(dest), { recursive: true });
+        // Remove the destination first when forcing — cpSync throws "src and dest
+        // cannot be the same" on Windows if the dest directory already exists,
+        // even with force:true.
+        if (force && existsSync(dest)) {
+            rmSync(dest, { recursive: true, force: true });
+        }
+        cpSync(src, dest, { recursive: true });
+        written.push(destRelPath);
+        console.log(`  ✓ ${destRelPath}`);
+    }
+    return { written, skipped };
+}
+/**
+ * Ensures the AgentSkills root directory exists in the target project.
+ *
+ * @returns Absolute path to AgentSkills/.
+ */
+export function ensureAgentSkillsDir(targetDir) {
+    const dir = path.join(targetDir, "AgentSkills");
+    mkdirSync(dir, { recursive: true });
+    return dir;
+}
+//# sourceMappingURL=copy-skills.js.map

package/dist/core/copy-skills.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"copy-skills.js","sourceRoot":"","sources":["../../src/core/copy-skills.ts"],"names":[],"mappings":"AAAA,0BAA0B;AAC1B,gFAAgF;AAChF,EAAE;AACF,uBAAuB;AACvB,+EAA+E;AAC/E,qDAAqD;AACrD,8EAA8E;AAC9E,EAAE;AACF,0EAA0E;AAC1E,kDAAkD;AAElD,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,IAAI,CAAC;AAC3D,OAAO,IAAI,MAAM,MAAM,CAAC;AAqBxB;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,OAA0B;IACnD,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC;IACtD,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAC3C,6DAA6D;QAC7D,8EAA8E;QAC9E,wEAAwE;QACxE,MAAM,WAAW,GAAG,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC;QAC7C,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;QAE/C,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACrB,OAAO,CAAC,IAAI,CACV,8BAA8B,KAAK,CAAC,IAAI,gBAAgB,GAAG,EAAE,CAC9D,CAAC;YACF,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YAC1B,SAAS;QACX,CAAC;QAED,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YAC/B,OAAO,CAAC,IAAI,CACV,iBAAiB,KAAK,CAAC,IAAI,2DAA2D,CACvF,CAAC;YACF,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YAC1B,SAAS;QACX,CAAC;QAED,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACnD,0EAA0E;QAC1E,uEAAuE;QACvE,wBAAwB;QACxB,IAAI,KAAK,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9B,MAAM,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACjD,CAAC;QACD,MAAM,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACvC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAC1B,OAAO,CAAC,GAAG,CAAC,OAAO,WAAW,EAAE,CAAC,CAAC;IACpC,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AAC9B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,SAAiB;IACpD,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;IAChD,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACpC,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/core/load-pack.d.ts

@@ -0,0 +1,15 @@
+import type { Manifest } from "./manifest.js";
+export interface LoadedPack {
+    /** Absolute path to the pack root. */
+    packDir: string;
+    /** Validated manifest for the pack. */
+    manifest: Manifest;
+}
+/**
+ * Resolves a pack by name and reads its manifest.
+ * Throws with a user-friendly message on any failure.
+ *
+ * @throws When the pack cannot be resolved or its manifest is invalid.
+ */
+export declare function loadPack(packName: string): LoadedPack;
+//# sourceMappingURL=load-pack.d.ts.map

package/dist/core/load-pack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-pack.d.ts","sourceRoot":"","sources":["../../src/core/load-pack.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C,MAAM,WAAW,UAAU;IACzB,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,uCAAuC;IACvC,QAAQ,EAAE,QAAQ,CAAC;CACpB;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,CAoBrD"}

package/dist/core/load-pack.js

@@ -0,0 +1,35 @@
+// src/core/load-pack.ts
+// Shared helper that resolves a pack and reads its manifest in one step.
+//
+// Eliminates the duplicated try/catch pattern that previously appeared
+// in both add.ts and dotnet-setup.ts. Commands that need a pack and its
+// manifest should call this instead of calling resolvePack + readManifest
+// separately.
+import { resolvePack } from "./resolve-pack.js";
+import { readManifest } from "./manifest.js";
+/**
+ * Resolves a pack by name and reads its manifest.
+ * Throws with a user-friendly message on any failure.
+ *
+ * @throws When the pack cannot be resolved or its manifest is invalid.
+ */
+export function loadPack(packName) {
+    let packDir;
+    try {
+        packDir = resolvePack(packName);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        throw new Error(`Could not resolve pack "${packName}": ${message}`);
+    }
+    let manifest;
+    try {
+        manifest = readManifest(packDir);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        throw new Error(`Could not read manifest for pack "${packName}": ${message}`);
+    }
+    return { packDir, manifest };
+}
+//# sourceMappingURL=load-pack.js.map

package/dist/core/load-pack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-pack.js","sourceRoot":"","sources":["../../src/core/load-pack.ts"],"names":[],"mappings":"AAAA,wBAAwB;AACxB,yEAAyE;AACzE,EAAE;AACF,uEAAuE;AACvE,wEAAwE;AACxE,0EAA0E;AAC1E,cAAc;AAEd,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAU7C;;;;;GAKG;AACH,MAAM,UAAU,QAAQ,CAAC,QAAgB;IACvC,IAAI,OAAe,CAAC;IACpB,IAAI,CAAC;QACH,OAAO,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC;IAClC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,MAAM,IAAI,KAAK,CAAC,2BAA2B,QAAQ,MAAM,OAAO,EAAE,CAAC,CAAC;IACtE,CAAC;IAED,IAAI,QAAkB,CAAC;IACvB,IAAI,CAAC;QACH,QAAQ,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;IACnC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,MAAM,IAAI,KAAK,CACb,qCAAqC,QAAQ,MAAM,OAAO,EAAE,CAC7D,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;AAC/B,CAAC"}

package/dist/core/manifest.d.ts

@@ -0,0 +1,29 @@
+export interface SkillEntry {
+    /** Short identifier used as a CLI argument. */
+    name: string;
+    /** Human-readable purpose of the skill. */
+    description: string;
+    /** Source path of the skill, relative to the pack root. */
+    path: string;
+    /**
+     * Destination path in the target project, relative to the project root.
+     * When absent, `path` is used as the destination.
+     * Use this for IDE entry-point files that must land outside AgentSkills/.
+     */
+    dest?: string;
+}
+export interface Manifest {
+    /** Package name. */
+    name: string;
+    /** Semver string. */
+    version: string;
+    /** All skills provided by this pack. */
+    skills: SkillEntry[];
+}
+/**
+ * Reads and validates the manifest.json for a pack.
+ *
+ * @throws When manifest is missing, unreadable, or structurally invalid.
+ */
+export declare function readManifest(packDir: string): Manifest;
+//# sourceMappingURL=manifest.d.ts.map

package/dist/core/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/core/manifest.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,UAAU;IACzB,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,2CAA2C;IAC3C,WAAW,EAAE,MAAM,CAAC;IACpB,2DAA2D;IAC3D,IAAI,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,QAAQ;IACvB,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,qBAAqB;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,wCAAwC;IACxC,MAAM,EAAE,UAAU,EAAE,CAAC;CACtB;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ,CAkCtD"}