@pratikpsl/agent-skills 0.3.0 → 0.5.0

package/dist/core/manifest.js

@@ -0,0 +1,75 @@
+// src/core/manifest.ts
+// Reads and validates a pack's manifest.json.
+//
+// The manifest is the contract between a skills pack and the CLI.
+// It declares what skills exist, where their source files are, and where
+// they should be placed in the target project.
+import { readFileSync, existsSync } from "fs";
+import path from "path";
+/**
+ * Reads and validates the manifest.json for a pack.
+ *
+ * @throws When manifest is missing, unreadable, or structurally invalid.
+ */
+export function readManifest(packDir) {
+    const manifestPath = path.join(packDir, "manifest.json");
+    if (!existsSync(manifestPath)) {
+        throw new Error(`manifest.json not found in pack at "${packDir}". ` +
+            `This pack may be malformed or out of date.`);
+    }
+    let raw;
+    try {
+        raw = readFileSync(manifestPath, "utf8");
+        // Strip UTF-8 BOM if present.
+        if (raw.charCodeAt(0) === 0xfeff) {
+            raw = raw.slice(1);
+        }
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        throw new Error(`Could not read manifest.json: ${message}`);
+    }
+    let manifest;
+    try {
+        manifest = JSON.parse(raw);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        throw new Error(`manifest.json at "${manifestPath}" is not valid JSON: ${message}`);
+    }
+    validateManifest(manifest, manifestPath);
+    return manifest;
+}
+/**
+ * Throws with a descriptive message if the manifest does not meet the
+ * required shape.
+ */
+function validateManifest(manifest, filePath) {
+    if (typeof manifest !== "object" || manifest === null) {
+        throw new Error(`manifest.json at "${filePath}" must be a JSON object.`);
+    }
+    const obj = manifest;
+    const required = ["name", "version", "skills"];
+    for (const key of required) {
+        if (!(key in obj)) {
+            throw new Error(`manifest.json is missing required field "${key}".`);
+        }
+    }
+    if (!Array.isArray(obj.skills)) {
+        throw new Error(`manifest.json "skills" must be an array.`);
+    }
+    for (const [i, skill] of obj.skills.entries()) {
+        const entry = skill;
+        for (const field of ["name", "description", "path"]) {
+            if (typeof entry[field] !== "string" || !entry[field].trim()) {
+                throw new Error(`manifest.json skills[${i}] is missing or has an empty "${field}" field.`);
+            }
+        }
+        // dest is optional; when present it must be a non-empty string.
+        if ("dest" in entry &&
+            (typeof entry.dest !== "string" || !entry.dest.trim())) {
+            throw new Error(`manifest.json skills[${i}] has an invalid "dest" field — must be a non-empty string when present.`);
+        }
+    }
+}
+//# sourceMappingURL=manifest.js.map

package/dist/core/manifest.js.map

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

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

@@ -0,0 +1,7 @@
+/**
+ * Resolves a pack name or alias to its installed directory.
+ *
+ * @throws When the pack cannot be located.
+ */
+export declare function resolvePack(packName: string): string;
+//# sourceMappingURL=resolve-pack.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-pack.d.ts","sourceRoot":"","sources":["../../src/core/resolve-pack.ts"],"names":[],"mappings":"AAoBA;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CA6BpD"}

package/dist/core/resolve-pack.js

@@ -0,0 +1,38 @@
+// src/core/resolve-pack.ts
+// Locates a templates folder bundled inside the package itself.
+// Since everything is in one package, no runtime npm fetching is needed.
+//
+// Templates live at the repo/package root under `templates/<packName>/`.
+import { existsSync } from "fs";
+import path from "path";
+import { fileURLToPath } from "url";
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+/** Canonical directory names for built-in packs. */
+const PACK_ALIASES = {
+    dotnet: "dotnet",
+    "skills-dotnet": "dotnet",
+    "@pratikpsl/agent-skills-dotnet": "dotnet",
+};
+/**
+ * Resolves a pack name or alias to its installed directory.
+ *
+ * @throws When the pack cannot be located.
+ */
+export function resolvePack(packName) {
+    const normalized = PACK_ALIASES[packName] ??
+        packName
+            .replace(/^@pratikpsl\/agent-skills-/, "")
+            .replace(/^skills-/, "");
+    // templates/ lives three levels up from dist/core/ (at the package root)
+    // In development (src/core/), it's two levels up — but we always run from
+    // the compiled dist/, so three levels is correct.
+    const templateDir = path.resolve(__dirname, "..", "..", "templates", normalized);
+    if (existsSync(templateDir) &&
+        existsSync(path.join(templateDir, "manifest.json"))) {
+        return templateDir;
+    }
+    throw new Error(`Pack "${packName}" (mapped to "${normalized}") is not bundled with this version of the CLI. ` +
+        `Currently available packs: dotnet`);
+}
+//# sourceMappingURL=resolve-pack.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-pack.js","sourceRoot":"","sources":["../../src/core/resolve-pack.ts"],"names":[],"mappings":"AAAA,2BAA2B;AAC3B,gEAAgE;AAChE,yEAAyE;AACzE,EAAE;AACF,yEAAyE;AAEzE,OAAO,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAChC,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAEpC,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;AAE3C,oDAAoD;AACpD,MAAM,YAAY,GAA2B;IAC3C,MAAM,EAAE,QAAQ;IAChB,eAAe,EAAE,QAAQ;IACzB,gCAAgC,EAAE,QAAQ;CAC3C,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,QAAgB;IAC1C,MAAM,UAAU,GACd,YAAY,CAAC,QAAQ,CAAC;QACtB,QAAQ;aACL,OAAO,CAAC,4BAA4B,EAAE,EAAE,CAAC;aACzC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAE7B,yEAAyE;IACzE,0EAA0E;IAC1E,kDAAkD;IAClD,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAC9B,SAAS,EACT,IAAI,EACJ,IAAI,EACJ,WAAW,EACX,UAAU,CACX,CAAC;IAEF,IACE,UAAU,CAAC,WAAW,CAAC;QACvB,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,eAAe,CAAC,CAAC,EACnD,CAAC;QACD,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,MAAM,IAAI,KAAK,CACb,SAAS,QAAQ,iBAAiB,UAAU,kDAAkD;QAC5F,mCAAmC,CACtC,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,14 +1,14 @@
 {
   "name": "@pratikpsl/agent-skills",
   "type": "module",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "description": "CLI to scaffold and manage AI agent skills across projects",
   "bin": {
-    "agent-skills": "bin/agent-skills.js"
+    "agent-skills": "dist/bin/agent-skills.js"
   },
   "files": [
-    "bin",
-    "src",
+    "dist",
+    "templates",
     "README.md",
     "LICENSE"
   ],
@@ -24,14 +24,17 @@
     "url": "git+https://github.com/pratiksinghlad/coding-skills-ai.git"
   },
   "scripts": {
+    "build": "tsc",
     "test": "vitest run",
     "test:watch": "vitest",
-    "dry-run": "npm publish --dry-run"
+    "dry-run": "npm run build && npm publish --dry-run"
   },
   "dependencies": {
     "commander": "^12.0.0"
   },
   "devDependencies": {
+    "@types/node": "^22.15.33",
+    "typescript": "^5.8.3",
     "vitest": "^3.0.0"
   }
 }

package/templates/dotnet/AgentSkills/entry-points/AGENTS.md

@@ -0,0 +1,50 @@
+# Codex / OpenAI Entry Point
+
+This file is a lightweight entry point for Codex and OpenAI agents.
+
+`AgentSkills/` is the single source of truth for skills, agents, memory,
+prerequisites, checklists, and project rules used by all coding agents and
+AI-enabled IDEs in this repository.
+
+## Start Here
+
+1. Read `AgentSkills/OPERATING.md`.
+2. Follow skill routing in `AgentSkills/skills/INDEX.md`.
+3. Load role definitions from `AgentSkills/agents/` only when the task requires them.
+
+Do not duplicate canonical instructions in this file. Edit shared guidance in
+`AgentSkills/`.
+
+## Mandatory Bootstrap (All Agents — Enforced)
+
+Before changing any file or producing a final answer for any **code-changing**
+task in this repository, you MUST complete the following bootstrap sequence
+in order. Do NOT skip this sequence even for tasks that appear simple or quick.
+
+1. Read `AgentSkills/OPERATING.md`.
+2. Read `AgentSkills/memory/index.md`; load only the domain lesson file(s)
+   relevant to the current task (do not load all files at once).
+3. Read `AgentSkills/skills/INDEX.md` (when it exists).
+4. Always load `AgentSkills/skills/core/SKILL.md`.
+5. Load any task-specific skill from `AgentSkills/skills/` that matches the task.
+6. For .NET / C# implementation tasks, load `AgentSkills/agents/developer.agent.md`.
+7. For design, CQRS structure, SQL schema, or architecture tasks, load
+   `AgentSkills/agents/architect.agent.md`.
+8. Inspect the worktree context before editing so existing user changes are
+   preserved.
+9. Define the verification path for the task before making changes.
+
+## Completion Gate (All Agents — Enforced)
+
+Before marking any code-changing task complete:
+
+1. Run the pre-submit checklist in `AgentSkills/skills/core/SKILL.md`.
+2. Run the harness validator (unless the task is documentation-only or the
+   environment cannot run it — in that case, state the reason explicitly):
+
+   ```powershell
+   pwsh ./tools/Harness/validate.ps1
+   ```
+
+3. Do not claim completion when required checks fail. List failures clearly and
+   leave the work in a reviewable state.

package/templates/dotnet/AgentSkills/entry-points/CLAUDE.md

@@ -0,0 +1,50 @@
+# Claude Entry Point
+
+This file is a lightweight entry point for Claude (Anthropic).
+
+`AgentSkills/` is the single source of truth for skills, agents, memory,
+prerequisites, checklists, and project rules used by all coding agents and
+AI-enabled IDEs in this repository.
+
+## Start Here
+
+1. Read `AgentSkills/OPERATING.md`.
+2. Follow skill routing in `AgentSkills/skills/INDEX.md`.
+3. Load role definitions from `AgentSkills/agents/` only when the task requires them.
+
+Do not duplicate canonical instructions in this file. Edit shared guidance in
+`AgentSkills/`.
+
+## Mandatory Bootstrap (All Agents — Enforced)
+
+Before changing any file or producing a final answer for any **code-changing**
+task in this repository, you MUST complete the following bootstrap sequence
+in order. Do NOT skip this sequence even for tasks that appear simple or quick.
+
+1. Read `AgentSkills/OPERATING.md`.
+2. Read `AgentSkills/memory/index.md`; load only the domain lesson file(s)
+   relevant to the current task (do not load all files at once).
+3. Read `AgentSkills/skills/INDEX.md` (when it exists).
+4. Always load `AgentSkills/skills/core/SKILL.md`.
+5. Load any task-specific skill from `AgentSkills/skills/` that matches the task.
+6. For .NET / C# implementation tasks, load `AgentSkills/agents/developer.agent.md`.
+7. For design, CQRS structure, SQL schema, or architecture tasks, load
+   `AgentSkills/agents/architect.agent.md`.
+8. Inspect the worktree context before editing so existing user changes are
+   preserved.
+9. Define the verification path for the task before making changes.
+
+## Completion Gate (All Agents — Enforced)
+
+Before marking any code-changing task complete:
+
+1. Run the pre-submit checklist in `AgentSkills/skills/core/SKILL.md`.
+2. Run the harness validator (unless the task is documentation-only or the
+   environment cannot run it — in that case, state the reason explicitly):
+
+   ```powershell
+   pwsh ./tools/Harness/validate.ps1
+   ```
+
+3. Do not claim completion when required checks fail. List failures clearly and
+   leave the work in a reviewable state.

package/templates/dotnet/AgentSkills/entry-points/antigravity-instructions.md

@@ -0,0 +1,50 @@
+# Antigravity Entry Point
+
+This file is a lightweight entry point for the Antigravity IDE (Google DeepMind).
+
+`AgentSkills/` is the single source of truth for skills, agents, memory,
+prerequisites, checklists, and project rules used by all coding agents and
+AI-enabled IDEs in this repository.
+
+## Start Here
+
+1. Read `AgentSkills/OPERATING.md`.
+2. Follow skill routing in `AgentSkills/skills/INDEX.md`.
+3. Load role definitions from `AgentSkills/agents/` only when the task requires them.
+
+Do not duplicate canonical instructions in this file. Edit shared guidance in
+`AgentSkills/`.
+
+## Mandatory Bootstrap (All Agents — Enforced)
+
+Before changing any file or producing a final answer for any **code-changing**
+task in this repository, you MUST complete the following bootstrap sequence
+in order. Do NOT skip this sequence even for tasks that appear simple or quick.
+
+1. Read `AgentSkills/OPERATING.md`.
+2. Read `AgentSkills/memory/index.md`; load only the domain lesson file(s)
+   relevant to the current task (do not load all files at once).
+3. Read `AgentSkills/skills/INDEX.md` (when it exists).
+4. Always load `AgentSkills/skills/core/SKILL.md`.
+5. Load any task-specific skill from `AgentSkills/skills/` that matches the task.
+6. For .NET / C# implementation tasks, load `AgentSkills/agents/developer.agent.md`.
+7. For design, CQRS structure, SQL schema, or architecture tasks, load
+   `AgentSkills/agents/architect.agent.md`.
+8. Inspect the worktree context before editing so existing user changes are
+   preserved.
+9. Define the verification path for the task before making changes.
+
+## Completion Gate (All Agents — Enforced)
+
+Before marking any code-changing task complete:
+
+1. Run the pre-submit checklist in `AgentSkills/skills/core/SKILL.md`.
+2. Run the harness validator (unless the task is documentation-only or the
+   environment cannot run it — in that case, state the reason explicitly):
+
+   ```powershell
+   pwsh ./tools/Harness/validate.ps1
+   ```
+
+3. Do not claim completion when required checks fail. List failures clearly and
+   leave the work in a reviewable state.

package/templates/dotnet/AgentSkills/entry-points/copilot-instructions.md

@@ -0,0 +1,50 @@
+# Copilot Entry Point
+
+This file is a lightweight entry point for GitHub Copilot.
+
+`AgentSkills/` is the single source of truth for skills, agents, memory,
+prerequisites, checklists, and project rules used by all coding agents and
+AI-enabled IDEs in this repository.
+
+## Start Here
+
+1. Read `AgentSkills/OPERATING.md`.
+2. Follow skill routing in `AgentSkills/skills/INDEX.md`.
+3. Load role definitions from `AgentSkills/agents/` only when the task requires them.
+
+Do not duplicate canonical instructions in this file. Edit shared guidance in
+`AgentSkills/`.
+
+## Mandatory Bootstrap (All Agents — Enforced)
+
+Before changing any file or producing a final answer for any **code-changing**
+task in this repository, you MUST complete the following bootstrap sequence
+in order. Do NOT skip this sequence even for tasks that appear simple or quick.
+
+1. Read `AgentSkills/OPERATING.md`.
+2. Read `AgentSkills/memory/index.md`; load only the domain lesson file(s)
+   relevant to the current task (do not load all files at once).
+3. Read `AgentSkills/skills/INDEX.md` (when it exists).
+4. Always load `AgentSkills/skills/core/SKILL.md`.
+5. Load any task-specific skill from `AgentSkills/skills/` that matches the task.
+6. For .NET / C# implementation tasks, load `AgentSkills/agents/developer.agent.md`.
+7. For design, CQRS structure, SQL schema, or architecture tasks, load
+   `AgentSkills/agents/architect.agent.md`.
+8. Inspect the worktree context before editing so existing user changes are
+   preserved.
+9. Define the verification path for the task before making changes.
+
+## Completion Gate (All Agents — Enforced)
+
+Before marking any code-changing task complete:
+
+1. Run the pre-submit checklist in `AgentSkills/skills/core/SKILL.md`.
+2. Run the harness validator (unless the task is documentation-only or the
+   environment cannot run it — in that case, state the reason explicitly):
+
+   ```powershell
+   pwsh ./tools/Harness/validate.ps1
+   ```
+
+3. Do not claim completion when required checks fail. List failures clearly and
+   leave the work in a reviewable state.

package/templates/dotnet/AgentSkills/entry-points/cursor-instructions.md

@@ -0,0 +1,50 @@
+# Cursor / Antigravity Entry Point
+
+This file is a lightweight entry point for Cursor and Antigravity IDEs.
+
+`AgentSkills/` is the single source of truth for skills, agents, memory,
+prerequisites, checklists, and project rules used by all coding agents and
+AI-enabled IDEs in this repository.
+
+## Start Here
+
+1. Read `AgentSkills/OPERATING.md`.
+2. Follow skill routing in `AgentSkills/skills/INDEX.md`.
+3. Load role definitions from `AgentSkills/agents/` only when the task requires them.
+
+Do not duplicate canonical instructions in this file. Edit shared guidance in
+`AgentSkills/`.
+
+## Mandatory Bootstrap (All Agents — Enforced)
+
+Before changing any file or producing a final answer for any **code-changing**
+task in this repository, you MUST complete the following bootstrap sequence
+in order. Do NOT skip this sequence even for tasks that appear simple or quick.
+
+1. Read `AgentSkills/OPERATING.md`.
+2. Read `AgentSkills/memory/index.md`; load only the domain lesson file(s)
+   relevant to the current task (do not load all files at once).
+3. Read `AgentSkills/skills/INDEX.md` (when it exists).
+4. Always load `AgentSkills/skills/core/SKILL.md`.
+5. Load any task-specific skill from `AgentSkills/skills/` that matches the task.
+6. For .NET / C# implementation tasks, load `AgentSkills/agents/developer.agent.md`.
+7. For design, CQRS structure, SQL schema, or architecture tasks, load
+   `AgentSkills/agents/architect.agent.md`.
+8. Inspect the worktree context before editing so existing user changes are
+   preserved.
+9. Define the verification path for the task before making changes.
+
+## Completion Gate (All Agents — Enforced)
+
+Before marking any code-changing task complete:
+
+1. Run the pre-submit checklist in `AgentSkills/skills/core/SKILL.md`.
+2. Run the harness validator (unless the task is documentation-only or the
+   environment cannot run it — in that case, state the reason explicitly):
+
+   ```powershell
+   pwsh ./tools/Harness/validate.ps1
+   ```
+
+3. Do not claim completion when required checks fail. List failures clearly and
+   leave the work in a reviewable state.

package/templates/dotnet/AgentSkills/memory/index.md

@@ -0,0 +1,22 @@
+# Memory Index
+
+Always load this file first. Then load **only** the domain file(s) that match your task.
+Do NOT load domain files you do not need. Never load all files at once.
+
+## Domain Map
+
+| Domain  | Load when                                                     | File                                     | Lessons |
+| ------- | ------------------------------------------------------------- | ---------------------------------------- | ------- |
+| api     | CQRS, MediatR, commands, queries, controllers, endpoints      | [lessons/api.md](lessons/api.md)         | 1       |
+| db      | EF Core, migrations, schema, seeding, repositories            | [lessons/db.md](lessons/db.md)           | 0       |
+| infra   | Build, paths, CI, tooling, portability, AgentSkills setup     | [lessons/infra.md](lessons/infra.md)     | 6       |
+| auth    | Authentication, authorisation, JWT, policies, claims          | [lessons/auth.md](lessons/auth.md)       | 0       |
+| testing | xUnit, test data, mocking, coverage, assertions               | [lessons/testing.md](lessons/testing.md) | 0       |
+| csharp  | C# language features, async/await, naming, code style         | [lessons/csharp.md](lessons/csharp.md)   | 0       |
+| design  | SOLID, CQRS, Repository, patterns, architecture decisions     | [lessons/design.md](lessons/design.md)   | 0       |
+| mcp     | MCP server tools, transports, contracts, .NET MCP integration | [lessons/mcp.md](lessons/mcp.md)         | 0       |
+
+## Writing a lesson?
+
+Load `memory/schema.md` for the one-line format. Do not inline logging instructions here.
+Update the lesson count in this table after appending to the domain file.

package/templates/dotnet/AgentSkills/memory/lessons/design.md

@@ -0,0 +1,3 @@
+# Design Lessons
+
+RULE: Always use flat vertical slice feature folders; never create nested Commands or Queries subfolders. #wrong-path 2026-07-05

package/{src/templates → templates}/dotnet/AgentSkills/memory/lessons/infra.md

@@ -5,3 +5,4 @@ RULE: Use repo-relative paths in all agent and IDE instruction files; never writ
 RULE: When splitting a monolithic memory file into domain files, grep the whole repo for the old path and update every reference before deleting the original. #stale-reference 2026-06-07
 RULE: Always check native command exit codes explicitly in PowerShell harness scripts. #native-exit-code 2026-06-21
 RULE: Run dotnet format after patching C# files; this repo enforces CRLF and no final newline. #format-fail 2026-07-01
+RULE: Always execute the full AgentSkills bootstrap sequence before any code-changing task, even simple ones. #bootstrap-skip 2026-07-05

package/{src/templates → templates}/dotnet/manifest.json

@@ -1,6 +1,6 @@
 {
   "name": "@pratikpsl/agent-skills-dotnet",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "description": "AI agent skill definitions for .NET/C# projects (CQRS, MediatR, EF Core, xUnit, ASP.NET Core).",
   "skills": [
     {
@@ -78,9 +78,15 @@
     },
     {
       "name": "entry-point:cursor",
-      "description": "Lightweight Cursor/Antigravity entry point — routes the agent to AgentSkills/OPERATING.md.",
+      "description": "Lightweight Cursor entry point — routes the agent to AgentSkills/OPERATING.md.",
       "path": "AgentSkills/entry-points/cursor-instructions.md",
       "dest": ".cursor/rules/instructions.md"
+    },
+    {
+      "name": "entry-point:antigravity",
+      "description": "Lightweight Antigravity (Google DeepMind) entry point — routes the agent to AgentSkills/OPERATING.md.",
+      "path": "AgentSkills/entry-points/antigravity-instructions.md",
+      "dest": ".agents/GEMINI.md"
     }
   ]
 }

package/bin/agent-skills.js

@@ -1,7 +0,0 @@
-#!/usr/bin/env node
-// bin/agent-skills.js
-// Entrypoint for the `agent-skills` CLI.
-// Must stay thin: parse args, delegate to src/index.js.
-// chmod +x is set by the npm publish pipeline (files are executable).
-
-import '../src/index.js';

package/src/__tests__/copySkills.test.js

@@ -1,161 +0,0 @@
-// src/__tests__/copySkills.test.js
-// Unit tests for the copySkills utility.
-// Key invariants tested:
-//   1. Files are copied when destination does not exist.
-//   2. Existing files are NOT overwritten without --force.
-//   3. Existing files ARE overwritten with --force.
-//   4. Summary counts (written/skipped) are correct.
-//   5. The optional `dest` field routes a file to a different target path (IDE entry-points).
-
-import { describe, it, expect, beforeEach, afterEach } from 'vitest';
-import { mkdirSync, writeFileSync, readFileSync, rmSync, existsSync } from 'fs';
-import path from 'path';
-import os from 'os';
-import { copySkills } from '../lib/copySkills.js';
-
-function makeTempDir() {
-  const dir = path.join(os.tmpdir(), `agent-skills-copy-test-${Date.now()}`);
-  mkdirSync(dir, { recursive: true });
-  return dir;
-}
-
-function createSkillSource(packDir, skillRelPath, content = 'skill content') {
-  const fullPath = path.join(packDir, skillRelPath);
-  mkdirSync(fullPath, { recursive: true });
-  writeFileSync(path.join(fullPath, 'SKILL.md'), content);
-}
-
-describe('copySkills', () => {
-  let packDir;
-  let targetDir;
-
-  beforeEach(() => {
-    const ts = Date.now();
-    packDir = path.join(os.tmpdir(), `agent-skills-pack-${ts}`);
-    targetDir = path.join(os.tmpdir(), `agent-skills-target-${ts}`);
-    mkdirSync(packDir, { recursive: true });
-    mkdirSync(targetDir, { recursive: true });
-  });
-
-  afterEach(() => {
-    rmSync(packDir, { recursive: true, force: true });
-    rmSync(targetDir, { recursive: true, force: true });
-  });
-
-  const skills = [
-    { name: 'core', description: 'Core principles', path: 'AgentSkills/skills/core' },
-  ];
-
-  it('copies a skill when destination does not exist', () => {
-    createSkillSource(packDir, 'AgentSkills/skills/core');
-
-    const { written, skipped } = copySkills({ skills, packDir, targetDir, force: false });
-
-    expect(written).toHaveLength(1);
-    expect(skipped).toHaveLength(0);
-    expect(existsSync(path.join(targetDir, 'AgentSkills/skills/core/SKILL.md'))).toBe(true);
-  });
-
-  it('skips an existing skill without --force', () => {
-    createSkillSource(packDir, 'AgentSkills/skills/core', 'original');
-    // Pre-create destination with different content
-    const destSkillDir = path.join(targetDir, 'AgentSkills/skills/core');
-    mkdirSync(destSkillDir, { recursive: true });
-    writeFileSync(path.join(destSkillDir, 'SKILL.md'), 'existing content');
-
-    const { written, skipped } = copySkills({ skills, packDir, targetDir, force: false });
-
-    expect(written).toHaveLength(0);
-    expect(skipped).toHaveLength(1);
-    // Existing content should be preserved
-    const content = readFileSync(path.join(destSkillDir, 'SKILL.md'), 'utf8');
-    expect(content).toBe('existing content');
-  });
-
-  it('overwrites an existing skill with --force', () => {
-    createSkillSource(packDir, 'AgentSkills/skills/core', 'new content');
-    const destSkillDir = path.join(targetDir, 'AgentSkills/skills/core');
-    mkdirSync(destSkillDir, { recursive: true });
-    writeFileSync(path.join(destSkillDir, 'SKILL.md'), 'old content');
-
-    const { written, skipped } = copySkills({ skills, packDir, targetDir, force: true });
-
-    expect(written).toHaveLength(1);
-    expect(skipped).toHaveLength(0);
-    const content = readFileSync(path.join(destSkillDir, 'SKILL.md'), 'utf8');
-    expect(content).toBe('new content');
-  });
-
-  it('returns correct counts for mixed written/skipped', () => {
-    const twoSkills = [
-      { name: 'core', description: 'Core', path: 'AgentSkills/skills/core' },
-      { name: 'design', description: 'Design', path: 'AgentSkills/skills/design' },
-    ];
-
-    createSkillSource(packDir, 'AgentSkills/skills/core');
-    createSkillSource(packDir, 'AgentSkills/skills/design');
-
-    // Pre-create only core in the destination
-    const destCore = path.join(targetDir, 'AgentSkills/skills/core');
-    mkdirSync(destCore, { recursive: true });
-    writeFileSync(path.join(destCore, 'SKILL.md'), 'existing');
-
-    const { written, skipped } = copySkills({ skills: twoSkills, packDir, targetDir, force: false });
-
-    expect(written).toHaveLength(1);
-    expect(skipped).toHaveLength(1);
-    expect(written[0]).toBe('AgentSkills/skills/design');
-    expect(skipped[0]).toBe('AgentSkills/skills/core');
-  });
-
-  it('copies an entry-point file to the dest path, not the source path', () => {
-    // Simulate an IDE entry-point: source lives inside the pack, dest is at project root.
-    const entryPointSkills = [
-      {
-        name: 'entry-point:claude',
-        description: 'Claude entry point',
-        path: 'AgentSkills/entry-points/CLAUDE.md',
-        dest: 'CLAUDE.md',
-      },
-    ];
-
-    // Create source file (a plain file, not a directory)
-    const srcDir = path.join(packDir, 'AgentSkills/entry-points');
-    mkdirSync(srcDir, { recursive: true });
-    writeFileSync(path.join(srcDir, 'CLAUDE.md'), '# Claude Entry Point');
-
-    const { written, skipped } = copySkills({ skills: entryPointSkills, packDir, targetDir, force: false });
-
-    // Should land at target root as CLAUDE.md, not inside AgentSkills/entry-points/
-    expect(written).toHaveLength(1);
-    expect(written[0]).toBe('CLAUDE.md');
-    expect(existsSync(path.join(targetDir, 'CLAUDE.md'))).toBe(true);
-    expect(existsSync(path.join(targetDir, 'AgentSkills/entry-points/CLAUDE.md'))).toBe(false);
-  });
-
-  it('skips an existing entry-point file without --force (uses dest path)', () => {
-    const entryPointSkills = [
-      {
-        name: 'entry-point:claude',
-        description: 'Claude entry point',
-        path: 'AgentSkills/entry-points/CLAUDE.md',
-        dest: 'CLAUDE.md',
-      },
-    ];
-
-    const srcDir = path.join(packDir, 'AgentSkills/entry-points');
-    mkdirSync(srcDir, { recursive: true });
-    writeFileSync(path.join(srcDir, 'CLAUDE.md'), 'new content');
-
-    // Pre-create destination
-    writeFileSync(path.join(targetDir, 'CLAUDE.md'), 'existing content');
-
-    const { written, skipped } = copySkills({ skills: entryPointSkills, packDir, targetDir, force: false });
-
-    expect(written).toHaveLength(0);
-    expect(skipped).toHaveLength(1);
-    expect(skipped[0]).toBe('CLAUDE.md');
-    // Existing content untouched
-    expect(readFileSync(path.join(targetDir, 'CLAUDE.md'), 'utf8')).toBe('existing content');
-  });
-});