@pratikpsl/agent-skills 0.4.0 → 0.6.0

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"}

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,37 +1,56 @@
 {
   "name": "@pratikpsl/agent-skills",
   "type": "module",
-  "version": "0.4.0",
-  "description": "CLI to scaffold and manage AI agent skills across projects",
+  "version": "0.6.0",
+  "description": "CLI to scaffold and manage AI agent skills across projects — like shadcn/ui, but for Cursor, Claude, Codex, Copilot, and more",
   "bin": {
-    "agent-skills": "bin/agent-skills.js"
+    "agent-skills": "dist/bin/agent-skills.js"
   },
   "files": [
-    "bin",
-    "src",
+    "dist",
+    "templates",
     "README.md",
     "LICENSE"
   ],
   "engines": {
     "node": ">=18"
   },
+  "keywords": [
+    "ai",
+    "agent-skills",
+    "cursor",
+    "claude",
+    "cli",
+    "scaffold",
+    "copilot",
+    "codex",
+    "dotnet",
+    "agents"
+  ],
+  "homepage": "https://github.com/pratiksinghlad/coding-skills-ai#readme",
+  "bugs": {
+    "url": "https://github.com/pratiksinghlad/coding-skills-ai/issues"
+  },
   "publishConfig": {
     "access": "public"
   },
-  "license": "MIT",
+  "license": "Apache-2.0",
   "repository": {
     "type": "git",
     "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/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/{src/templates → templates}/dotnet/manifest.json

@@ -1,6 +1,6 @@
 {
   "name": "@pratikpsl/agent-skills-dotnet",
-  "version": "0.4.0",
+  "version": "0.6.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');
-  });
-});

package/src/__tests__/list.test.js

@@ -1,49 +0,0 @@
-// src/__tests__/list.test.js
-// Integration-style test: verifies that list output matches manifest contents.
-// We don't spawn the CLI process — instead we call the underlying lib functions
-// that the list command uses, which is the behaviour that matters.
-
-import { describe, it, expect, beforeEach, afterEach } from 'vitest';
-import { mkdirSync, writeFileSync, rmSync } from 'fs';
-import path from 'path';
-import os from 'os';
-import { readManifest } from '../lib/manifest.js';
-
-function makeTempDir() {
-  const dir = path.join(os.tmpdir(), `agent-skills-list-test-${Date.now()}`);
-  mkdirSync(dir, { recursive: true });
-  return dir;
-}
-
-describe('list — manifest content matches output data', () => {
-  let tmpDir;
-
-  beforeEach(() => {
-    tmpDir = makeTempDir();
-  });
-
-  afterEach(() => {
-    rmSync(tmpDir, { recursive: true, force: true });
-  });
-
-  it('returns all skills declared in manifest', () => {
-    const manifest = {
-      name: '@pratikpsl/agent-skills-dotnet',
-      version: '0.1.0',
-      skills: [
-        { name: 'core', description: 'Core principles', path: 'AgentSkills/skills/core' },
-        { name: 'design', description: 'Design principles', path: 'AgentSkills/skills/design' },
-        { name: 'dotnet-api', description: '.NET API rules', path: 'AgentSkills/skills/dotnet-api' },
-      ],
-    };
-    writeFileSync(path.join(tmpDir, 'manifest.json'), JSON.stringify(manifest));
-
-    const result = readManifest(tmpDir);
-
-    // The list command renders result.skills — verify the data is identical.
-    expect(result.skills.map((s) => s.name)).toEqual(['core', 'design', 'dotnet-api']);
-    expect(result.skills.every((s) => typeof s.description === 'string')).toBe(true);
-    expect(result.name).toBe(manifest.name);
-    expect(result.version).toBe(manifest.version);
-  });
-});