@pratikpsl/agent-skills 0.6.0 → 0.7.0

package/dist/core/manifest.js

@@ -1,26 +1,127 @@
 // 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";
+// Reads and validates a pack's manifest.json, or auto-discovers skills from disk
+// when manifest.json is not present.
+import { readFileSync, existsSync, readdirSync } from "fs";
 import path from "path";
-/**
- * Reads and validates the manifest.json for a pack.
- *
- * @throws When manifest is missing, unreadable, or structurally invalid.
- */
+import { IDE_ENTRY_POINT_MAP } from "./ide-map.js";
+const DEFAULT_DESCRIPTIONS = {
+    OPERATING: "Shared operating contract: bootstrap sequence, working rules, completion gate for all agents.",
+    agents: "Agent persona definitions: architect (design/CQRS) and developer (.NET C# implementation).",
+    memory: "Persistent agent memory: domain lesson files and memory schema for learning loops.",
+    instructions: "Canonical single-file coding agent instructions (Goal, Principles, Definition of Done).",
+};
+const IDE_DESTINATIONS = {
+    "entry-point:claude": "CLAUDE.md",
+    "entry-point:codex": "AGENTS.md",
+    "entry-point:copilot": ".github/copilot-instructions.md",
+    "entry-point:cursor": ".cursor/rules/instructions.md",
+    "entry-point:antigravity": ".agents/GEMINI.md",
+    "entry-point:windsurf": ".windsurfrules",
+    "entry-point:cline": ".clinerules",
+    "entry-point:aider": "CONVENTIONS.md",
+};
+function parseSkillDescription(skillDir, skillName) {
+    const skillFile = path.join(skillDir, "SKILL.md");
+    if (existsSync(skillFile)) {
+        try {
+            const raw = readFileSync(skillFile, "utf8");
+            const match = raw.match(/^description:\s*(?:>|\|)?\s*\n?([^\n\r]+)/m);
+            if (match && match[1]) {
+                return match[1].trim();
+            }
+        }
+        catch {
+            // ignore
+        }
+    }
+    return DEFAULT_DESCRIPTIONS[skillName] ?? `Skill definition for ${skillName}.`;
+}
+function discoverIdeEntryPoints(entryPointSrc) {
+    const skills = [];
+    for (const [ide, skillName] of Object.entries(IDE_ENTRY_POINT_MAP)) {
+        skills.push({
+            name: skillName,
+            description: `Lightweight ${ide} entry point.`,
+            path: entryPointSrc,
+            dest: IDE_DESTINATIONS[skillName],
+        });
+    }
+    return skills;
+}
+function discoverAgentSkills(packDir) {
+    const skills = [];
+    const agentSkillsDir = path.join(packDir, "AgentSkills");
+    if (existsSync(path.join(agentSkillsDir, "OPERATING.md"))) {
+        skills.push({
+            name: "OPERATING",
+            description: DEFAULT_DESCRIPTIONS.OPERATING,
+            path: "AgentSkills/OPERATING.md",
+        });
+    }
+    const skillsSubdir = path.join(agentSkillsDir, "skills");
+    if (existsSync(skillsSubdir)) {
+        const entries = readdirSync(skillsSubdir, { withFileTypes: true });
+        for (const entry of entries) {
+            if (entry.isDirectory()) {
+                const fullSkillDir = path.join(skillsSubdir, entry.name);
+                skills.push({
+                    name: entry.name,
+                    description: parseSkillDescription(fullSkillDir, entry.name),
+                    path: `AgentSkills/skills/${entry.name}`,
+                });
+            }
+        }
+    }
+    for (const item of ["agents", "memory"]) {
+        if (existsSync(path.join(agentSkillsDir, item))) {
+            skills.push({
+                name: item,
+                description: DEFAULT_DESCRIPTIONS[item] ?? `${item} definitions.`,
+                path: `AgentSkills/${item}`,
+            });
+        }
+    }
+    const epFile = path.join(agentSkillsDir, "entry-points", "entry-point.md");
+    if (existsSync(epFile)) {
+        skills.push(...discoverIdeEntryPoints("AgentSkills/entry-points/entry-point.md"));
+    }
+    return skills;
+}
+export function discoverSkills(packDir) {
+    if (existsSync(path.join(packDir, "AgentSkills"))) {
+        return discoverAgentSkills(packDir);
+    }
+    if (existsSync(path.join(packDir, "instructions.md"))) {
+        return [
+            {
+                name: "instructions",
+                description: DEFAULT_DESCRIPTIONS.instructions,
+                path: "instructions.md",
+                dest: "AGENTS.md",
+            },
+            ...discoverIdeEntryPoints("instructions.md"),
+        ];
+    }
+    throw new Error(`No recognized skills or instructions found in "${packDir}".`);
+}
 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.`);
+    const localManifestPath = path.join(packDir, "manifest.json");
+    const sharedManifestPath = path.join(packDir, "..", "shared", "manifest.json");
+    const targetPath = existsSync(localManifestPath)
+        ? localManifestPath
+        : existsSync(sharedManifestPath) && existsSync(path.join(packDir, "instructions.md"))
+            ? sharedManifestPath
+            : undefined;
+    if (!targetPath) {
+        return {
+            name: "@pratikpsl/agent-skills",
+            version: "0.7.0",
+            skills: discoverSkills(packDir),
+        };
     }
     let raw;
     try {
-        raw = readFileSync(manifestPath, "utf8");
-        // Strip UTF-8 BOM if present.
+        raw = readFileSync(targetPath, "utf8");
         if (raw.charCodeAt(0) === 0xfeff) {
             raw = raw.slice(1);
         }
@@ -35,15 +136,11 @@ export function readManifest(packDir) {
     }
     catch (err) {
         const message = err instanceof Error ? err.message : String(err);
-        throw new Error(`manifest.json at "${manifestPath}" is not valid JSON: ${message}`);
+        throw new Error(`manifest.json at "${targetPath}" is not valid JSON: ${message}`);
     }
-    validateManifest(manifest, manifestPath);
+    validateManifest(manifest, targetPath);
     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.`);
@@ -65,7 +162,6 @@ function validateManifest(manifest, filePath) {
                 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.`);

package/dist/core/manifest.js.map

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

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

@@ -1 +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"}
+{"version":3,"file":"resolve-pack.d.ts","sourceRoot":"","sources":["../../src/core/resolve-pack.ts"],"names":[],"mappings":"AAuCA;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CA+BpD"}

package/dist/core/resolve-pack.js

@@ -13,6 +13,25 @@ const PACK_ALIASES = {
     dotnet: "dotnet",
     "skills-dotnet": "dotnet",
     "@pratikpsl/agent-skills-dotnet": "dotnet",
+    default: "default",
+    instructions: "default",
+    "skills-instructions": "default",
+    "@pratikpsl/agent-skills": "default",
+    "@pratikpsl/agent-skills-default": "default",
+    "@pratikpsl/agent-skills-instructions": "default",
+    "single-file": "default",
+    universal: "default",
+    "skills-universal": "default",
+    "@pratikpsl/agent-skills-universal": "default",
+    core: "default",
+    "skills-core": "default",
+    "@pratikpsl/agent-skills-core": "default",
+    standard: "default",
+    "skills-standard": "default",
+    "@pratikpsl/agent-skills-standard": "default",
+    base: "default",
+    "skills-base": "default",
+    "@pratikpsl/agent-skills-base": "default",
 };
 /**
  * Resolves a pack name or alias to its installed directory.
@@ -29,10 +48,12 @@ export function resolvePack(packName) {
     // the compiled dist/, so three levels is correct.
     const templateDir = path.resolve(__dirname, "..", "..", "templates", normalized);
     if (existsSync(templateDir) &&
-        existsSync(path.join(templateDir, "manifest.json"))) {
+        (existsSync(path.join(templateDir, "manifest.json")) ||
+            existsSync(path.join(templateDir, "AgentSkills")) ||
+            existsSync(path.join(templateDir, "instructions.md")))) {
         return templateDir;
     }
     throw new Error(`Pack "${packName}" (mapped to "${normalized}") is not bundled with this version of the CLI. ` +
-        `Currently available packs: dotnet`);
+        `Currently available packs: default, dotnet`);
 }
 //# sourceMappingURL=resolve-pack.js.map

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

@@ -1 +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"}
+{"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,OAAO,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;IAC1C,OAAO,EAAE,SAAS;IAClB,YAAY,EAAE,SAAS;IACvB,qBAAqB,EAAE,SAAS;IAChC,yBAAyB,EAAE,SAAS;IACpC,iCAAiC,EAAE,SAAS;IAC5C,sCAAsC,EAAE,SAAS;IACjD,aAAa,EAAE,SAAS;IACxB,SAAS,EAAE,SAAS;IACpB,kBAAkB,EAAE,SAAS;IAC7B,mCAAmC,EAAE,SAAS;IAC9C,IAAI,EAAE,SAAS;IACf,aAAa,EAAE,SAAS;IACxB,8BAA8B,EAAE,SAAS;IACzC,QAAQ,EAAE,SAAS;IACnB,iBAAiB,EAAE,SAAS;IAC5B,kCAAkC,EAAE,SAAS;IAC7C,IAAI,EAAE,SAAS;IACf,aAAa,EAAE,SAAS;IACxB,8BAA8B,EAAE,SAAS;CAC1C,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,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,eAAe,CAAC,CAAC;YAClD,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;YACjD,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,iBAAiB,CAAC,CAAC,CAAC,EACxD,CAAC;QACD,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,MAAM,IAAI,KAAK,CACb,SAAS,QAAQ,iBAAiB,UAAU,kDAAkD;QAC5F,4CAA4C,CAC/C,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@pratikpsl/agent-skills",
   "type": "module",
-  "version": "0.6.0",
+  "version": "0.7.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": "dist/bin/agent-skills.js"
@@ -25,7 +25,9 @@
     "copilot",
     "codex",
     "dotnet",
-    "agents"
+    "agents",
+    "antigravity",
+    "typescript"
   ],
   "homepage": "https://github.com/pratiksinghlad/coding-skills-ai#readme",
   "bugs": {
@@ -46,11 +48,11 @@
     "dry-run": "npm run build && npm publish --dry-run"
   },
   "dependencies": {
-    "commander": "^12.0.0"
+    "commander": "^15.0.0"
   },
   "devDependencies": {
-    "@types/node": "^22.15.33",
-    "typescript": "^5.8.3",
-    "vitest": "^3.0.0"
+    "@types/node": "^26.4.0",
+    "typescript": "^7.0.2",
+    "vitest": "^4.1.11"
   }
 }

package/templates/default/instructions.md

@@ -0,0 +1,34 @@
+# Agent Instructions
+
+## Goal
+Implement the requested change with production-quality code, preserving existing behavior and
+minimizing the diff, following the project's own architecture and conventions - unless explicitly
+told otherwise.
+
+## Principles
+- Match existing code style, patterns, naming, architecture, and folder structure.
+- Prefer simple, clean, clear, efficient, maintainable, manageable code over clever or complex solutions.
+- Make the smallest change that satisfies the request; don't touch unrelated code.
+- Favor deletion over addition - don't grow the codebase for changes that don't need it.
+- Reuse existing utilities/helpers/components before writing new ones.
+- No new dependencies unless necessary. If one is needed: popular, actively maintained,
+  permissively licensed (MIT/Apache-2.0), no known security issues.
+- Apply SOLID, DRY, KISS. Single-responsibility functions/classes, Separation of concern. No duplicated logic.
+- No magic numbers/strings - use named constants/enums.
+- Each function must be a maximum of 50 lines.
+- Use meaningful names for classes, methods, variables, and all other code.
+- Handle errors the way the codebase already does.
+- Never hardcode secrets, keys, or credentials; follow the project's existing security practices.
+- Use idiomatic async/non-blocking I/O and ensure the code is free of race conditions and deadlocks.
+- Avoid deprecated APIs and patterns.
+- Comment only where intent isn't obvious from the code itself.
+- Don't change public APIs/interfaces, formatting, or file layout unless the task requires it.
+- Don't add features, abstractions, or "improvements" that weren't asked for.
+- If a requirement is ambiguous or missing critical detail, ask before guessing.
+
+## Definition of Done
+- Builds and runs without errors.
+- No debug code, dead code, unused imports, or temp files left behind.
+- Tests pass; add/update tests for the change if the project has a test suite.
+- The change is minimal, focused, and easy to review.
+

package/templates/dotnet/AgentSkills/entry-points/{copilot-instructions.md → entry-point.md}

@@ -1,6 +1,4 @@
-# Copilot Entry Point
-
-This file is a lightweight entry point for GitHub Copilot.
+# Agent Entry Point
 
 `AgentSkills/` is the single source of truth for skills, agents, memory,
 prerequisites, checklists, and project rules used by all coding agents and
@@ -48,3 +46,4 @@ Before marking any code-changing task complete:
 
 3. Do not claim completion when required checks fail. List failures clearly and
    leave the work in a reviewable state.
+

package/templates/shared/manifest.json

@@ -0,0 +1,62 @@
+{
+  "name": "@pratikpsl/agent-skills",
+  "version": "0.7.0",
+  "description": "Universal single-file AI agent instructions for all programming languages, OSes, and IDEs (Cursor, Claude, Copilot, Codex, Antigravity, Windsurf, Cline, Aider).",
+  "skills": [
+    {
+      "name": "instructions",
+      "description": "Canonical single-file coding agent instructions (Goal, Principles, Definition of Done).",
+      "path": "instructions.md",
+      "dest": "AGENTS.md"
+    },
+    {
+      "name": "entry-point:codex",
+      "description": "Universal Codex/OpenAI agent entry point.",
+      "path": "instructions.md",
+      "dest": "AGENTS.md"
+    },
+    {
+      "name": "entry-point:claude",
+      "description": "Claude Code / Anthropic entry point.",
+      "path": "instructions.md",
+      "dest": "CLAUDE.md"
+    },
+    {
+      "name": "entry-point:copilot",
+      "description": "GitHub Copilot custom instructions entry point.",
+      "path": "instructions.md",
+      "dest": ".github/copilot-instructions.md"
+    },
+    {
+      "name": "entry-point:cursor",
+      "description": "Cursor IDE project rules entry point.",
+      "path": "instructions.md",
+      "dest": ".cursor/rules/instructions.md"
+    },
+    {
+      "name": "entry-point:antigravity",
+      "description": "Antigravity (Google DeepMind) / Gemini rules entry point.",
+      "path": "instructions.md",
+      "dest": ".agents/GEMINI.md"
+    },
+    {
+      "name": "entry-point:windsurf",
+      "description": "Windsurf / Codeium rules entry point.",
+      "path": "instructions.md",
+      "dest": ".windsurfrules"
+    },
+    {
+      "name": "entry-point:cline",
+      "description": "Cline / Roo Code rules entry point.",
+      "path": "instructions.md",
+      "dest": ".clinerules"
+    },
+    {
+      "name": "entry-point:aider",
+      "description": "Aider conventions entry point.",
+      "path": "instructions.md",
+      "dest": "CONVENTIONS.md"
+    }
+  ]
+}
+

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

@@ -1,50 +0,0 @@
-# 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

@@ -1,50 +0,0 @@
-# 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

@@ -1,50 +0,0 @@
-# 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/cursor-instructions.md

@@ -1,50 +0,0 @@
-# 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.