scaffold-skill

# Scaffold Skill

Generate a new skill from a template with proper structure and conventions.

## Usage

```
/scaffold-skill                     # Interactive mode
/scaffold-skill my-new-skill        # Create skill with name
```

## Workflow

### 1. Gather Information

Ask the user for:

1. **Skill name** (required)
   - Must be lowercase with hyphens
   - Example: `my-awesome-skill`

2. **Description** (required)
   - Brief description for Claude
   - Should explain when to use this skill

3. **Type** (optional)
   - `prompt` - Claude executes instructions (default)
   - `script` - Has Python/shell scripts
   - `hybrid` - Both prompt and scripts

4. **Publish** (optional)
   - `true` (default) - Sync to repository
   - `false` - Keep local only

### 2. Create Directory Structure

Based on type, create:

**Prompt-based skill:**
```
skills/my-skill/
├── SKILL.md
└── README.md
```

**Script-based skill:**
```
skills/my-skill/
├── SKILL.md
├── README.md
├── requirements.txt
└── scripts/
    └── main.py
```

**Hybrid skill:**
```
skills/my-skill/
├── SKILL.md
├── README.md
├── requirements.txt
├── scripts/
│   └── helper.py
├── workflows/
│   └── main.md
└── references/
    └── docs.md
```

### 3. Generate Files

#### SKILL.md Template

```markdown
---
name: {skill-name}
description: {description}
version: "1.0.0"
author: Nathan Krebs
publish: {publish}
triggers:
  - /{skill-name}
---

# {Skill Title}

{Description paragraph}

## Usage

\`\`\`
/{skill-name}
\`\`\`

## Workflow

### 1. Step One

Description of first step.

### 2. Step Two

Description of second step.

## Examples

### Example 1

\`\`\`
User: /{skill-name}
Claude: [Description of what happens]
\`\`\`
```

#### README.md Template

```markdown
# {Skill Title}

{Description}

## Installation

Copy the skill to your Claude skills directory:

\`\`\`bash
cp -r skills/{skill-name} ~/.claude/skills/
\`\`\`

## Usage

\`\`\`
/{skill-name}
\`\`\`

## License

MIT License - see [LICENSE](../../LICENSE)
```

#### req