npm - @pratikpsl/agent-skills - Versions diffs - 1.0.0 → 1.2.0 - Mend

@pratikpsl/agent-skills 1.0.0 → 1.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (24) hide show

package/README.md CHANGED Viewed

@@ -1,6 +1,6 @@
 # @pratikpsl/agent-skills
-> Scaffold and manage AI agent skills across any project — for Cursor, Claude, Codex, Copilot, Antigravity, Windsurf, and Cline.
+> Scaffold and manage AI agent skills across any project — for Cursor, Claude, Codex, Copilot, Antigravity, and Cline.
 `@pratikpsl/agent-skills` is a single npm package: a TypeScript CLI plus bundled templates under `templates/`. No runtime network fetch — templates ship inside the package, so setup works offline after install.
@@ -10,22 +10,31 @@
 From any project root (Node 18+ or Bun):
-### Default: Single-File Instructions (Cross-OS Hardlinked)
+### Shared Agent Skills (Universal Skills & Personas)
-Running with **no arguments** automatically scaffolds universal single-file agent instructions across all IDEs using cross-OS hardlinks:
+Running with an **agent name** or `shared` automatically installs shared skills (`AgentSkills/skills/review`, `AgentSkills/skills/principles`, `AgentSkills/skills/standards`, `AgentSkills/skills/security`), agent personas (`AgentSkills/agents/architect.md`, `AgentSkills/agents/reviewer.md`), and the agent's entry point:
 ```bash
-# Installs instructions across all IDEs with cross-OS hardlinks by default
-npx @pratikpsl/agent-skills
-# Or install for a specific IDE / Agent directly
-npx @pratikpsl/agent-skills cursor      # → .cursor/rules/instructions.md
-npx @pratikpsl/agent-skills claude      # → CLAUDE.md
-npx @pratikpsl/agent-skills codex       # → AGENTS.md
-npx @pratikpsl/agent-skills copilot     # → .github/copilot-instructions.md
-npx @pratikpsl/agent-skills antigravity # → .agents/GEMINI.md
-npx @pratikpsl/agent-skills windsurf    # → .windsurfrules
-npx @pratikpsl/agent-skills cline       # → .clinerules
+# Install shared skills + specific IDE / Agent entry point
+npx @pratikpsl/agent-skills antigravity # → .agents/rules/GEMINI.md + AgentSkills/
+npx @pratikpsl/agent-skills cursor      # → .cursor/rules/instructions.md + AgentSkills/
+npx @pratikpsl/agent-skills claude      # → CLAUDE.md + AgentSkills/
+npx @pratikpsl/agent-skills code        # → AGENTS.md + AgentSkills/
+npx @pratikpsl/agent-skills codex       # → AGENTS.md + AgentSkills/
+npx @pratikpsl/agent-skills copilot     # → .github/copilot-instructions.md + AgentSkills/
+npx @pratikpsl/agent-skills cline       # → .clinerules + AgentSkills/
+# Install shared skills across all IDE entry points
+npx @pratikpsl/agent-skills shared
+```
+### Compact Single-File Instructions
+To scaffold compact single-file agent instructions without the `AgentSkills/` folder:
+```bash
+npx @pratikpsl/agent-skills default
+npx @pratikpsl/agent-skills default --agent antigravity
 ```
 ### .NET / C# Template
@@ -35,7 +44,7 @@ npx @pratikpsl/agent-skills cline       # → .clinerules
 npx @pratikpsl/agent-skills dotnet
 # Install .NET agent skills + specific agent entry point only
-npx @pratikpsl/agent-skills dotnet --agent codex
+npx @pratikpsl/agent-skills dotnet --agent code
 npx @pratikpsl/agent-skills dotnet --agent cursor
 ```
@@ -60,13 +69,14 @@ npx @pratikpsl/agent-skills react --agent claude
 Usage: agent-skills [options] [template]
 Arguments:
-  template              Template: default, dotnet, react; agent names install default guidance
+  template              Template: default, dotnet, react, shared; agent names install shared guidance
 Options:
   -V, --version         output the version number
-  --agent <name>        Install one agent entry point: antigravity, claude, cline, codex, copilot, cursor, windsurf
+  --agent <name>        Install one agent entry point: antigravity, claude, cline, code, codex, copilot, cursor
   --force               Overwrite installed files (default: false)
-  --no-hardlink         Copy agent entry points instead of hardlinking
+  --hardlink            Hardlink matching entry points (default: true)
+  --no-hardlink         Do not hardlink matching entry points
   --path <dir>          Target project root (default: current working directory)
   -h, --help            display help for command
 ```
@@ -77,10 +87,10 @@ Options:
 | Template | Path | Description |
 | --- | --- | --- |
-| `default` | `templates/default/` | Universal single-file agent instructions, cross-OS hardlinked |
-| `dotnet` | `templates/dotnet/` | .NET/C# skills, architecture & developer agents, memory |
-| `react` | `templates/react/` | React & TypeScript skills, frontend testing, developer agent |
-| `shared` | `templates/shared/` | Base operating contract, core skills (standards, security), review agents |
+| `shared` | `templates/shared/` | Base operating contract, core skills (principles, standards, security, review), review & architecture agents (`architect.md`, `reviewer.md`) |
+| `dotnet` | `templates/dotnet/` | .NET/C# skills, architecture & developer agents (`architect.md`, `developer.md`), memory |
+| `react` | `templates/react/` | React & TypeScript skills, frontend testing, developer agent (`developer.md`) |
+| `default` | `templates/default/` | Compact single-file agent instructions without AgentSkills folder |
 ---

package/dist/cli/index.js CHANGED Viewed

@@ -11,7 +11,7 @@ function runInstall(template, options) {
     if (implicitAgent && options.agent) {
         throw new Error("Choose an agent with either the argument or --agent, not both.");
     }
-    const selectedTemplate = implicitAgent ? "default" : template ?? "default";
+    const selectedTemplate = implicitAgent ? "shared" : template ?? "shared";
     const agent = implicitAgent ?? parseAgentName(options.agent);
     const targetDir = options.path;
     const hardlink = options.hardlink ?? true;
@@ -37,10 +37,11 @@ program
     .name("agent-skills")
     .description("Install shared coding-agent guidance and a framework template")
     .version(version)
-    .argument("[template]", `Template: ${TEMPLATE_NAMES.join(", ")}; agent names install default guidance`)
+    .argument("[template]", `Template: ${TEMPLATE_NAMES.join(", ")}; agent names install shared guidance`)
     .option("--agent <name>", `Install one agent entry point: ${AGENT_NAMES.join(", ")}`)
     .option("--force", "Overwrite installed files", false)
-    .option("--no-hardlink", "Copy agent entry points instead of hardlinking")
+    .option("--hardlink", "Hardlink matching entry points", true)
+    .option("--no-hardlink", "Do not hardlink matching entry points")
     .option("--path <dir>", "Target project root", process.cwd())
     .action((template, options) => runInstall(template, options));
 program.parseAsync(process.argv).catch((error) => {

package/dist/cli/index.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AACvC,OAAO,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AACtF,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAErG,MAAM,OAAO,GAAG,aAAa,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,oBAAoB,CAAwB,CAAC;AASzE,SAAS,UAAU,CAAC,QAA4B,EAAE,OAAmB;IACnE,MAAM,OAAO,GAAG,QAAQ,IAAI,WAAW,CAAC,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC;IACzE,MAAM,aAAa,GAAG,OAAO,CAAC,CAAC,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAErE,IAAI,aAAa,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QACnC,MAAM,IAAI,KAAK,CAAC,gEAAgE,CAAC,CAAC;IACpF,CAAC;IAED,MAAM,gBAAgB,GAAG,aAAa,CAAC,CAAC,CAAC,~~SAAS~~,CAAC,CAAC,CAAC,QAAQ,IAAI,~~SAAS~~,CAAC;~~IAC3E~~,MAAM,KAAK,GAAG,aAAa,IAAI,cAAc,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAC7D,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAC/B,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,IAAI,CAAC;IAE1C,MAAM,MAAM,GACV,gBAAgB,KAAK,SAAS;QAC5B,CAAC,CAAC,sBAAsB,CAAC,eAAe,CAAC,gBAAgB,CAAC,EAAE;YACxD,KAAK;YACL,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,QAAQ;YACR,SAAS;SACV,CAAC;QACJ,CAAC,CAAC,eAAe,CAAC;YACd,KAAK;YACL,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,QAAQ;YACR,SAAS,EAAE,qBAAqB,EAAE;YAClC,SAAS;YACT,WAAW,EAAE,eAAe,CAAC,gBAAgB,CAAC;SAC/C,CAAC,CAAC;IAET,OAAO,CAAC,GAAG,CAAC,aAAa,gBAAgB,KAAK,MAAM,CAAC,OAAO,CAAC,MAAM,aAAa,MAAM,CAAC,OAAO,CAAC,MAAM,WAAW,CAAC,CAAC;AACpH,CAAC;AAED,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,cAAc,CAAC;KACpB,WAAW,CAAC,+DAA+D,CAAC;KAC5E,OAAO,CAAC,OAAO,CAAC;KAChB,QAAQ,CAAC,YAAY,EAAE,aAAa,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,~~wCAAwC~~,CAAC;~~KACtG~~,MAAM,CAAC,gBAAgB,EAAE,kCAAkC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;KACpF,MAAM,CAAC,SAAS,EAAE,2BAA2B,EAAE,KAAK,CAAC;KACrD,MAAM,CAAC,eAAe,EAAE,~~gDAAgD~~,CAAC;~~KACzE~~,MAAM,CAAC,cAAc,EAAE,qBAAqB,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC;KAC5D,MAAM,CAAC,CAAC,QAA4B,EAAE,OAAmB,EAAE,EAAE,CAAC,UAAU,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;AAEhG,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IACxD,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,OAAO,CAAC,KAAK,CAAC,UAAU,OAAO,EAAE,CAAC,CAAC;IACnC,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC,CAAC,CAAC"}
1	+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"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"}

package/dist/core/ide-map.js CHANGED Viewed

@@ -1,11 +1,11 @@
 export const IDE_ENTRY_POINTS = {
-    antigravity: ".agents/GEMINI.md",
+    antigravity: ".agents/rules/GEMINI.md",
     claude: "CLAUDE.md",
     cline: ".clinerules",
+    code: "AGENTS.md",
     codex: "AGENTS.md",
     copilot: ".github/copilot-instructions.md",
     cursor: ".cursor/rules/instructions.md",
-    windsurf: ".windsurfrules",
 };
 export const AGENT_NAMES = Object.keys(IDE_ENTRY_POINTS);
 export function parseAgentName(value) {

package/dist/core/ide-map.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"ide-map.js","sourceRoot":"","sources":["../../src/core/ide-map.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,gBAAgB,GAA2B;IACtD,WAAW,EAAE,~~mBAAmB~~;~~IAChC~~,MAAM,EAAE,WAAW;IACnB,KAAK,EAAE,aAAa;IACpB,KAAK,EAAE,WAAW;IAClB,OAAO,EAAE,iCAAiC;IAC1C,MAAM,EAAE,+BAA+B;~~IACvC~~,~~QAAQ,EAAE,gBAAgB;CAC3B,~~CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;AAEzD,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAC7B,MAAM,KAAK,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;IAClC,IAAI,KAAK,IAAI,gBAAgB;QAAE,OAAO,KAAK,CAAC;IAC5C,MAAM,IAAI,KAAK,CAAC,kBAAkB,KAAK,cAAc,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClF,CAAC"}
1	+ {"version":3,"file":"ide-map.js","sourceRoot":"","sources":["../../src/core/ide-map.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,gBAAgB,GAA2B;IACtD,WAAW,EAAE,yBAAyB;IACtC,MAAM,EAAE,WAAW;IACnB,KAAK,EAAE,aAAa;IACpB,IAAI,EAAE,WAAW;IACjB,KAAK,EAAE,WAAW;IAClB,OAAO,EAAE,iCAAiC;IAC1C,MAAM,EAAE,+BAA+B;CACxC,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;AAEzD,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAC7B,MAAM,KAAK,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;IAClC,IAAI,KAAK,IAAI,gBAAgB;QAAE,OAAO,KAAK,CAAC;IAC5C,MAAM,IAAI,KAAK,CAAC,kBAAkB,KAAK,cAAc,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClF,CAAC"}

package/dist/core/install-template.d.ts CHANGED Viewed

@@ -5,7 +5,7 @@ export interface InstallResult {
 export interface InstallOptions {
     agent?: string;
     force: boolean;
-    hardlink: boolean;
+    hardlink?: boolean;
     targetDir: string;
     sharedDir: string;
     templateDir: string;
@@ -13,7 +13,7 @@ export interface InstallOptions {
 export interface InstallDefaultOptions {
     agent?: string;
     force: boolean;
-    hardlink: boolean;
+    hardlink?: boolean;
     targetDir: string;
 }
 export declare function installTemplate(options: InstallOptions): InstallResult;

package/dist/core/install-template.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"install-template.d.ts","sourceRoot":"","sources":["../../src/core/install-template.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;~~IAClB~~,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;~~IAClB~~,SAAS,EAAE,MAAM,CAAC;CACnB;~~AAkID~~,wBAAgB,eAAe,CAAC,OAAO,EAAE,cAAc,GAAG,aAAa,~~CAiBtE~~;AAED,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,qBAAqB,GAC7B,aAAa,CAUf"}
1	+ {"version":3,"file":"install-template.d.ts","sourceRoot":"","sources":["../../src/core/install-template.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AA6OD,wBAAgB,eAAe,CAAC,OAAO,EAAE,cAAc,GAAG,aAAa,CA0BtE;AAED,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,qBAAqB,GAC7B,aAAa,CAUf"}

package/dist/core/install-template.js CHANGED Viewed

@@ -1,6 +1,33 @@
-import { copyFileSync, existsSync, linkSync, mkdirSync, readdirSync, rmSync } from "fs";
+import fs, { copyFileSync, existsSync, mkdirSync, readFileSync, readdirSync, rmSync, writeFileSync } from "fs";
 import path from "path";
 import { IDE_ENTRY_POINTS } from "./ide-map.js";
+const UTF8_ENCODING = "utf8";
+const AGENTS_FILENAME = "AGENTS.md";
+const DEFAULT_RELATIVE_PREFIX = "./";
+const PARENT_DIR_PREFIX = "../";
+const AGENT_SKILLS_DIR = "AgentSkills/";
+const ANTIGRAVITY_TARGET = ".agents/rules/GEMINI.md";
+const CURSOR_TARGET = ".cursor/rules/instructions.md";
+const ANTIGRAVITY_FRONTMATTER = `---
+trigger: always_on
+---
+---
+name: core-entry-point
+description: >
+  Load on every task. Universal guidelines, standards, and verification rules.
+---
+`;
+const CURSOR_FRONTMATTER = `---
+description: Universal agent instructions and standards
+globs: *
+alwaysApply: true
+---
+`;
 function relativePath(targetDir, filePath) {
     return path.relative(targetDir, filePath).replaceAll("\\", "/");
 }
@@ -33,7 +60,7 @@ function copyFile(source, destination, force, existingBeforeInstall) {
     copyFileSync(source, destination);
     return true;
 }
-function mergeDirectory(sourceDir, targetDir, projectDir, force, existingBeforeInstall, result) {
+function mergeDirectory(sourceDir, targetDir, context) {
     if (!existsSync(sourceDir))
         return;
     mkdirSync(targetDir, { recursive: true });
@@ -41,72 +68,126 @@ function mergeDirectory(sourceDir, targetDir, projectDir, force, existingBeforeI
         const source = path.join(sourceDir, entry.name);
         const target = path.join(targetDir, entry.name);
         if (entry.isDirectory()) {
-            mergeDirectory(source, target, projectDir, force, existingBeforeInstall, result);
+            mergeDirectory(source, target, context);
+            continue;
         }
-        else {
-            const rel = relativePath(projectDir, target);
-            if (copyFile(source, target, force, existingBeforeInstall)) {
-                if (!result.written.includes(rel)) {
-                    result.written.push(rel);
-                }
-            }
-            else {
-                if (!result.skipped.includes(rel)) {
-                    result.skipped.push(rel);
-                }
-            }
+        const rel = relativePath(context.projectDir, target);
+        const copied = copyFile(source, target, context.force, context.existingBeforeInstall);
+        const list = copied ? context.result.written : context.result.skipped;
+        if (!list.includes(rel)) {
+            list.push(rel);
         }
     }
 }
 function selectedEntryPoints(agent) {
-    return agent ? [IDE_ENTRY_POINTS[agent]] : Object.values(IDE_ENTRY_POINTS);
+    if (agent)
+        return [IDE_ENTRY_POINTS[agent]];
+    const all = Array.from(new Set(Object.values(IDE_ENTRY_POINTS)));
+    return all.sort((a, b) => (a === AGENTS_FILENAME ? -1 : b === AGENTS_FILENAME ? 1 : a.localeCompare(b)));
+}
+function getRelativePrefix(destination) {
+    const dir = path.dirname(destination).replaceAll("\\", "/");
+    if (dir === "." || dir === "")
+        return DEFAULT_RELATIVE_PREFIX;
+    const depth = dir.split("/").filter(Boolean).length;
+    return PARENT_DIR_PREFIX.repeat(depth);
+}
+function addAgentsLinkNote(content, prefix) {
+    if (content.includes(AGENTS_FILENAME))
+        return content;
+    const agentsLink = prefix === DEFAULT_RELATIVE_PREFIX ? `./${AGENTS_FILENAME}` : `${prefix}${AGENTS_FILENAME}`;
+    const note = `\n> Follow universal guidelines and standards in [${AGENTS_FILENAME}](${agentsLink}).\n`;
+    const headerMatch = content.match(/^# [^\n]+/m);
+    if (!headerMatch || headerMatch.index === undefined) {
+        return `${note}\n${content}`;
+    }
+    const insertPos = headerMatch.index + headerMatch[0].length;
+    return content.slice(0, insertPos) + note + content.slice(insertPos);
+}
+function formatEntryPoint(destination, content, hasAgentsMd) {
+    const prefix = getRelativePrefix(destination);
+    let adjusted = content;
+    if (prefix !== DEFAULT_RELATIVE_PREFIX) {
+        adjusted = adjusted.replaceAll(AGENT_SKILLS_DIR, `${prefix}${AGENT_SKILLS_DIR}`);
+    }
+    if (prefix !== DEFAULT_RELATIVE_PREFIX && hasAgentsMd) {
+        adjusted = addAgentsLinkNote(adjusted, prefix);
+    }
+    if (destination === ANTIGRAVITY_TARGET) {
+        adjusted = `${ANTIGRAVITY_FRONTMATTER}${adjusted}`;
+    }
+    else if (destination === CURSOR_TARGET) {
+        adjusted = `${CURSOR_FRONTMATTER}${adjusted}`;
+    }
+    return adjusted;
+}
+function tryHardlink(primaryPath, target) {
+    try {
+        fs.linkSync(primaryPath, target);
+        return true;
+    }
+    catch {
+        return false;
+    }
 }
-function linkOrCopy(source, target, primary, options, existingBeforeInstall) {
-    if (existingBeforeInstall.has(target) && !options.force) {
+function writeOrLinkEntryPoint(target, content, primaryPath, context) {
+    if (context.existingBeforeInstall.has(target) && !context.force) {
         return false;
     }
     if (existsSync(target)) {
         rmSync(target, { force: true, recursive: true });
     }
     mkdirSync(path.dirname(target), { recursive: true });
-    if (options.hardlink && primary) {
-        try {
-            linkSync(primary, target);
-            return true;
-        }
-        catch {
-            // Non-hardlink-compatible filesystems use copy fallback
-        }
+    const linked = context.hardlink && primaryPath && tryHardlink(primaryPath, target);
+    if (!linked) {
+        writeFileSync(target, content, UTF8_ENCODING);
     }
-    copyFileSync(source, target);
     return true;
 }
 function installEntryPoints(source, options, existingBeforeInstall, result) {
-    let primary;
-    for (const destination of selectedEntryPoints(options.agent)) {
+    const baseContent = readFileSync(source, UTF8_ENCODING);
+    const destinations = selectedEntryPoints(options.agent);
+    const agentsPath = path.join(options.targetDir, AGENTS_FILENAME);
+    const willHaveAgentsMd = destinations.includes(AGENTS_FILENAME) ||
+        existingBeforeInstall.has(agentsPath) ||
+        existsSync(agentsPath);
+    const writeContext = {
+        existingBeforeInstall,
+        force: options.force,
+        hardlink: options.hardlink ?? true,
+    };
+    const contentToPrimaryPath = new Map();
+    for (const destination of destinations) {
         const target = path.join(options.targetDir, destination);
         const rel = relativePath(options.targetDir, target);
-        if (linkOrCopy(source, target, primary, options, existingBeforeInstall)) {
-            primary ??= target;
-            if (!result.written.includes(rel)) {
-                result.written.push(rel);
-            }
+        const content = formatEntryPoint(destination, baseContent, willHaveAgentsMd);
+        const primaryPath = contentToPrimaryPath.get(content);
+        const written = writeOrLinkEntryPoint(target, content, primaryPath, writeContext);
+        const list = written ? result.written : result.skipped;
+        if (!list.includes(rel)) {
+            list.push(rel);
         }
-        else {
-            if (!result.skipped.includes(rel)) {
-                result.skipped.push(rel);
-            }
+        if (written && !contentToPrimaryPath.has(content)) {
+            contentToPrimaryPath.set(content, target);
         }
     }
 }
 export function installTemplate(options) {
     const result = { written: [], skipped: [] };
     const existing = collectExistingFiles(options.targetDir);
-    const sharedSkills = path.join(options.sharedDir, "AgentSkills");
-    const templateSkills = path.join(options.templateDir, "AgentSkills");
-    const targetSkills = path.join(options.targetDir, "AgentSkills");
-    mergeDirectory(sharedSkills, targetSkills, options.targetDir, options.force, existing, result);
-    mergeDirectory(templateSkills, targetSkills, options.targetDir, options.force, existing, result);
+    const mergeCtx = {
+        existingBeforeInstall: existing,
+        force: options.force,
+        projectDir: options.targetDir,
+        result,
+    };
+    const sharedSkills = path.join(options.sharedDir, AGENT_SKILLS_DIR);
+    const templateSkills = path.join(options.templateDir, AGENT_SKILLS_DIR);
+    const targetSkills = path.join(options.targetDir, AGENT_SKILLS_DIR);
+    mergeDirectory(sharedSkills, targetSkills, mergeCtx);
+    if (path.resolve(templateSkills) !== path.resolve(sharedSkills)) {
+        mergeDirectory(templateSkills, targetSkills, mergeCtx);
+    }
     installEntryPoints(path.join(options.sharedDir, "entry-points", "instructions.md"), options, existing, result);
     return result;
 }

package/dist/core/install-template.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"install-template.js","sourceRoot":"","sources":["../../src/core/install-template.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,~~QAAQ~~,EAAE,~~SAAS~~,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,IAAI,CAAC;~~AACxF~~,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;~~AAuBhD~~,SAAS,YAAY,CAAC,SAAiB,EAAE,QAAgB;IACvD,OAAO,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;AAClE,CAAC;AAED,SAAS,oBAAoB,CAAC,GAAW;IACvC,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAChC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IAEnC,SAAS,IAAI,CAAC,OAAe;QAC3B,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,OAAO,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;YAClE,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YAC5C,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;gBACxB,IAAI,CAAC,IAAI,CAAC,CAAC;YACb,CAAC;iBAAM,CAAC;gBACN,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAClB,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,QAAQ,CACf,MAAc,EACd,WAAmB,EACnB,KAAc,EACd,qBAAkC;IAElC,IAAI,qBAAqB,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;QACrD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAC5B,MAAM,CAAC,WAAW,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACxD,CAAC;IACD,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1D,YAAY,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAClC,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,cAAc,CACrB,SAAiB,EACjB,SAAiB,EACjB,~~UAAkB,EAClB,KAAc,EACd,qBAAkC,EAClC,MAAqB~~;IAErB,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC;QAAE,OAAO;IACnC,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE1C,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,SAAS,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;QACpE,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAChD,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAEhD,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,~~UAAU~~,~~EAAE,KAAK,EAAE,qBAAqB,EAAE,MAAM,~~CAAC,CAAC;~~QACnF~~,~~CAAC~~;~~aAAM~~,CAAC;~~YACN~~,MAAM,GAAG,GAAG,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;~~YAC7C~~,~~IAAI~~,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,~~qBAAqB~~,CAAC,~~EAAE~~,CAAC;~~gBAC3D~~,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;~~oBAClC~~,~~MAAM~~,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC~~;gBAC3B~~,CAAC;~~YACH~~,CAAC;~~iBAAM~~,CAAC;~~gBACN~~,~~IAAI~~,CAAC,MAAM,CAAC,OAAO,CAAC,~~QAAQ~~,CAAC,GAAG,CAAC,EAAE,CAAC;~~oBAClC~~,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;~~gBAC3B~~,CAAC;~~YACH~~,CAAC;~~QACH~~,CAAC;~~IACH~~,CAAC;~~AACH~~,CAAC;~~AAED~~,SAAS,~~mBAAmB~~,CAAC,~~KAAc~~;~~IACzC~~,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,~~gBAAgB~~,CAAC,CAAC;~~AAC7E~~,CAAC;AAED,SAAS,~~UAAU~~,~~CACjB~~,MAAc,~~EACd~~,MAAc,EACd,~~OAA2B~~,~~EAC3B~~,~~OAA8C~~,~~EAC9C~~,~~qBAAkC~~;~~IAElC~~,IAAI,qBAAqB,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;~~QACxD~~,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QACvB,MAAM,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACnD,CAAC;IACD,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAErD,~~IAAI~~,OAAO,CAAC,QAAQ,IAAI,~~OAAO~~,EAAE,CAAC;~~QAChC~~,IAAI,CAAC;~~YACH~~,~~QAAQ~~,CAAC,OAAO,EAAE,~~MAAM~~,CAAC,CAAC;~~YAC1B~~,OAAO,IAAI,CAAC;~~QACd~~,CAAC;~~QAAC~~,MAAM,CAAC~~;YACP~~,~~wDAAwD;QAC1D~~,CAAC~~;IACH~~,CAAC;~~IAED~~,YAAY,CAAC,~~MAAM~~,~~EAAE~~,~~MAAM~~,CAAC,CAAC;~~IAC7B~~,~~OAAO~~,IAAI,CAAC~~;AACd~~,CAAC~~;AAED~~,SAAS,~~kBAAkB~~,~~CACzB~~,~~MAAc~~,~~EACd~~,~~OAAiF~~,~~EACjF~~,~~qBAAkC~~,~~EAClC~~,~~MAAqB~~;~~IAErB~~,~~IAAI~~,~~OAA2B~~,CAAC;~~IAEhC~~,~~KAAK~~,MAAM,~~WAAW~~,~~IAAI~~,~~mBAAmB~~,~~CAAC~~,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;~~QAC7D~~,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;QACzD,MAAM,GAAG,GAAG,YAAY,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QACpD,~~IAAI~~,~~UAAU~~,CAAC,~~MAAM~~,EAAE,~~MAAM~~,EAAE,~~OAAO~~,~~EAAE~~,~~OAAO~~,~~EAAE~~,~~qBAAqB~~,CAAC,~~EAAE~~,CAAC;~~YACxE~~,OAAO,~~KAAK~~,MAAM,CAAC;~~YACnB~~,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,~~QAAQ~~,CAAC,~~GAAG~~,CAAC,~~EAAE~~,CAAC;~~gBAClC~~,~~MAAM~~,CAAC,~~OAAO~~,CAAC,~~IAAI~~,CAAC,GAAG,CAAC,CAAC;~~YAC3B~~,CAAC~~;QACH~~,CAAC;~~aAAM~~,CAAC;~~YACN~~,IAAI,~~CAAC~~,~~MAAM~~,CAAC,~~OAAO~~,CAAC,~~QAAQ~~,CAAC,~~GAAG~~,CAAC,EAAE,CAAC;~~gBAClC~~,~~MAAM~~,CAAC,~~OAAO~~,CAAC,~~IAAI~~,~~CAAC~~,~~GAAG~~,CAAC,CAAC;~~YAC3B~~,CAAC;~~QACH,CAAC;~~IACH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAAuB;IACrD,MAAM,MAAM,GAAkB,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IAC3D,MAAM,QAAQ,GAAG,oBAAoB,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACzD,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,~~aAAa~~,CAAC,CAAC;~~IACjE~~,MAAM,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,~~aAAa~~,CAAC,CAAC;~~IACrE~~,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,~~aAAa~~,CAAC,CAAC;~~IAEjE~~,cAAc,CAAC,YAAY,EAAE,YAAY,EAAE,~~OAAO~~,CAAC,~~SAAS~~,~~EAAE~~,~~OAAO~~,CAAC,~~KAAK~~,~~EAAE~~,~~QAAQ~~,~~EAAE~~,~~MAAM~~,~~CAAC~~,CAAC~~;IAC/F~~,~~cAAc~~,CAAC,~~cAAc~~,~~EAAE~~,~~YAAY,~~EAAE,~~OAAO,~~CAAC,~~SAAS~~,~~EAAE,OAAO,~~CAAC,~~KAAK~~,EAAE,~~QAAQ~~,EAAE,~~MAAM~~,CAAC,CAAC;~~IACjG~~,kBAAkB,CAChB,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,cAAc,EAAE,iBAAiB,CAAC,EAC/D,OAAO,EACP,QAAQ,EACR,MAAM,CACP,CAAC;IAEF,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,SAAiB,EACjB,OAA8B;IAE9B,MAAM,MAAM,GAAkB,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IAC3D,MAAM,QAAQ,GAAG,oBAAoB,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACzD,kBAAkB,CAChB,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,iBAAiB,CAAC,EACvC,OAAO,EACP,QAAQ,EACR,MAAM,CACP,CAAC;IACF,OAAO,MAAM,CAAC;AAChB,CAAC"}
1	+ {"version":3,"file":"install-template.js","sourceRoot":"","sources":["../../src/core/install-template.ts"],"names":[],"mappings":"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"}

package/dist/core/resolve-template.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"resolve-template.d.ts","sourceRoot":"","sources":["../../src/core/resolve-template.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,cAAc,~~UAAiC~~,CAAC;~~AAM7D~~,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAWpD"}
1	+ {"version":3,"file":"resolve-template.d.ts","sourceRoot":"","sources":["../../src/core/resolve-template.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,cAAc,UAA2C,CAAC;AAMvE,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAWpD"}

package/dist/core/resolve-template.js CHANGED Viewed

@@ -2,7 +2,7 @@ import { existsSync } from "fs";
 import path from "path";
 import { fileURLToPath } from "url";
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
-export const TEMPLATE_NAMES = ["default", "dotnet", "react"];
+export const TEMPLATE_NAMES = ["default", "dotnet", "react", "shared"];
 function templatesRoot() {
     return path.resolve(__dirname, "..", "..", "templates");
 }

package/dist/core/resolve-template.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"resolve-template.js","sourceRoot":"","sources":["../../src/core/resolve-template.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAChC,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAEpC,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAE/D,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,SAAS,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;~~AAE7D~~,SAAS,aAAa;IACpB,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,qBAAqB;IACnC,OAAO,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,EAAE,QAAQ,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACnC,MAAM,IAAI,KAAK,CAAC,qBAAqB,IAAI,cAAc,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACvF,CAAC;IAED,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,EAAE,IAAI,CAAC,CAAC;IACrD,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,aAAa,IAAI,qCAAqC,CAAC,CAAC;IAC1E,CAAC;IAED,OAAO,WAAW,CAAC;AACrB,CAAC"}
1	+ {"version":3,"file":"resolve-template.js","sourceRoot":"","sources":["../../src/core/resolve-template.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAChC,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAEpC,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAE/D,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;AAEvE,SAAS,aAAa;IACpB,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,qBAAqB;IACnC,OAAO,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,EAAE,QAAQ,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACnC,MAAM,IAAI,KAAK,CAAC,qBAAqB,IAAI,cAAc,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACvF,CAAC;IAED,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,EAAE,IAAI,CAAC,CAAC;IACrD,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,aAAa,IAAI,qCAAqC,CAAC,CAAC;IAC1E,CAAC;IAED,OAAO,WAAW,CAAC;AACrB,CAAC"}

package/package.json CHANGED Viewed

@@ -1,7 +1,7 @@
 {
   "name": "@pratikpsl/agent-skills",
   "type": "module",
-  "version": "1.0.0",
+  "version": "1.2.0",
   "description": "CLI to scaffold and manage AI agent skills across projects — like shadcn/ui, but for Cursor, Claude, Codex, Copilot, Antigravity, and more",
   "bin": {
     "agent-skills": "dist/bin/agent-skills.js"
@@ -47,7 +47,7 @@
     "build": "tsc",
     "test": "vitest run",
     "test:watch": "vitest",
-    "dry-run": "npm run build && npm pack --dry-run"
+    "dry-run": "bun run build && bun pm pack --dry-run"
   },
   "dependencies": {
     "commander": "^15.0.0"

package/templates/default/instructions.md CHANGED Viewed

@@ -26,6 +26,11 @@ minimizing the diff, following the project's own architecture and conventions.
 - Use idiomatic non-blocking `async`/`await`; ensure code is free of race conditions and deadlocks.
 - Avoid deprecated APIs and patterns; introduce new dependencies only when strictly necessary (permissive license, actively maintained).
+### Review & Verification
+- Review code against five core dimensions: correctness (boundaries, errors, race conditions), readability (depth <= 2, functions <= 50 lines), architecture (SOLID, KISS), security, and performance.
+- Review tests first; address root causes over symptoms (fix shared logic once).
+- Categorize findings clearly (Critical, Important, Suggestion) and provide concrete, actionable fixes.
 ## Definition of Done
 - Builds cleanly and all tests pass without errors or warnings.
 - No debug code, dead code, unused imports, or temporary files left behind.

package/templates/shared/AgentSkills/OPERATING.md CHANGED Viewed

@@ -2,10 +2,10 @@
 ## Workflow
 1. **Memory & Context**: Read `AgentSkills/memory/index.md` (create if missing); load only relevant domain lessons to avoid repeating past mistakes.
-2. **Role & Skill Discovery**: Load relevant role guidance from `AgentSkills/agents/` and skills from `AgentSkills/skills/`.
+2. **Role & Skill Discovery**: Load relevant role guidance from `AgentSkills/agents/` (`architect.md`, `reviewer.md`, `developer.md`) and skills from `AgentSkills/skills/` (including `AgentSkills/skills/review/SKILL.md`).
 3. **Pre-flight Inspection**: Inspect current codebase patterns, dependencies, and baseline build/test state.
 4. **Surgical Implementation**: Apply the minimal change required; adhere strictly to DRY, KISS, and YAGNI.
-5. **Verification**: Run the project's build and test commands (e.g. `npm test`, `dotnet test`, or project test suite) to verify happy paths and edge cases.
+5. **Verification**: Run the project's build and test commands (e.g. `npm test`, `dotnet test`, or project test suite) to verify happy paths and edge cases per `AgentSkills/skills/review/SKILL.md`.
 6. **Learning Loop**: If a mistake was made and corrected or a durable rule discovered, record a concise lesson in `AgentSkills/memory/lessons/<domain>.md` and update `index.md`.
 ## Completion Checklist

package/templates/shared/AgentSkills/agents/reviewer.md ADDED Viewed

@@ -0,0 +1,29 @@
+---
+name: reviewer
+description: Code review, correctness, security, and standards verification.
+---
+# Code Reviewer Guidance
+Universal review guidance for AI agents and human reviewers across all stacks. Security, standards, and core principles remain invariant across frameworks.
+## Core References
+- **Principles**: Adhere strictly to `AgentSkills/skills/principles/SKILL.md`.
+- **Standards**: Adhere strictly to `AgentSkills/skills/standards/SKILL.md`.
+- **Security**: Adhere strictly to `AgentSkills/skills/security/SKILL.md`.
+- **Review**: Adhere strictly to `AgentSkills/skills/review/SKILL.md`.
+## Verification & Automated Checks
+- [ ] **Clean Build**
+- [ ] **Zero Lint Errors**
+- [ ] **Tests Pass**
+- [ ] **Test Robustness**
+## Standards & Skill Compliance
+- [ ] **Principles**: `AgentSkills/skills/principles/SKILL.md`
+- [ ] **Standards**: `AgentSkills/skills/standards/SKILL.md`
+- [ ] **Security**: `AgentSkills/skills/security/SKILL.md`
+- [ ] **Review**: `AgentSkills/skills/review/SKILL.md`
+## Memory & Learning Loop
+- [ ] **Agent Memory**: `AgentSkills/memory/index.md`

package/templates/shared/AgentSkills/skills/principles/SKILL.md ADDED Viewed

@@ -0,0 +1,31 @@
+---
+name: principles
+description: Core software engineering principles, simplicity ladder, surgical changes, and standards.
+---
+# Core Principles
+Foundational software engineering principles and decision rules for AI agents and human contributors.
+## The Simplicity Ladder
+Before writing any code, stop at the first rung that holds:
+1. **Does this need to be built at all?** (YAGNI)
+2. **Does it already exist in this codebase?** Reuse the helper, util, or pattern that is already here; do not rewrite it.
+3. **Does the standard library already do this?** Use it.
+4. **Does a native platform feature cover it?** Use it.
+5. **Does an already-installed dependency solve it?** Use it.
+6. **Can this be one line and simple?** Make it one.
+7. **Only then:** write the minimum code that works.
+The ladder runs after you understand the problem, not instead of it: read the task and the code it touches, trace the real flow end-to-end, then climb.
+## Root Cause Over Symptom
+Bug fix = root cause, not symptom. A bug report names a symptom. Grep every caller of the function you touch and fix the shared function once — one guard there is a smaller diff than one per caller, and patching only the path the ticket names leaves sibling callers still broken.
+## Foundational Principles
+- **Think Before Coding**: Thoroughly understand requirements. If ambiguous, ask before guessing.
+- **Surgical Changes**: Make the smallest change that satisfies the request; touch only what is explicitly required.
+- **Simplicity First (KISS / YAGNI)**: Favor simple, clear, maintainable solutions over clever abstractions. Do not add unrequested features.
+- **Zero-Error Builds**: Every change must compile cleanly and pass existing and newly added tests.
+- **Standards, Security & Review**: Adhere strictly to `AgentSkills/skills/standards/SKILL.md`, `AgentSkills/skills/security/SKILL.md`, and `AgentSkills/skills/review/SKILL.md`.

package/templates/shared/AgentSkills/skills/review/SKILL.md ADDED Viewed

@@ -0,0 +1,33 @@
+---
+name: review
+description: Code review framework, verification criteria, correctness, and review output standards.
+---
+# Code Review Guidelines
+Universal review framework and verification standards for AI agents and human reviewers across all stacks.
+## Five Review Dimensions
+1. **Correctness**: Verify behavior matches specifications, handle boundary/edge cases (null, empty, limits, errors), and ensure changes are free of race conditions.
+2. **Readability**: Ensure naming is domain-meaningful, control flow is simple (depth <= 2), and functions do not exceed 50 lines.
+3. **Architecture**: Adhere to SOLID, DRY, and KISS; keep clean module boundaries; avoid circular dependencies and speculative abstractions (YAGNI).
+4. **Security**: Validate untrusted inputs, use parameterized queries, never commit or log credentials/PII, and check for safe error handling.
+5. **Performance**: Avoid N+1 queries, unbounded loops, blocking operations in async flows, and redundant re-computations.
+## Verification & Automated Checks
+- [ ] **Clean Build**: Project builds cleanly with zero errors or warnings.
+- [ ] **Zero Lint Errors**: Code adheres to project formatting and static analysis rules.
+- [ ] **Tests Pass**: Run test suite; all existing and newly added tests must pass.
+- [ ] **Test Robustness**: Tests must cover failure paths, edge cases, and boundary conditions, not just happy paths.
+## Review Output Format
+Categorize every review finding clearly:
+- **Critical**: Must fix before merge (security flaw, data corruption, broken functionality).
+- **Important**: Should fix before merge (missing test coverage, poor error recovery, rule violation).
+- **Suggestion**: Optional improvements (naming, non-critical refactoring).
+## Review Rules
+- Review tests first to understand intent and coverage.
+- Address root causes over symptoms; fix shared logic once rather than patching callers.
+- Never weaken, skip, or delete existing tests to force a pass.
+- Provide concrete, actionable fixes for every Critical and Important finding.

package/templates/shared/entry-points/instructions.md CHANGED Viewed

@@ -1,24 +1,29 @@
-# Agent Instructions
+# Agent & Developer Instructions
+> Operating instructions and engineering guidelines for AI agents and human contributors.
 ## Operating Contract
-Always follow `AgentSkills/OPERATING.md` before making changes.
+Always follow `AgentSkills/OPERATING.md` before making changes. Review relevant agent personas in `AgentSkills/agents/` (`architect.md`, `reviewer.md`, `developer.md`) and skills in `AgentSkills/skills/` (including `AgentSkills/skills/review/SKILL.md`).
 ## Goal
-Implement the requested change with production-quality code, preserving existing behavior and
-minimizing the diff, following the project's own architecture and conventions.
+Implement requested changes with production-quality code, preserving existing behavior and
+minimizing the diff, following the project's own architecture, standards, and conventions.
 ## Core Principles
+- **Principles**: Adhere strictly to `AgentSkills/skills/principles/SKILL.md`.
+- **Standards**: Adhere strictly to `AgentSkills/skills/standards/SKILL.md`.
+- **Security**: Adhere strictly to `AgentSkills/skills/security/SKILL.md`.
+- **Review**: Adhere strictly to `AgentSkills/skills/review/SKILL.md`.
 - **Think Before Coding**: Thoroughly understand requirements. If ambiguous, ask before guessing.
 - **Surgical Changes**: Make the smallest change that satisfies the request; touch only what is explicitly required.
 - **Simplicity First (KISS / YAGNI)**: Favor simple, clear, maintainable solutions over clever abstractions. Do not add unrequested features.
 - **Zero-Error Builds**: Every change must compile cleanly and pass existing and newly added tests.
-- **Standards & Security**: Adhere strictly to `AgentSkills/skills/standards/SKILL.md` and `AgentSkills/skills/security/SKILL.md`.
 ## Definition of Done
 - Builds cleanly and all tests pass without errors or warnings.
 - No debug code, dead code, unused imports, or temporary files left behind.
 - Changes are minimal, focused, covered by tests, and easy to review.
-## Agent Memory
+## Agent & Contributor Memory
 - Read `AgentSkills/memory/index.md` at the start of every task (create if missing); load only relevant domain lessons.
-- When a mistake is corrected or a durable rule discovered, record an actionable lesson in `AgentSkills/memory/lessons/<domain>.md` (create if missing) and update `index.md`.
+- When a mistake is corrected or a durable rule discovered, record an actionable lesson in `AgentSkills/memory/lessons/<domain>.md` (create if missing) and update `index.md`.

package/templates/shared/AgentSkills/agents/reviewer.agent.md DELETED Viewed

@@ -1,26 +0,0 @@
----
-name: reviewer
-description: Code review, correctness, security, and standards verification.
----
-# Code Reviewer Guidance
-## Review Checklist
-### Scope & Minimality
-- [ ] Minimal diff that directly satisfies the request without unrelated edits or speculative additions (YAGNI).
-- [ ] No dead code, debug logging, commented-out code, or unused imports/variables left behind.
-### Quality & Standards
-- [ ] Functions stay within 50 lines, nesting depth at most 2 levels, and clean signatures ($\le 4$ params).
-- [ ] Follows established codebase naming conventions, architectural boundaries, and error patterns.
-- [ ] No magic numbers or strings (constants/enums used appropriately).
-### Security & Reliability
-- [ ] No hardcoded credentials, tokens, passwords, or exposed sensitive user PII.
-- [ ] Input validation applied at boundaries; queries parameterized against injection.
-- [ ] Concurrency and async flows are free of race conditions and deadlocks.
-### Verification & Tests
-- [ ] Clean build with zero errors and warnings.
-- [ ] Tests pass and verify both success scenarios and failure/edge-case paths.

/package/templates/dotnet/AgentSkills/agents/{architect.agent.md → architect.md} RENAMED Viewed

File without changes

/package/templates/dotnet/AgentSkills/agents/{developer.agent.md → developer.md} RENAMED Viewed

File without changes

/package/templates/react/AgentSkills/agents/{developer.agent.md → developer.md} RENAMED Viewed

File without changes

/package/templates/shared/AgentSkills/agents/{architect.agent.md → architect.md} RENAMED Viewed

File without changes