@shrkcrft/cli 0.1.0-alpha.7 → 0.1.0-alpha.8

package/dist/commands/packs-new.js

@@ -8,7 +8,6 @@ const VALID_KINDS = new Set([
     'framework',
     'architecture',
     'enterprise',
-    'platform-adopter',
 ]);
 /** Pure: compute the file set to write. No IO. */
 export function planPackScaffold(input) {
@@ -101,12 +100,6 @@ export function planPackScaffold(input) {
             body: renderBoundariesAsset(),
         });
     }
-    if (input.kind === 'platform-adopter' || input.withExamples) {
-        files.push({
-            relativePath: 'src/assets/contracts/plugin-contract.example.ts',
-            body: renderPluginContractExample(),
-        });
-    }
     if (input.kind === 'enterprise') {
         files.push({
             relativePath: 'docs/review-workflow.md',
@@ -232,12 +225,6 @@ function renderKnowledgeAsset(input) {
             ['framework.overview', 'Framework overview', 'High', 'What this framework is for.'],
         ]);
     }
-    if (input.kind === 'platform-adopter') {
-        return knowledgeBody([
-            ['platform.policy', 'Policy capability', 'Medium', 'Describe the policy/capability model your platform exposes.'],
-            ['platform.adapter', 'Adapter contract', 'Medium', 'Describe the adapter contract your platform expects.'],
-        ]);
-    }
     return knowledgeBody([
         ['pack.overview', 'Pack overview', 'Medium', 'Short overview of what this pack contributes.'],
     ]);
@@ -350,17 +337,6 @@ function renderBoundariesAsset() {
         ``,
     ].join('\n');
 }
-function renderPluginContractExample() {
-    return [
-        `// Example: an adapter-style plugin contract.`,
-        `// Replace with the actual interface your platform expects.`,
-        `export interface IPluginCapability {`,
-        `  id: string;`,
-        `  invoke(input: unknown): Promise<unknown>;`,
-        `}`,
-        ``,
-    ].join('\n');
-}
 function renderEnterpriseReviewDocs() {
     return [
         `# Review workflow`,
@@ -407,11 +383,11 @@ function renderDocsOverview(input, fullName) {
 export const packsNewCommand = {
     name: 'new',
     description: 'Scaffold a new SharkCraft pack package (rules / paths / templates / pipelines / presets / boundaries). Dry-run by default — pass --write to materialize. No install, no publish, no overwrite without --force.',
-    usage: 'shrk [--cwd <dir>] packs new <name> [--scope @org] [--preset <id>] [--kind generic|framework|architecture|enterprise|platform-adopter] [--with-examples] [--write] [--force] [--json]',
+    usage: 'shrk [--cwd <dir>] packs new <name> [--scope @org] [--preset <id>] [--kind generic|framework|architecture|enterprise] [--with-examples] [--write] [--force] [--json]',
     async run(args) {
         const name = args.positional[0];
         if (!name) {
-            process.stderr.write('Usage: shrk packs new <name> [--scope @org] [--preset <id>] [--kind generic|framework|architecture|enterprise|platform-adopter] [--with-examples] [--write]\n');
+            process.stderr.write('Usage: shrk packs new <name> [--scope @org] [--preset <id>] [--kind generic|framework|architecture|enterprise] [--with-examples] [--write]\n');
             return 2;
         }
         const cwd = resolveCwd(args);

package/dist/commands/profiles.command.js

@@ -1,6 +1,6 @@
 /**
  * `shrk profiles ...` — unified read-only surface for all pack-/local-
- * contributed profiles (plugin lifecycle, migration, and future kinds).
+ * contributed profiles (migration, and future kinds).
  */
 import { findProfile, inspectSharkcraft, listProfileIssues, listProfiles, ProfileKind, } from '@shrkcrft/inspector';
 import { flagBool, flagString, resolveCwd, } from "../command-registry.js";
@@ -15,7 +15,7 @@ function parseKind(value) {
 }
 export const profilesListCommand = {
     name: 'list',
-    description: 'List all registered profiles (plugin-lifecycle, migration, ...).',
+    description: 'List all registered profiles (migration, ...).',
     usage: 'shrk profiles list [--kind <kind>] [--json]',
     async run(args) {
         const cwd = resolveCwd(args);
@@ -28,7 +28,7 @@ export const profilesListCommand = {
         }
         process.stdout.write(header(`Profiles (${entries.length}${kind ? `, kind=${kind}` : ''})`));
         if (entries.length === 0) {
-            process.stdout.write('  (none — contribute via packs: pluginLifecycleProfileFiles, migrationProfileFiles, etc.)\n');
+            process.stdout.write('  (none — contribute via packs: migrationProfileFiles, etc.)\n');
             return 0;
         }
         for (const e of entries) {
@@ -132,7 +132,7 @@ export const profilesSearchCommand = {
 };
 export const profilesCommand = {
     name: 'profiles',
-    description: 'List / inspect pack-contributed profiles (plugin-lifecycle, migration, conventions, …).',
+    description: 'List / inspect pack-contributed profiles (migration, conventions, …).',
     usage: 'shrk profiles list|get|doctor|search ...',
     async run(args) {
         const sub = args.positional[0];

package/dist/commands/release.command.js

@@ -204,8 +204,8 @@ function resolveSmokeFlags(args) {
     const noAssertions = flagBool(args, 'no-assertions');
     return { assertionsEnabled: !noAssertions };
 }
-// Generic adopter target replaces the previous hardcoded project target.
-const BUILTIN_TARGET_IDS = ['sharkcraft', 'dogfood', 'synthetic', 'adopter'];
+// Generic consumer target replaces the previous hardcoded project target.
+const BUILTIN_TARGET_IDS = ['sharkcraft', 'dogfood', 'synthetic', 'consumer'];
 function resolveTargets(cwd, args, requested) {
     const want = (id) => requested.length === 0 || requested.includes(id);
     const out = [];
@@ -224,19 +224,19 @@ function resolveTargets(cwd, args, requested) {
         writeFileSync(nodePath.join(root, 'package.json'), JSON.stringify({ name: 'sharkcraft-synth', version: '0.0.0', type: 'module' }, null, 2), 'utf8');
         out.push({ id: 'synthetic', cwd: root, label: 'synthetic-fixture' });
     }
-    if (want('adopter')) {
-        const adopterRoot = flagString(args, 'adopter-root') ??
-            process.env['SHARKCRAFT_ADOPTER_ROOT'] ??
+    if (want('consumer')) {
+        const consumerRoot = flagString(args, 'consumer-root') ??
+            process.env['SHARKCRAFT_CONSUMER_ROOT'] ??
             '';
-        if (adopterRoot && existsSync(adopterRoot)) {
-            out.push({ id: 'adopter', cwd: adopterRoot, label: `adopter:${adopterRoot}` });
+        if (consumerRoot && existsSync(consumerRoot)) {
+            out.push({ id: 'consumer', cwd: consumerRoot, label: `consumer:${consumerRoot}` });
         }
         else {
             out.push({
-                id: 'adopter',
-                cwd: adopterRoot || '(unset)',
-                label: 'adopter target',
-                warning: 'Adopter root not set (pass --adopter-root or set SHARKCRAFT_ADOPTER_ROOT) — skipped.',
+                id: 'consumer',
+                cwd: consumerRoot || '(unset)',
+                label: 'consumer target',
+                warning: 'Consumer root not set (pass --consumer-root or set SHARKCRAFT_CONSUMER_ROOT) — skipped.',
             });
         }
     }
@@ -292,7 +292,7 @@ async function runReleaseSmoke(args) {
  *    examples/dogfood-target as the fixture.
  *  - `synthetic` runs the scenarios that don't depend on a prepared source
  *    (unconfigured-repo + pack-authoring).
- *  - `adopter` runs the read-only scenarios that don't write outside the
+ *  - `consumer` runs the read-only scenarios that don't write outside the
  *    fixture (e.g. an external project that consumes a SharkCraft pack).
  */
 function isScenarioApplicableTo(scenario, target) {
@@ -304,7 +304,7 @@ function isScenarioApplicableTo(scenario, target) {
     if (target.id === 'dogfood') {
         return scenario === 'dev-workflow' || scenario === 'pr-review' || scenario === 'governance';
     }
-    if (target.id === 'adopter') {
+    if (target.id === 'consumer') {
         return scenario === 'unconfigured-repo' || scenario === 'pack-authoring' || scenario === 'governance';
     }
     return true;

package/dist/commands/search.command.js

@@ -27,7 +27,7 @@ function parseSources(args) {
 }
 export const searchCommand = {
     name: 'search',
-    description: 'Universal search across commands, MCP tools, knowledge, rules, paths, conventions, templates, helpers, playbooks, constructs, policies, decisions, scaffold patterns, contract templates, migration profiles, plugin lifecycle profiles, feedback rules, task routing hints, docs, recent reports. Default emits the 7-section unified output; pass --legacy for the flat output.',
+    description: 'Universal search across commands, MCP tools, knowledge, rules, paths, conventions, templates, helpers, playbooks, constructs, policies, decisions, scaffold patterns, contract templates, migration profiles, feedback rules, task routing hints, docs, recent reports. Default emits the 7-section unified output; pass --legacy for the flat output.',
     usage: 'shrk search <query> [--kind <kind>] [--source local|pack|...] [--limit N] [--explain] [--commands-only] [--actions-only] [--format text|markdown|json] [--legacy]',
     async run(args) {
         // Sub-dispatch for `shrk search tuning [list|doctor]`.

package/dist/commands/task-context.command.js

@@ -399,22 +399,6 @@ async function collectLikelyFilesV2(input) {
             }
         }
     }
-    // Boost files that sit on registered plugin-lifecycle profile barrels.
-    try {
-        const { listPluginLifecycleProfiles } = await import('@shrkcrft/inspector');
-        const profiles = await listPluginLifecycleProfiles(inspection);
-        for (const entry of profiles) {
-            for (const b of entry.profile.barrels ?? []) {
-                for (const f of [...scoreByPath.keys()]) {
-                    if (f.includes(b.path))
-                        bump(f, 3, `lifecycle profile barrel: ${b.id}`);
-                }
-            }
-        }
-    }
-    catch {
-        // Profile registry unavailable — skip the boost.
-    }
     // 10) Tests — files that look like they test the matched files.
     const tests = [];
     for (const f of [...scoreByPath.keys()]) {

package/dist/export/claude-commands-export.d.ts

@@ -0,0 +1,60 @@
+/**
+ * `.claude/commands/` generator — emits per-project slash commands
+ * for Claude Code. Companion to `claude-skill` export, but with a
+ * different inversion semantics:
+ *
+ *   - **claude-skill** loads rules into Claude's prompt automatically
+ *     based on description match. Passive — Claude reads the rules.
+ *   - **claude-commands** registers slash commands the USER invokes
+ *     (`/new-service`, `/check-changes`). Active — the command IS the
+ *     recipe; Claude follows it step-by-step.
+ *
+ * Generated commands fall into two buckets:
+ *
+ * **Static commands** (always present, project-agnostic recipes):
+ *   - `/follow-shrk` — short reminder of the apply-gate flow.
+ *   - `/check-changes` — runs `shrk check boundaries --changed-only`
+ *     scoped to the current diff and reports back.
+ *   - `/shrk-brief` — runs `shrk brief` and uses the output for the
+ *     current task.
+ *   - `/explain-file <path>` — per-file rules / paths / boundary
+ *     lookup (pairs with `shrk advise <path>` from Phase 3).
+ *
+ * **Per-template commands** (one per id in `sharkcraft/templates.ts`):
+ *   - `/new-<template-id>` — Claude runs `shrk gen <template-id>
+ *     <name> --dry-run --save-plan ...`, reviews the plan, and
+ *     applies via `shrk apply ... --verify-signature --validate`.
+ *
+ * Generated files are self-contained markdown — no `@shrkcrft/*`
+ * imports, no shell expansions. Each one is a complete "recipe in a
+ * file" that Claude Code reads when the user types the slash command.
+ */
+import type { ISharkcraftInspection } from '@shrkcrft/inspector';
+export interface IClaudeCommandFile {
+    /** Path relative to project root (e.g. `.claude/commands/new-service.md`). */
+    path: string;
+    /** Full markdown body, including YAML frontmatter. */
+    content: string;
+    /** The slash name users type (e.g. `new-service` → `/new-service`). */
+    slash: string;
+    /** Why this command was generated — surfaces in the dry-run summary. */
+    source: 'static' | 'template';
+}
+export interface IClaudeCommandsResult {
+    files: readonly IClaudeCommandFile[];
+}
+export interface IClaudeCommandsOptions {
+    /**
+     * Cap on the number of per-template commands to emit. Default 20.
+     * Templates are sorted by id; the first N are kept.
+     */
+    maxTemplateCommands?: number;
+}
+/**
+ * Build the full set of `.claude/commands/*.md` files for a project.
+ *
+ * Pure — caller writes the bytes. Same shape as the `synthesize-*`
+ * functions in this codebase: input inspection → output file list.
+ */
+export declare function buildClaudeCommands(inspection: ISharkcraftInspection, options?: IClaudeCommandsOptions): IClaudeCommandsResult;
+//# sourceMappingURL=claude-commands-export.d.ts.map

package/dist/export/claude-commands-export.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-commands-export.d.ts","sourceRoot":"","sources":["../../src/export/claude-commands-export.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAEjE,MAAM,WAAW,kBAAkB;IACjC,8EAA8E;IAC9E,IAAI,EAAE,MAAM,CAAC;IACb,sDAAsD;IACtD,OAAO,EAAE,MAAM,CAAC;IAChB,uEAAuE;IACvE,KAAK,EAAE,MAAM,CAAC;IACd,wEAAwE;IACxE,MAAM,EAAE,QAAQ,GAAG,UAAU,CAAC;CAC/B;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,SAAS,kBAAkB,EAAE,CAAC;CACtC;AA0MD,MAAM,WAAW,sBAAsB;IACrC;;;OAGG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,qBAAqB,EACjC,OAAO,GAAE,sBAA2B,GACnC,qBAAqB,CAsDvB"}

package/dist/export/claude-commands-export.js

@@ -0,0 +1,276 @@
+/**
+ * `.claude/commands/` generator — emits per-project slash commands
+ * for Claude Code. Companion to `claude-skill` export, but with a
+ * different inversion semantics:
+ *
+ *   - **claude-skill** loads rules into Claude's prompt automatically
+ *     based on description match. Passive — Claude reads the rules.
+ *   - **claude-commands** registers slash commands the USER invokes
+ *     (`/new-service`, `/check-changes`). Active — the command IS the
+ *     recipe; Claude follows it step-by-step.
+ *
+ * Generated commands fall into two buckets:
+ *
+ * **Static commands** (always present, project-agnostic recipes):
+ *   - `/follow-shrk` — short reminder of the apply-gate flow.
+ *   - `/check-changes` — runs `shrk check boundaries --changed-only`
+ *     scoped to the current diff and reports back.
+ *   - `/shrk-brief` — runs `shrk brief` and uses the output for the
+ *     current task.
+ *   - `/explain-file <path>` — per-file rules / paths / boundary
+ *     lookup (pairs with `shrk advise <path>` from Phase 3).
+ *
+ * **Per-template commands** (one per id in `sharkcraft/templates.ts`):
+ *   - `/new-<template-id>` — Claude runs `shrk gen <template-id>
+ *     <name> --dry-run --save-plan ...`, reviews the plan, and
+ *     applies via `shrk apply ... --verify-signature --validate`.
+ *
+ * Generated files are self-contained markdown — no `@shrkcrft/*`
+ * imports, no shell expansions. Each one is a complete "recipe in a
+ * file" that Claude Code reads when the user types the slash command.
+ */
+// ─── Static commands (always emitted) ────────────────────────────────────────
+const STATIC_FOLLOW_SHRK = `---
+description: Reminder of the shrk apply-gate flow for this project. Use when generating or modifying code so the change passes the same boundary / validation gates the project CI uses.
+---
+
+# Follow the shrk apply-gate flow
+
+This repo uses [SharkCraft](https://github.com/shrkcrft/sharkcraft) as the
+gate for AI-written code. Skip the gate and CI will fail with the same
+errors anyway — save the round-trip.
+
+## The loop
+
+1. **Get focused context first.**
+   - Run: \`shrk task "<one-sentence task>"\` for a task packet (relevant rules + templates + verification commands).
+   - Or: \`shrk brief\` for the single-page project brief.
+
+2. **Scaffold via a template (not freehand).**
+   - List options: \`shrk templates list\`.
+   - Dry-run + save plan: \`shrk gen <template-id> <name> --dry-run --save-plan /tmp/plan.json\`.
+
+3. **Apply the plan through the CLI.**
+   - \`shrk apply /tmp/plan.json --verify-signature --validate\`.
+   - Never write files directly through MCP — MCP is read-only in this repo.
+
+4. **Verify before declaring done.**
+   - \`shrk check boundaries --changed-only\` — fails if the diff broke any layer rule.
+   - \`shrk check imports\` — fails on lazy requires / cross-package deep imports.
+   - Project verification commands (from \`shrk task\`'s \`actionHints.verificationCommands\`).
+
+## When this loop doesn't apply
+
+- Tiny changes that don't touch source files (docs, comments).
+- Read-only investigations.
+- Anything where shrk would clearly be in the way.
+
+In all other cases: **follow the loop**. The gates are short; the rework if you skip them is long.
+`;
+const STATIC_CHECK_CHANGES = `---
+description: Run shrk's boundary + import-hygiene checks on the current git diff. Use after making any file change to confirm the change didn't violate the project's architecture rules before declaring the task done.
+---
+
+# Check the current diff for boundary violations
+
+Run the diff-scoped boundary check:
+
+\`\`\`bash
+shrk check boundaries --changed-only
+\`\`\`
+
+Run the import-hygiene check on the changed files:
+
+\`\`\`bash
+shrk check imports
+\`\`\`
+
+## Interpreting the output
+
+- **Exit 0, "0 violations":** safe to declare done.
+- **Exit non-zero with violations listed:** fix each violation before continuing. Each violation has a \`suggestedFix\` line — apply it.
+- **A violation on a file you didn't change:** that's a pre-existing violation in the repo. Ignore it; the \`--changed-only\` filter only fails on violations your diff introduced.
+
+If the violations look like false positives, consult \`sharkcraft/boundaries.ts\` (the rule definitions) — don't disable them ad-hoc.
+`;
+const STATIC_SHRK_BRIEF = `---
+description: Pull shrk's single-page project brief — focused rules, paths, verification commands. Use when starting work in this codebase so you have the project's actual conventions in context before writing any code.
+---
+
+# Pull the shrk brief for this project
+
+Run the project brief:
+
+\`\`\`bash
+shrk brief
+\`\`\`
+
+This returns a compact markdown brief covering:
+- Project overview (name, frameworks, package manager).
+- Top rules that apply to code generation in this repo.
+- Path conventions (where different file types belong).
+- Action hints (commands, MCP tools, verification commands).
+- Forbidden actions (what NOT to do).
+
+For a per-task version (only the rules + paths + templates relevant to one task):
+
+\`\`\`bash
+shrk task "<one-sentence task description>"
+\`\`\`
+
+Both are read-only — no files are touched. Use the output to shape your plan before making any changes.
+`;
+const STATIC_EXPLAIN_FILE = `---
+description: Look up the rules, path conventions, and boundary rules that apply to a specific file in this codebase. Use before editing an unfamiliar file so you follow the project's per-area conventions instead of generic patterns.
+---
+
+# Explain what applies to a file in this codebase
+
+For a given file path (e.g. \`apps/users/src/profile.service.ts\`):
+
+\`\`\`bash
+shrk why <file-path>
+\`\`\`
+
+Returns:
+- Which package / layer the file belongs to.
+- Which path conventions apply (e.g. "services live in \`apps/<x>/src/services/\`").
+- Which rules are scoped to this file's path.
+- Which boundary rules constrain this file's imports.
+- Cross-references to related knowledge entries.
+
+Use this *before* editing. The output is the project's actual conventions for that area, not your guess based on the file's content.
+`;
+// ─── Per-template command generator ──────────────────────────────────────────
+/**
+ * Slugify a template id into a slash-command name. Template ids
+ * conventionally look like `typescript.service`; the slash command is
+ * `new-typescript-service` (or `new-service` if the segment after the
+ * dot is unique and shorter).
+ */
+function templateSlash(templateId) {
+    // Use the LAST dot-separated segment as the primary name —
+    // `typescript.service` → `new-service`. Falls back to the full id
+    // when there's no dot or the segment is too generic (single char).
+    const parts = templateId.split('.');
+    const tail = parts[parts.length - 1] ?? templateId;
+    const safeName = tail.length >= 3 ? tail : templateId.replace(/\./g, '-');
+    return `new-${safeName}`
+        .toLowerCase()
+        .replace(/[^a-z0-9-]+/g, '-')
+        .replace(/-+/g, '-')
+        .replace(/^-+|-+$/g, '');
+}
+function templateCommandBody(template) {
+    const displayName = template.name ?? template.id;
+    const description = template.description
+        ? template.description.replace(/\s+/g, ' ').trim()
+        : `Scaffold a new ${displayName} using the project's actual template (\`${template.id}\`). Follows the shrk plan → apply → validate flow.`;
+    return `---
+description: ${JSON.stringify(description)}
+---
+
+# /${templateSlash(template.id)} — scaffold ${displayName}
+
+This command scaffolds a new ${displayName} using the project's actual template
+defined in \`sharkcraft/templates.ts\`. The template encodes this repo's
+conventions for path, naming, and structure — the result will match how
+the rest of the codebase is organized, not generic patterns.
+
+## The flow
+
+When the user invokes \`/${templateSlash(template.id)} <name>\`:
+
+1. **Generate a plan (no writes yet):**
+   \`\`\`bash
+   shrk gen ${template.id} <name> --dry-run --save-plan /tmp/${templateSlash(template.id)}.plan.json
+   \`\`\`
+
+2. **Read the plan back** from \`/tmp/${templateSlash(template.id)}.plan.json\` and show the user which files will be created.
+
+3. **Confirm.** Wait for the user to approve. If they want changes, adjust the plan or re-run \`shrk gen\` with different flags.
+
+4. **Apply through the validated CLI path:**
+   \`\`\`bash
+   shrk apply /tmp/${templateSlash(template.id)}.plan.json --verify-signature --validate
+   \`\`\`
+
+5. **Verify** the diff didn't break any boundary rules:
+   \`\`\`bash
+   shrk check boundaries --changed-only
+   \`\`\`
+
+## If the template doesn't fit
+
+If the user's request doesn't match the \`${template.id}\` template
+shape, fall back to:
+
+- \`shrk templates list\` — see all available templates.
+- \`shrk gen <other-template> <name> --dry-run\` — try a different template.
+- Hand-author only as last resort, and run \`/check-changes\` after.
+
+The whole point of using the template is consistency with the rest of
+this codebase. Skipping it means the new code will look different from
+what's already there.
+`;
+}
+/**
+ * Build the full set of `.claude/commands/*.md` files for a project.
+ *
+ * Pure — caller writes the bytes. Same shape as the `synthesize-*`
+ * functions in this codebase: input inspection → output file list.
+ */
+export function buildClaudeCommands(inspection, options = {}) {
+    const files = [];
+    files.push({
+        path: '.claude/commands/follow-shrk.md',
+        slash: 'follow-shrk',
+        source: 'static',
+        content: STATIC_FOLLOW_SHRK,
+    });
+    files.push({
+        path: '.claude/commands/check-changes.md',
+        slash: 'check-changes',
+        source: 'static',
+        content: STATIC_CHECK_CHANGES,
+    });
+    files.push({
+        path: '.claude/commands/shrk-brief.md',
+        slash: 'shrk-brief',
+        source: 'static',
+        content: STATIC_SHRK_BRIEF,
+    });
+    files.push({
+        path: '.claude/commands/explain-file.md',
+        slash: 'explain-file',
+        source: 'static',
+        content: STATIC_EXPLAIN_FILE,
+    });
+    // Per-template commands — bounded so a pack with 50 templates
+    // doesn't dump 50 slash commands into the user's palette. Sorted
+    // by id for deterministic emit order.
+    const cap = options.maxTemplateCommands ?? 20;
+    const templates = [...inspection.templates].sort((a, b) => a.id.localeCompare(b.id));
+    const seenSlash = new Set(files.map((f) => f.slash));
+    for (const t of templates) {
+        if (files.filter((f) => f.source === 'template').length >= cap)
+            break;
+        let slash = templateSlash(t.id);
+        if (seenSlash.has(slash)) {
+            // Two templates with the same tail (e.g. `ts.service` and
+            // `py.service` both → `new-service`) — fall back to the full id
+            // to disambiguate the second one.
+            slash = `new-${t.id.replace(/\./g, '-').toLowerCase()}`;
+            if (seenSlash.has(slash))
+                continue;
+        }
+        seenSlash.add(slash);
+        files.push({
+            path: `.claude/commands/${slash}.md`,
+            slash,
+            source: 'template',
+            content: templateCommandBody(t),
+        });
+    }
+    return { files };
+}

package/dist/export/export-formats.d.ts

@@ -1,5 +1,5 @@
 import type { ISharkcraftInspection } from '@shrkcrft/inspector';
-export type ExportFormat = 'agents-md' | 'claude-md' | 'cursor-rules' | 'copilot-instructions';
+export type ExportFormat = 'agents-md' | 'claude-md' | 'claude-skill' | 'cursor-rules' | 'copilot-instructions';
 export interface ExportOptions {
     format: ExportFormat;
     /** Optional task to scope the export. */

package/dist/export/export-formats.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"export-formats.d.ts","sourceRoot":"","sources":["../../src/export/export-formats.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAIjE,MAAM,MAAM,YAAY,GACpB,WAAW,GACX,WAAW,GACX,cAAc,GACd,sBAAsB,CAAC;AAE3B,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,YAAY,CAAC;IACrB,yCAAyC;IACzC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kDAAkD;IAClD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,YAAY,CAAC;IACrB,yDAAyD;IACzD,aAAa,EAAE,MAAM,CAAC;IACtB,wBAAwB;IACxB,OAAO,EAAE,MAAM,CAAC;CACjB;AAqHD,wBAAgB,YAAY,CAC1B,UAAU,EAAE,qBAAqB,EACjC,OAAO,EAAE,aAAa,GACrB,YAAY,CAsBd;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,YAAY,CAOnE;AAED,eAAO,MAAM,kBAAkB,EAAE,SAAS,YAAY,EAKpD,CAAC"}
+{"version":3,"file":"export-formats.d.ts","sourceRoot":"","sources":["../../src/export/export-formats.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAIjE,MAAM,MAAM,YAAY,GACpB,WAAW,GACX,WAAW,GACX,cAAc,GACd,cAAc,GACd,sBAAsB,CAAC;AAE3B,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,YAAY,CAAC;IACrB,yCAAyC;IACzC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kDAAkD;IAClD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,YAAY,CAAC;IACrB,yDAAyD;IACzD,aAAa,EAAE,MAAM,CAAC;IACtB,wBAAwB;IACxB,OAAO,EAAE,MAAM,CAAC;CACjB;AAqPD,wBAAgB,YAAY,CAC1B,UAAU,EAAE,qBAAqB,EACjC,OAAO,EAAE,aAAa,GACrB,YAAY,CAmCd;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,YAAY,CAQnE;AAED,eAAO,MAAM,kBAAkB,EAAE,SAAS,YAAY,EAMpD,CAAC"}