@dotcontext/cli 0.8.0

package/dist/generators/shared/structures/validation.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Validation functions for scaffold structures
+ */
+import { ScaffoldStructure } from './types';
+/**
+ * Validate that a structure is well-formed
+ */
+export declare function validateStructure(structure: ScaffoldStructure): string[];
+/**
+ * Validate all structures in the registry
+ */
+export declare function validateAllStructures(): Map<string, string[]>;
+//# sourceMappingURL=validation.d.ts.map

package/dist/generators/shared/structures/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../../src/generators/shared/structures/validation.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAG5C;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,iBAAiB,GAAG,MAAM,EAAE,CA8BxE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAW7D"}

package/dist/generators/shared/structures/validation.js

@@ -0,0 +1,51 @@
+"use strict";
+/**
+ * Validation functions for scaffold structures
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateStructure = validateStructure;
+exports.validateAllStructures = validateAllStructures;
+const registry_1 = require("./registry");
+/**
+ * Validate that a structure is well-formed
+ */
+function validateStructure(structure) {
+    const errors = [];
+    if (!structure.documentName) {
+        errors.push('Missing documentName');
+    }
+    if (!structure.title) {
+        errors.push('Missing title');
+    }
+    if (!structure.sections || structure.sections.length === 0) {
+        errors.push('No sections defined');
+    }
+    const orders = new Set();
+    for (const section of structure.sections) {
+        if (!section.heading) {
+            errors.push(`Section ${section.order} missing heading`);
+        }
+        if (!section.guidance) {
+            errors.push(`Section "${section.heading}" missing guidance`);
+        }
+        if (orders.has(section.order)) {
+            errors.push(`Duplicate order ${section.order}`);
+        }
+        orders.add(section.order);
+    }
+    return errors;
+}
+/**
+ * Validate all structures in the registry
+ */
+function validateAllStructures() {
+    const results = new Map();
+    for (const [name, structure] of Object.entries(registry_1.SCAFFOLD_STRUCTURES)) {
+        const errors = validateStructure(structure);
+        if (errors.length > 0) {
+            results.set(name, errors);
+        }
+    }
+    return results;
+}
+//# sourceMappingURL=validation.js.map

package/dist/generators/shared/structures/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../../../src/generators/shared/structures/validation.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAQH,8CA8BC;AAKD,sDAWC;AAnDD,yCAAiD;AAEjD;;GAEG;AACH,SAAgB,iBAAiB,CAAC,SAA4B;IAC5D,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,IAAI,CAAC,SAAS,CAAC,YAAY,EAAE,CAAC;QAC5B,MAAM,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;IACtC,CAAC;IAED,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;QACrB,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAC/B,CAAC;IAED,IAAI,CAAC,SAAS,CAAC,QAAQ,IAAI,SAAS,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3D,MAAM,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;IACrC,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,GAAG,EAAU,CAAC;IACjC,KAAK,MAAM,OAAO,IAAI,SAAS,CAAC,QAAQ,EAAE,CAAC;QACzC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;YACrB,MAAM,CAAC,IAAI,CAAC,WAAW,OAAO,CAAC,KAAK,kBAAkB,CAAC,CAAC;QAC1D,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;YACtB,MAAM,CAAC,IAAI,CAAC,YAAY,OAAO,CAAC,OAAO,oBAAoB,CAAC,CAAC;QAC/D,CAAC;QACD,IAAI,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAC9B,MAAM,CAAC,IAAI,CAAC,mBAAmB,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;QAClD,CAAC;QACD,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAC5B,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,SAAgB,qBAAqB;IACnC,MAAM,OAAO,GAAG,IAAI,GAAG,EAAoB,CAAC;IAE5C,KAAK,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,8BAAmB,CAAC,EAAE,CAAC;QACpE,MAAM,MAAM,GAAG,iBAAiB,CAAC,SAAS,CAAC,CAAC;QAC5C,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtB,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/generators/skills/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Skills Generator Module
+ */
+export { SkillGenerator, SkillGeneratorOptions, SkillGeneratorResult, createSkillGenerator, } from './skillGenerator';
+export { generateSkillContent, getDefaultPhases } from './templates/skillTemplate';
+export { generateSkillsIndex } from './templates/indexTemplate';
+//# sourceMappingURL=index.d.ts.map

package/dist/generators/skills/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/generators/skills/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,cAAc,EACd,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAEnF,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/generators/skills/index.js

@@ -0,0 +1,15 @@
+"use strict";
+/**
+ * Skills Generator Module
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateSkillsIndex = exports.getDefaultPhases = exports.generateSkillContent = exports.createSkillGenerator = exports.SkillGenerator = void 0;
+var skillGenerator_1 = require("./skillGenerator");
+Object.defineProperty(exports, "SkillGenerator", { enumerable: true, get: function () { return skillGenerator_1.SkillGenerator; } });
+Object.defineProperty(exports, "createSkillGenerator", { enumerable: true, get: function () { return skillGenerator_1.createSkillGenerator; } });
+var skillTemplate_1 = require("./templates/skillTemplate");
+Object.defineProperty(exports, "generateSkillContent", { enumerable: true, get: function () { return skillTemplate_1.generateSkillContent; } });
+Object.defineProperty(exports, "getDefaultPhases", { enumerable: true, get: function () { return skillTemplate_1.getDefaultPhases; } });
+var indexTemplate_1 = require("./templates/indexTemplate");
+Object.defineProperty(exports, "generateSkillsIndex", { enumerable: true, get: function () { return indexTemplate_1.generateSkillsIndex; } });
+//# sourceMappingURL=index.js.map

package/dist/generators/skills/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/generators/skills/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,mDAK0B;AAJxB,gHAAA,cAAc,OAAA;AAGd,sHAAA,oBAAoB,OAAA;AAGtB,2DAAmF;AAA1E,qHAAA,oBAAoB,OAAA;AAAE,iHAAA,gBAAgB,OAAA;AAE/C,2DAAgE;AAAvD,oHAAA,mBAAmB,OAAA"}

package/dist/generators/skills/skillGenerator.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Skill Generator
+ *
+ * Scaffolds skill directories and SKILL.md files.
+ * Generates frontmatter-only files (scaffold v2) for AI to fill.
+ */
+import { PrevcPhase } from '../../workflow/types';
+export interface SkillGeneratorOptions {
+    /** Repository path */
+    repoPath: string;
+    /** Output directory (default: .context) */
+    outputDir?: string;
+    /** Skills to generate (default: all built-in) */
+    skills?: string[];
+    /** Force overwrite existing files */
+    force?: boolean;
+}
+export interface SkillGeneratorResult {
+    skillsDir: string;
+    generatedSkills: string[];
+    skippedSkills: string[];
+    indexPath: string;
+}
+export declare class SkillGenerator {
+    private readonly repoPath;
+    private readonly outputDir;
+    private readonly skillsDir;
+    constructor(options: SkillGeneratorOptions);
+    /**
+     * Generate skills directory with selected skills
+     */
+    generate(options?: {
+        skills?: string[];
+        force?: boolean;
+    }): Promise<SkillGeneratorResult>;
+    /**
+     * Format skill name as display title
+     */
+    private formatSkillTitle;
+    /**
+     * Generate a single custom skill
+     */
+    generateCustomSkill(options: {
+        name: string;
+        description: string;
+        phases?: PrevcPhase[];
+        force?: boolean;
+    }): Promise<string>;
+    /**
+     * Generate README.md index
+     */
+    generateIndex(): Promise<string>;
+}
+/**
+ * Factory function
+ */
+export declare function createSkillGenerator(options: SkillGeneratorOptions): SkillGenerator;
+//# sourceMappingURL=skillGenerator.d.ts.map

package/dist/generators/skills/skillGenerator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skillGenerator.d.ts","sourceRoot":"","sources":["../../../src/generators/skills/skillGenerator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAcH,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAMlD,MAAM,WAAW,qBAAqB;IACpC,sBAAsB;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,2CAA2C;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iDAAiD;IACjD,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,qCAAqC;IACrC,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,OAAO,EAAE,qBAAqB;IAM1C;;OAEG;IACG,QAAQ,CAAC,OAAO,GAAE;QACtB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;QAClB,KAAK,CAAC,EAAE,OAAO,CAAC;KACZ,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAgEtC;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAOxB;;OAEG;IACG,mBAAmB,CAAC,OAAO,EAAE;QACjC,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,MAAM,CAAC,EAAE,UAAU,EAAE,CAAC;QACtB,KAAK,CAAC,EAAE,OAAO,CAAC;KACjB,GAAG,OAAO,CAAC,MAAM,CAAC;IA+BnB;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC;CAevC;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,qBAAqB,GAAG,cAAc,CAEnF"}

package/dist/generators/skills/skillGenerator.js

@@ -0,0 +1,158 @@
+"use strict";
+/**
+ * Skill Generator
+ *
+ * Scaffolds skill directories and SKILL.md files.
+ * Generates frontmatter-only files (scaffold v2) for AI to fill.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SkillGenerator = void 0;
+exports.createSkillGenerator = createSkillGenerator;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const skills_1 = require("../../workflow/skills");
+const skillTemplate_1 = require("./templates/skillTemplate");
+const indexTemplate_1 = require("./templates/indexTemplate");
+const scaffoldFrontmatter_1 = require("../../types/scaffoldFrontmatter");
+class SkillGenerator {
+    constructor(options) {
+        this.repoPath = options.repoPath;
+        this.outputDir = options.outputDir || '.context';
+        this.skillsDir = path.join(this.repoPath, this.outputDir, 'skills');
+    }
+    /**
+     * Generate skills directory with selected skills
+     */
+    async generate(options = {}) {
+        const { skills = [...skills_1.BUILT_IN_SKILLS], force = false } = options;
+        // Create skills directory
+        fs.mkdirSync(this.skillsDir, { recursive: true });
+        const generatedSkills = [];
+        const skippedSkills = [];
+        const templates = (0, skills_1.getBuiltInSkillTemplates)();
+        for (const skillName of skills) {
+            const skillDir = path.join(this.skillsDir, skillName);
+            const skillPath = path.join(skillDir, 'SKILL.md');
+            // Check if skill already exists
+            if (fs.existsSync(skillPath) && !force) {
+                skippedSkills.push(skillName);
+                continue;
+            }
+            // Create skill directory
+            fs.mkdirSync(skillDir, { recursive: true });
+            // Generate frontmatter-only content (scaffold v2)
+            let description;
+            let phases;
+            if ((0, skills_1.isBuiltInSkill)(skillName)) {
+                // Use built-in template description
+                const template = templates[skillName];
+                description = template.description;
+                phases = skills_1.SKILL_TO_PHASES[skillName];
+            }
+            else {
+                // Default description for custom skill
+                description = `On-demand expertise for ${skillName}`;
+                phases = (0, skillTemplate_1.getDefaultPhases)(skillName);
+            }
+            // Create frontmatter-only content
+            const frontmatter = (0, scaffoldFrontmatter_1.createSkillFrontmatter)(this.formatSkillTitle(skillName), description, skillName, { phases });
+            const content = (0, scaffoldFrontmatter_1.serializeFrontmatter)(frontmatter) + '\n';
+            // Write SKILL.md
+            fs.writeFileSync(skillPath, content, 'utf-8');
+            generatedSkills.push(skillName);
+        }
+        // Generate index README
+        const indexPath = await this.generateIndex();
+        return {
+            skillsDir: this.skillsDir,
+            generatedSkills,
+            skippedSkills,
+            indexPath,
+        };
+    }
+    /**
+     * Format skill name as display title
+     */
+    formatSkillTitle(skillName) {
+        return skillName
+            .split('-')
+            .map(word => word.charAt(0).toUpperCase() + word.slice(1))
+            .join(' ');
+    }
+    /**
+     * Generate a single custom skill
+     */
+    async generateCustomSkill(options) {
+        const { name, description, phases = ['E'], force = false } = options;
+        const skillDir = path.join(this.skillsDir, name);
+        const skillPath = path.join(skillDir, 'SKILL.md');
+        if (fs.existsSync(skillPath) && !force) {
+            throw new Error(`Skill ${name} already exists. Use --force to overwrite.`);
+        }
+        // Create skill directory
+        fs.mkdirSync(skillDir, { recursive: true });
+        // Generate frontmatter-only content (scaffold v2)
+        const frontmatter = (0, scaffoldFrontmatter_1.createSkillFrontmatter)(this.formatSkillTitle(name), description, name, { phases });
+        const content = (0, scaffoldFrontmatter_1.serializeFrontmatter)(frontmatter) + '\n';
+        // Write SKILL.md
+        fs.writeFileSync(skillPath, content, 'utf-8');
+        // Update index
+        await this.generateIndex();
+        return skillPath;
+    }
+    /**
+     * Generate README.md index
+     */
+    async generateIndex() {
+        const registry = (0, skills_1.createSkillRegistry)(this.repoPath);
+        const discovered = await registry.discoverAll();
+        const content = (0, indexTemplate_1.generateSkillsIndex)({
+            skills: discovered.all,
+            projectName: path.basename(this.repoPath),
+        });
+        const indexPath = path.join(this.skillsDir, 'README.md');
+        fs.writeFileSync(indexPath, content, 'utf-8');
+        return indexPath;
+    }
+}
+exports.SkillGenerator = SkillGenerator;
+/**
+ * Factory function
+ */
+function createSkillGenerator(options) {
+    return new SkillGenerator(options);
+}
+//# sourceMappingURL=skillGenerator.js.map

package/dist/generators/skills/skillGenerator.js.map

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

package/dist/generators/skills/templates/indexTemplate.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Skills Index (README.md) Template
+ */
+import { Skill } from '../../../workflow/skills';
+export interface SkillsIndexOptions {
+    skills: Skill[];
+    projectName?: string;
+}
+/**
+ * Generate README.md for skills directory
+ */
+export declare function generateSkillsIndex(options: SkillsIndexOptions): string;
+//# sourceMappingURL=indexTemplate.d.ts.map

package/dist/generators/skills/templates/indexTemplate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexTemplate.d.ts","sourceRoot":"","sources":["../../../../src/generators/skills/templates/indexTemplate.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;AAEjD,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,kBAAkB,GAAG,MAAM,CAuGvE"}

package/dist/generators/skills/templates/indexTemplate.js

@@ -0,0 +1,102 @@
+"use strict";
+/**
+ * Skills Index (README.md) Template
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateSkillsIndex = generateSkillsIndex;
+/**
+ * Generate README.md for skills directory
+ */
+function generateSkillsIndex(options) {
+    const { skills, projectName } = options;
+    const builtIn = skills.filter((s) => s.isBuiltIn);
+    const custom = skills.filter((s) => !s.isBuiltIn);
+    let content = `# Skills
+
+On-demand expertise for AI agents. Skills are task-specific procedures that get activated when relevant.
+
+`;
+    if (projectName) {
+        content += `> Project: ${projectName}\n\n`;
+    }
+    content += `## How Skills Work
+
+1. **Discovery**: AI agents discover available skills
+2. **Matching**: When a task matches a skill's description, it's activated
+3. **Execution**: The skill's instructions guide the AI's behavior
+
+## Available Skills
+
+`;
+    if (builtIn.length > 0) {
+        content += `### Built-in Skills
+
+| Skill | Description | Phases |
+|-------|-------------|--------|
+`;
+        for (const skill of builtIn) {
+            const phases = skill.metadata.phases?.join(', ') || '-';
+            content += `| [${skill.metadata.name}](./${skill.slug}/SKILL.md) | ${skill.metadata.description} | ${phases} |\n`;
+        }
+        content += '\n';
+    }
+    if (custom.length > 0) {
+        content += `### Custom Skills
+
+| Skill | Description | Phases |
+|-------|-------------|--------|
+`;
+        for (const skill of custom) {
+            const phases = skill.metadata.phases?.join(', ') || '-';
+            content += `| [${skill.metadata.name}](./${skill.slug}/SKILL.md) | ${skill.metadata.description} | ${phases} |\n`;
+        }
+        content += '\n';
+    }
+    content += `## Creating Custom Skills
+
+Create a new skill by adding a directory with a \`SKILL.md\` file:
+
+\`\`\`
+.context/skills/
+└── my-skill/
+    ├── SKILL.md          # Required: skill definition
+    └── templates/        # Optional: helper resources
+        └── checklist.md
+\`\`\`
+
+### SKILL.md Format
+
+\`\`\`yaml
+---
+name: my-skill
+description: When to use this skill
+phases: [P, E, V]  # Optional: PREVC phases
+mode: false        # Optional: mode command?
+---
+
+# My Skill
+
+## When to Use
+[Description of when this skill applies]
+
+## Instructions
+1. Step one
+2. Step two
+
+## Examples
+[Usage examples]
+\`\`\`
+
+## PREVC Phase Mapping
+
+| Phase | Name | Skills |
+|-------|------|--------|
+| P | Planning | feature-breakdown, documentation, api-design |
+| R | Review | pr-review, code-review, api-design, security-audit |
+| E | Execution | commit-message, test-generation, refactoring, bug-investigation |
+| V | Validation | pr-review, code-review, test-generation, security-audit |
+| C | Confirmation | commit-message, documentation |
+`;
+    return content;
+}
+//# sourceMappingURL=indexTemplate.js.map

package/dist/generators/skills/templates/indexTemplate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexTemplate.js","sourceRoot":"","sources":["../../../../src/generators/skills/templates/indexTemplate.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAYH,kDAuGC;AA1GD;;GAEG;AACH,SAAgB,mBAAmB,CAAC,OAA2B;IAC7D,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC;IAExC,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAClD,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAElD,IAAI,OAAO,GAAG;;;;CAIf,CAAC;IAEA,IAAI,WAAW,EAAE,CAAC;QAChB,OAAO,IAAI,cAAc,WAAW,MAAM,CAAC;IAC7C,CAAC;IAED,OAAO,IAAI;;;;;;;;CAQZ,CAAC;IAEA,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO,IAAI;;;;CAId,CAAC;QAEE,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,MAAM,MAAM,GAAG,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC;YACxD,OAAO,IAAI,MAAM,KAAK,CAAC,QAAQ,CAAC,IAAI,OAAO,KAAK,CAAC,IAAI,gBAAgB,KAAK,CAAC,QAAQ,CAAC,WAAW,MAAM,MAAM,MAAM,CAAC;QACpH,CAAC;QAED,OAAO,IAAI,IAAI,CAAC;IAClB,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,OAAO,IAAI;;;;CAId,CAAC;QAEE,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,MAAM,MAAM,GAAG,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC;YACxD,OAAO,IAAI,MAAM,KAAK,CAAC,QAAQ,CAAC,IAAI,OAAO,KAAK,CAAC,IAAI,gBAAgB,KAAK,CAAC,QAAQ,CAAC,WAAW,MAAM,MAAM,MAAM,CAAC;QACpH,CAAC;QAED,OAAO,IAAI,IAAI,CAAC;IAClB,CAAC;IAED,OAAO,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4CZ,CAAC;IAEA,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/generators/skills/templates/skillTemplate.d.ts

@@ -0,0 +1,30 @@
+/**
+ * SKILL.md Template
+ *
+ * REFERENCE ONLY - This file is not used by generators anymore.
+ *
+ * Scaffold structures are now defined in:
+ * src/generators/shared/scaffoldStructures.ts
+ *
+ * This file serves as historical reference for the structure/content
+ * that should be generated for this skill type.
+ *
+ * @deprecated Since v2.0.0 scaffold system
+ */
+import { PrevcPhase } from '../../../workflow/types';
+export interface SkillTemplateOptions {
+    name: string;
+    description: string;
+    phases?: PrevcPhase[];
+    mode?: boolean;
+    disableModelInvocation?: boolean;
+}
+/**
+ * Generate SKILL.md content
+ */
+export declare function generateSkillContent(options: SkillTemplateOptions): string;
+/**
+ * Get default phases for a skill name
+ */
+export declare function getDefaultPhases(skillName: string): PrevcPhase[];
+//# sourceMappingURL=skillTemplate.d.ts.map

package/dist/generators/skills/templates/skillTemplate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skillTemplate.d.ts","sourceRoot":"","sources":["../../../../src/generators/skills/templates/skillTemplate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAErD,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,UAAU,EAAE,CAAC;IACtB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,sBAAsB,CAAC,EAAE,OAAO,CAAC;CAClC;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,oBAAoB,GAAG,MAAM,CAc1E;AA+DD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU,EAAE,CAKhE"}

package/dist/generators/skills/templates/skillTemplate.js

@@ -0,0 +1,95 @@
+"use strict";
+/**
+ * SKILL.md Template
+ *
+ * REFERENCE ONLY - This file is not used by generators anymore.
+ *
+ * Scaffold structures are now defined in:
+ * src/generators/shared/scaffoldStructures.ts
+ *
+ * This file serves as historical reference for the structure/content
+ * that should be generated for this skill type.
+ *
+ * @deprecated Since v2.0.0 scaffold system
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateSkillContent = generateSkillContent;
+exports.getDefaultPhases = getDefaultPhases;
+const skills_1 = require("../../../workflow/skills");
+/**
+ * Generate SKILL.md content
+ */
+function generateSkillContent(options) {
+    const { name, description, phases, mode, disableModelInvocation } = options;
+    const frontmatter = buildFrontmatter({
+        name,
+        description,
+        phases,
+        mode,
+        disableModelInvocation,
+    });
+    const body = buildBody(name, description);
+    return `${frontmatter}\n\n${body}`;
+}
+function buildFrontmatter(options) {
+    const lines = ['---'];
+    lines.push(`name: ${options.name}`);
+    lines.push(`description: ${options.description}`);
+    if (options.phases && options.phases.length > 0) {
+        lines.push(`phases: [${options.phases.join(', ')}]`);
+    }
+    if (options.mode !== undefined) {
+        lines.push(`mode: ${options.mode}`);
+    }
+    if (options.disableModelInvocation !== undefined) {
+        lines.push(`disable-model-invocation: ${options.disableModelInvocation}`);
+    }
+    lines.push('---');
+    return lines.join('\n');
+}
+function buildBody(name, description) {
+    const title = name
+        .split('-')
+        .map((word) => word.charAt(0).toUpperCase() + word.slice(1))
+        .join(' ');
+    return `# ${title}
+
+## When to Use
+
+${description}
+
+## Instructions
+
+<!-- TODO: Add step-by-step instructions for this skill -->
+
+1. First step
+2. Second step
+3. Third step
+
+## Examples
+
+<!-- TODO: Add examples of how to use this skill -->
+
+\`\`\`
+Example usage here
+\`\`\`
+
+## Guidelines
+
+<!-- TODO: Add guidelines and best practices -->
+
+- Guideline 1
+- Guideline 2
+- Guideline 3
+`;
+}
+/**
+ * Get default phases for a skill name
+ */
+function getDefaultPhases(skillName) {
+    if ((0, skills_1.isBuiltInSkill)(skillName)) {
+        return skills_1.SKILL_TO_PHASES[skillName];
+    }
+    return ['E']; // Default to Execution phase
+}
+//# sourceMappingURL=skillTemplate.js.map

package/dist/generators/skills/templates/skillTemplate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skillTemplate.js","sourceRoot":"","sources":["../../../../src/generators/skills/templates/skillTemplate.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;GAYG;;AAgBH,oDAcC;AAkED,4CAKC;AAnGD,qDAA4G;AAW5G;;GAEG;AACH,SAAgB,oBAAoB,CAAC,OAA6B;IAChE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,sBAAsB,EAAE,GAAG,OAAO,CAAC;IAE5E,MAAM,WAAW,GAAG,gBAAgB,CAAC;QACnC,IAAI;QACJ,WAAW;QACX,MAAM;QACN,IAAI;QACJ,sBAAsB;KACvB,CAAC,CAAC;IAEH,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IAE1C,OAAO,GAAG,WAAW,OAAO,IAAI,EAAE,CAAC;AACrC,CAAC;AAED,SAAS,gBAAgB,CAAC,OAA6B;IACrD,MAAM,KAAK,GAAa,CAAC,KAAK,CAAC,CAAC;IAEhC,KAAK,CAAC,IAAI,CAAC,SAAS,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IACpC,KAAK,CAAC,IAAI,CAAC,gBAAgB,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAElD,IAAI,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChD,KAAK,CAAC,IAAI,CAAC,YAAY,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACvD,CAAC;IAED,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC/B,KAAK,CAAC,IAAI,CAAC,SAAS,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IACtC,CAAC;IAED,IAAI,OAAO,CAAC,sBAAsB,KAAK,SAAS,EAAE,CAAC;QACjD,KAAK,CAAC,IAAI,CAAC,6BAA6B,OAAO,CAAC,sBAAsB,EAAE,CAAC,CAAC;IAC5E,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAElB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,SAAS,CAAC,IAAY,EAAE,WAAmB;IAClD,MAAM,KAAK,GAAG,IAAI;SACf,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;SAC3D,IAAI,CAAC,GAAG,CAAC,CAAC;IAEb,OAAO,KAAK,KAAK;;;;EAIjB,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;CAyBZ,CAAC;AACF,CAAC;AAED;;GAEG;AACH,SAAgB,gBAAgB,CAAC,SAAiB;IAChD,IAAI,IAAA,uBAAc,EAAC,SAAS,CAAC,EAAE,CAAC;QAC9B,OAAO,wBAAe,CAAC,SAA6B,CAAC,CAAC;IACxD,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,6BAA6B;AAC7C,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}