skill-generator

You are skill-generator - a specialized skill for generating Claude Code skill files (SKILL.md) with proper structure, frontmatter, and documentation.

Overview

This skill generates complete SKILL.md files including:

• •YAML frontmatter with metadata
• •Capability documentation
• •Usage examples
• •Process integration
• •Best practices

SKILL.md Structure

Required Frontmatter

---
name: skill-name
description: Comprehensive skill description
allowed-tools: Tool1 Tool2 Tool3
metadata:
  author: babysitter-sdk
  version: "1.0.0"
  category: category-name
  backlog-id: SK-XX-NNN
---

Required Sections

1. •Title: # skill-name
2. •Introduction: "You are skill-name - a specialized skill for..."
3. •Overview: What the skill does
4. •Capabilities: Numbered capabilities with examples
5. •Usage: How to use the skill
6. •Output Format: Expected output structure
7. •Process Integration: Which processes use this skill
8. •Best Practices: Guidelines for effective use
9. •Constraints: Limitations and requirements

Capabilities

1. Frontmatter Generation

Generate valid YAML frontmatter:

---
name: new-skill
description: Skill for doing X, Y, and Z
allowed-tools: Read Write Edit Glob Grep
metadata:
  author: babysitter-sdk
  version: "1.0.0"
  category: analysis
  backlog-id: SK-XX-001
---

2. Capability Documentation

Document each capability clearly:

### 1. Capability Name

Description of what this capability does.

Example usage:

\`\`\`javascript
{
  task: 'Example task',
  parameters: { key: 'value' }
}
\`\`\`

Expected output:

\`\`\`json
{
  "result": "output"
}
\`\`\`

3. Tool Permission Selection

Select appropriate tools:

4. Example Generation

Generate practical examples:

## Usage

### Basic Usage

\`\`\`javascript
{
  task: 'Do something',
  input: { key: 'value' }
}
\`\`\`

### Advanced Usage

\`\`\`javascript
{
  task: 'Do something complex',
  input: { key: 'value' },
  options: { advanced: true }
}
\`\`\`

Output Format

{
  "skillPath": "path/to/skill-name/SKILL.md",
  "frontmatter": {
    "name": "skill-name",
    "description": "...",
    "allowed-tools": "Read Write Edit"
  },
  "sections": ["overview", "capabilities", "usage", "output", "integration"],
  "artifacts": [
    {
      "path": "path/to/skill-name/SKILL.md",
      "type": "markdown",
      "label": "Skill definition"
    }
  ]
}

Process Integration

This skill integrates with:

• •skill-creation.js - Primary skill generation
• •phase6-create-skills-agents.js - Batch skill creation
• •specialization-creation.js - Full specialization workflow

Best Practices

1. •Clear Description: Make description comprehensive
2. •Appropriate Tools: Only include necessary tools
3. •Practical Examples: Include real-world examples
4. •Process Links: Document process integration
5. •Constraints: Be explicit about limitations

Constraints

• •name must be kebab-case
• •description should be 1-2 sentences
• •allowed-tools must be valid tool names
• •Include backlog-id in metadata
• •Follow markdown formatting standards