@dedesfr/prompter 0.3.6 → 0.3.7

package/src/commands/skill-creator.ts

@@ -0,0 +1,123 @@
+import { promises as fs } from 'fs';
+import path from 'path';
+import chalk from 'chalk';
+import { PrompterConfig, PROMPTER_DIR, PROMPTER_MARKERS } from '../core/config.js';
+import { registry } from '../core/configurators/slash/index.js';
+
+interface SkillCreatorOptions {
+    tools?: string[];
+    noInteractive?: boolean;
+}
+
+export class SkillCreatorCommand {
+    async execute(options: SkillCreatorOptions = {}): Promise<void> {
+        const projectPath = process.cwd();
+
+        // Check if initialized
+        if (!await PrompterConfig.prompterDirExists(projectPath)) {
+            console.log(chalk.red('\n❌ Prompter is not initialized in this project.\n'));
+            console.log(chalk.gray('   Run `prompter init` first.\n'));
+            process.exitCode = 1;
+            return;
+        }
+
+        console.log(chalk.blue('\n🛠️  Generating skill-creator workflow files...\n'));
+
+        // Ensure skills directory exists
+        const skillsPath = path.join(projectPath, PROMPTER_DIR, 'skills');
+        await fs.mkdir(skillsPath, { recursive: true });
+        console.log(chalk.green('✓') + ` Ensured ${chalk.cyan(PROMPTER_DIR + '/skills/')} directory exists`);
+
+        // Detect currently configured tools
+        const configuredTools = await this.detectConfiguredTools(projectPath);
+        
+        if (configuredTools.length === 0) {
+            console.log(chalk.yellow('\n⚠️  No tools configured yet.\n'));
+            console.log(chalk.gray('   Run `prompter init` to configure AI tools first.\n'));
+            process.exitCode = 1;
+            return;
+        }
+
+        // Generate skill-creator workflow files for all configured tools
+        let successCount = 0;
+        let failCount = 0;
+
+        for (const toolId of configuredTools) {
+            const configurator = registry.get(toolId);
+            if (configurator) {
+                try {
+                    // Generate only the skill-creator workflow file
+                    const body = configurator['getBody']('skill-creator');
+                    const relativePath = configurator['getRelativePath']('skill-creator');
+                    const filePath = path.join(projectPath, relativePath);
+                    
+                    // Ensure directory exists
+                    await fs.mkdir(path.dirname(filePath), { recursive: true });
+                    
+                    // Check if file exists
+                    const fileExists = await this.fileExists(filePath);
+                    
+                    if (fileExists) {
+                        console.log(chalk.yellow('⚠️') + ` ${chalk.cyan(relativePath)} already exists, skipping`);
+                        continue;
+                    }
+                    
+                    // Get frontmatter if needed
+                    const frontmatter = configurator['getFrontmatter']('skill-creator');
+                    const sections: string[] = [];
+                    if (frontmatter) {
+                        sections.push(frontmatter.trim());
+                    }
+                    sections.push(`${PROMPTER_MARKERS.start}\n${body}\n${PROMPTER_MARKERS.end}`);
+                    const content = sections.join('\n') + '\n';
+                    
+                    await fs.writeFile(filePath, content, 'utf-8');
+                    console.log(chalk.green('✓') + ` Created ${chalk.cyan(relativePath)}`);
+                    successCount++;
+                } catch (error) {
+                    console.log(chalk.red('✗') + ` Failed to create files for ${toolId}: ${error}`);
+                    failCount++;
+                }
+            }
+        }
+
+        // Success message
+        console.log(chalk.green(`\n✅ Skill creator workflow files created successfully!\n`));
+        console.log(chalk.blue('Next steps:'));
+        console.log(chalk.gray('  1. Use /skill-creator in your AI tool to create skills'));
+        console.log(chalk.gray('  2. Skills will be saved to prompter/skills/<skill-name>/\n'));
+    }
+
+    private async fileExists(filePath: string): Promise<boolean> {
+        try {
+            await fs.access(filePath);
+            return true;
+        } catch {
+            return false;
+        }
+    }
+
+    private async detectConfiguredTools(projectPath: string): Promise<string[]> {
+        const configuredTools: string[] = [];
+        const allConfigurators = registry.getAll();
+
+        for (const configurator of allConfigurators) {
+            const targets = configurator.getTargets();
+            let hasFiles = false;
+
+            for (const target of targets) {
+                const filePath = path.join(projectPath, target.path);
+                if (await this.fileExists(filePath)) {
+                    hasFiles = true;
+                    break;
+                }
+            }
+
+            if (hasFiles) {
+                configuredTools.push(configurator.toolId);
+            }
+        }
+
+        return configuredTools;
+    }
+}

package/src/core/configurators/slash/antigravity.ts

@@ -6,7 +6,8 @@ const FILE_PATHS: Record<SlashCommandId, string> = {
     'prd-generator': '.agent/workflows/prd-generator.md',
     'epic-single': '.agent/workflows/epic-single.md',
     'story-single': '.agent/workflows/story-single.md',
-    'qa-test-scenario': '.agent/workflows/qa-test-scenario.md'
+    'qa-test-scenario': '.agent/workflows/qa-test-scenario.md',
+    'skill-creator': '.agent/workflows/skill-creator.md'
 };
 
 const DESCRIPTIONS: Record<SlashCommandId, string> = {
@@ -14,7 +15,8 @@ const DESCRIPTIONS: Record<SlashCommandId, string> = {
     'prd-generator': 'Generate a comprehensive Product Requirements Document (PRD)',
     'epic-single': 'Generate a single well-defined Jira Epic',
     'story-single': 'Generate a single Jira User Story from requirements',
-    'qa-test-scenario': 'Generate focused QA test scenarios from PRD'
+    'qa-test-scenario': 'Generate focused QA test scenarios from PRD',
+    'skill-creator': 'Create a modular skill package that extends AI agent capabilities'
 };
 
 export class AntigravityConfigurator extends SlashCommandConfigurator {

package/src/core/configurators/slash/base.ts

@@ -9,7 +9,7 @@ export interface SlashCommandTarget {
     kind: 'slash';
 }
 
-const ALL_COMMANDS: SlashCommandId[] = ['enhance', 'prd-generator', 'epic-single', 'story-single', 'qa-test-scenario'];
+const ALL_COMMANDS: SlashCommandId[] = ['enhance', 'prd-generator', 'epic-single', 'story-single', 'qa-test-scenario', 'skill-creator'];
 
 export abstract class SlashCommandConfigurator {
     abstract readonly toolId: string;

package/src/core/configurators/slash/claude.ts

@@ -6,7 +6,8 @@ const FILE_PATHS: Record<SlashCommandId, string> = {
     'prd-generator': '.claude/commands/prompter/prd-generator.md',
     'epic-single': '.claude/commands/prompter/epic-single.md',
     'story-single': '.claude/commands/prompter/story-single.md',
-    'qa-test-scenario': '.claude/commands/prompter/qa-test-scenario.md'
+    'qa-test-scenario': '.claude/commands/prompter/qa-test-scenario.md',
+    'skill-creator': '.claude/commands/prompter/skill-creator.md'
 };
 
 const DESCRIPTIONS: Record<SlashCommandId, string> = {
@@ -14,7 +15,8 @@ const DESCRIPTIONS: Record<SlashCommandId, string> = {
     'prd-generator': 'Generate a comprehensive Product Requirements Document (PRD)',
     'epic-single': 'Generate a single well-defined Jira Epic',
     'story-single': 'Generate a single Jira User Story from requirements',
-    'qa-test-scenario': 'Generate focused QA test scenarios from PRD'
+    'qa-test-scenario': 'Generate focused QA test scenarios from PRD',
+    'skill-creator': 'Create a modular skill package that extends AI agent capabilities'
 };
 
 export class ClaudeConfigurator extends SlashCommandConfigurator {

package/src/core/configurators/slash/codex.ts

@@ -6,7 +6,8 @@ const FILE_PATHS: Record<SlashCommandId, string> = {
     'prd-generator': '.codex/prompts/prd-generator.md',
     'epic-single': '.codex/prompts/epic-single.md',
     'story-single': '.codex/prompts/story-single.md',
-    'qa-test-scenario': '.codex/prompts/qa-test-scenario.md'
+    'qa-test-scenario': '.codex/prompts/qa-test-scenario.md',
+    'skill-creator': '.codex/prompts/skill-creator.md'
 };
 
 const DESCRIPTIONS: Record<SlashCommandId, string> = {
@@ -14,7 +15,8 @@ const DESCRIPTIONS: Record<SlashCommandId, string> = {
     'prd-generator': 'Generate a comprehensive Product Requirements Document (PRD)',
     'epic-single': 'Generate a single well-defined Jira Epic',
     'story-single': 'Generate a single Jira User Story from requirements',
-    'qa-test-scenario': 'Generate focused QA test scenarios from PRD'
+    'qa-test-scenario': 'Generate focused QA test scenarios from PRD',
+    'skill-creator': 'Create a modular skill package that extends AI agent capabilities'
 };
 
 export class CodexConfigurator extends SlashCommandConfigurator {

package/src/core/configurators/slash/github-copilot.ts

@@ -9,7 +9,8 @@ const FILE_PATHS: Record<SlashCommandId, string> = {
     'prd-generator': '.github/prompts/prd-generator.prompt.md',
     'epic-single': '.github/prompts/epic-single.prompt.md',
     'story-single': '.github/prompts/story-single.prompt.md',
-    'qa-test-scenario': '.github/prompts/qa-test-scenario.prompt.md'
+    'qa-test-scenario': '.github/prompts/qa-test-scenario.prompt.md',
+    'skill-creator': '.github/prompts/skill-creator.prompt.md'
 };
 
 const DESCRIPTIONS: Record<SlashCommandId, string> = {
@@ -17,7 +18,8 @@ const DESCRIPTIONS: Record<SlashCommandId, string> = {
     'prd-generator': 'Generate a comprehensive Product Requirements Document (PRD)',
     'epic-single': 'Generate a single well-defined Jira Epic',
     'story-single': 'Generate a single Jira User Story from requirements',
-    'qa-test-scenario': 'Generate focused QA test scenarios from PRD'
+    'qa-test-scenario': 'Generate focused QA test scenarios from PRD',
+    'skill-creator': 'Create a modular skill package that extends AI agent capabilities'
 };
 
 export class GithubCopilotConfigurator extends SlashCommandConfigurator {

package/src/core/configurators/slash/kilocode.ts

@@ -6,7 +6,8 @@ const FILE_PATHS: Record<SlashCommandId, string> = {
     'prd-generator': '.kilocode/workflows/prd-generator.md',
     'epic-single': '.kilocode/workflows/epic-single.md',
     'story-single': '.kilocode/workflows/story-single.md',
-    'qa-test-scenario': '.kilocode/workflows/qa-test-scenario.md'
+    'qa-test-scenario': '.kilocode/workflows/qa-test-scenario.md',
+    'skill-creator': '.kilocode/workflows/skill-creator.md'
 };
 
 const DESCRIPTIONS: Record<SlashCommandId, string> = {
@@ -14,7 +15,8 @@ const DESCRIPTIONS: Record<SlashCommandId, string> = {
     'prd-generator': 'Generate a comprehensive Product Requirements Document (PRD)',
     'epic-single': 'Generate a single well-defined Jira Epic',
     'story-single': 'Generate a single Jira User Story from requirements',
-    'qa-test-scenario': 'Generate focused QA test scenarios from PRD'
+    'qa-test-scenario': 'Generate focused QA test scenarios from PRD',
+    'skill-creator': 'Create a modular skill package that extends AI agent capabilities'
 };
 
 export class KiloCodeConfigurator extends SlashCommandConfigurator {

package/src/core/configurators/slash/opencode.ts

@@ -6,7 +6,8 @@ const FILE_PATHS: Record<SlashCommandId, string> = {
     'prd-generator': '.opencode/prompts/prd-generator.md',
     'epic-single': '.opencode/prompts/epic-single.md',
     'story-single': '.opencode/prompts/story-single.md',
-    'qa-test-scenario': '.opencode/prompts/qa-test-scenario.md'
+    'qa-test-scenario': '.opencode/prompts/qa-test-scenario.md',
+    'skill-creator': '.opencode/prompts/skill-creator.md'
 };
 
 const DESCRIPTIONS: Record<SlashCommandId, string> = {
@@ -14,7 +15,8 @@ const DESCRIPTIONS: Record<SlashCommandId, string> = {
     'prd-generator': 'Generate a comprehensive Product Requirements Document (PRD)',
     'epic-single': 'Generate a single well-defined Jira Epic',
     'story-single': 'Generate a single Jira User Story from requirements',
-    'qa-test-scenario': 'Generate focused QA test scenarios from PRD'
+    'qa-test-scenario': 'Generate focused QA test scenarios from PRD',
+    'skill-creator': 'Create a modular skill package that extends AI agent capabilities'
 };
 
 export class OpenCodeConfigurator extends SlashCommandConfigurator {

package/src/core/templates/slash-command-templates.ts

@@ -1,4 +1,4 @@
-export type SlashCommandId = 'enhance' | 'prd-generator' | 'epic-single' | 'story-single' | 'qa-test-scenario';
+export type SlashCommandId = 'enhance' | 'prd-generator' | 'epic-single' | 'story-single' | 'qa-test-scenario' | 'skill-creator';
 
 const enhanceWorkflow = `## MUST FOLLOW
 - Response Language: {User Request Language}
@@ -536,12 +536,182 @@ Generate a **concise** testing document (targeting 50-150 lines for simple featu
 ## REFERENCE
 - Read \`prompter/project.md\` for project context if needed`;
 
+const skillCreatorWorkflow = `# Role & Expertise
+You are an expert Skill Creator specializing in designing modular, self-contained packages that extend AI agent capabilities. You have deep expertise in procedural knowledge extraction, workflow design, and context-efficient documentation.
+
+---
+
+# Primary Objective
+Create a complete, professional Skill package that transforms a general-purpose AI agent into a specialized agent equipped with domain-specific knowledge, workflows, and tools. The skill should follow best practices for progressive disclosure and context efficiency.
+
+# Context
+Skills are "onboarding guides" for specific domains or tasks. They provide:
+1. Specialized workflows - Multi-step procedures for specific domains
+2. Tool integrations - Instructions for working with specific file formats or APIs
+3. Domain expertise - Company-specific knowledge, schemas, business logic
+4. Bundled resources - Scripts, references, and assets for complex and repetitive tasks
+
+# Core Principles to Follow
+
+## Concise is Key
+- Context window is a public good shared with system prompts, history, and other skills
+- Only add context the AI doesn't already have
+- Challenge each piece: "Does this justify its token cost?"
+- Prefer concise examples over verbose explanations
+
+## Set Appropriate Degrees of Freedom
+- **High freedom (text-based)**: Multiple valid approaches, context-dependent decisions
+- **Medium freedom (pseudocode/scripts with params)**: Preferred pattern exists, some variation ok
+- **Low freedom (specific scripts)**: Fragile operations, consistency critical, specific sequence required
+
+## Progressive Disclosure
+1. **Metadata (name + description)** - Always in context (~100 words)
+2. **SKILL.md body** - When skill triggers (<5k words, <500 lines)
+3. **Bundled resources** - As needed (scripts, references, assets)
+
+# Process
+
+## Step 1: Gather Requirements
+Ask clarifying questions to understand:
+- What functionality should the skill support?
+- Concrete examples of how the skill would be used
+- What would a user say that should trigger this skill?
+- Any existing resources, scripts, or documentation to include
+
+## Step 2: Plan Skill Contents
+Analyze each example to identify:
+- **Scripts** (\`scripts/\`): Reusable code for repetitive or fragile tasks
+- **References** (\`references/\`): Documentation loaded as needed
+- **Assets** (\`assets/\`): Files used in output (templates, images, etc.)
+
+## Step 3: Create Skill Structure
+Create the skill directory in \`prompter/skills/<skill-name>/\`:
+
+\`\`\`
+prompter/skills/<skill-name>/
+├── SKILL.md (required)
+└── [optional bundled resources]
+    ├── scripts/
+    ├── references/
+    └── assets/
+\`\`\`
+
+## Step 4: Write SKILL.md
+
+### Frontmatter (YAML)
+\`\`\`yaml
+---
+name: <skill-name>
+description: <comprehensive description of what the skill does AND when to use it>
+---
+\`\`\`
+
+### Body (Markdown)
+- Instructions for using the skill and its bundled resources
+- Keep under 500 lines
+- Use progressive disclosure patterns for large content
+- Reference bundled files with clear "when to read" guidance
+
+### Writing Guidelines
+- Always use imperative/infinitive form
+- Include only information beneficial and non-obvious to Claude
+- Focus on procedural knowledge, domain-specific details, reusable assets
+
+## Step 5: Create Bundled Resources (if needed)
+
+### Scripts
+- Executable code for deterministic reliability
+- Test scripts before including
+- Example: \`scripts/rotate_pdf.py\` for PDF rotation
+
+### References
+- Documentation loaded into context as needed
+- For files >10k words, include grep search patterns in SKILL.md
+- Examples: schemas, API docs, policies, detailed guides
+
+### Assets
+- Files NOT loaded into context, used in output
+- Examples: templates, images, fonts, boilerplate
+
+## Step 6: Validate Skill
+
+Verify:
+- [ ] SKILL.md has valid YAML frontmatter with name and description
+- [ ] Description clearly states what skill does AND when to use it
+- [ ] Body is under 500 lines
+- [ ] No extraneous files (README, CHANGELOG, etc.)
+- [ ] All bundled resources are referenced in SKILL.md
+- [ ] Scripts are tested and working
+
+# Output Requirements
+
+**Structure:**
+\`\`\`
+prompter/skills/<skill-name>/
+├── SKILL.md
+└── [optional: scripts/, references/, assets/]
+\`\`\`
+
+**SKILL.md Format:**
+\`\`\`markdown
+---
+name: skill-name
+description: Comprehensive description including what it does and when to use it
+---
+
+# Skill Title
+
+## Quick Start
+[Essential usage instructions]
+
+## Workflows
+[Multi-step procedures]
+
+## Resources
+[References to bundled files with usage guidance]
+\`\`\`
+
+# What NOT to Include
+- README.md, INSTALLATION_GUIDE.md, QUICK_REFERENCE.md, CHANGELOG.md
+- Auxiliary context about creation process
+- Setup and testing procedures
+- User-facing documentation separate from SKILL.md
+
+# Progressive Disclosure Patterns
+
+**Pattern 1: High-level guide with references**
+\`\`\`markdown
+## Advanced features
+- **Forms**: See [FORMS.md](references/forms.md) for complete guide
+- **API**: See [REFERENCE.md](references/reference.md) for all methods
+\`\`\`
+
+**Pattern 2: Domain-specific organization**
+Organize by domain to avoid loading irrelevant context.
+
+**Pattern 3: Conditional details**
+Show basic content, link to advanced content only when needed.
+
+## WORKFLOW STEPS
+1. Read the user's input and requirements
+2. Ask clarifying questions if needed
+3. Generate a URL-friendly skill name (lowercase, hyphen-separated)
+4. Create the directory \`prompter/skills/<skill-name>/\`
+5. Generate SKILL.md with proper frontmatter and body
+6. Create any needed bundled resources (scripts, references, assets)
+7. Report the created skill structure and next steps
+
+## REFERENCE
+- Skills are saved to \`prompter/skills/<skill-name>/\`
+- Read \`prompter/project.md\` for project context if needed`;
+
 export const slashCommandBodies: Record<SlashCommandId, string> = {
     enhance: enhanceWorkflow,
     'prd-generator': prdGeneratorWorkflow,
     'epic-single': epicSingleWorkflow,
     'story-single': storySingleWorkflow,
-    'qa-test-scenario': qaTestScenarioWorkflow
+    'qa-test-scenario': qaTestScenarioWorkflow,
+    'skill-creator': skillCreatorWorkflow
 };
 
 export function getSlashCommandBody(id: SlashCommandId): string {