/skill-creator

Create a new skill for the vault with guided prompts, following clawdbot's meta-skill pattern.

Usage

/skill-creator <skill-name>
/skill-creator transcribe
/skill-creator vendor-comparison

Instructions

Phase 1: Initial Setup

1. •Parse the skill name from the command
2. •Check if a skill with this name already exists in .claude/skills/
3. •If exists, warn and ask if they want to overwrite or rename

Phase 2: Gather Skill Metadata (6-Step Process)

Ask the user these questions in sequence:

Step 1: Purpose & Description

Question: "What does this skill do? (One sentence)"

• •This becomes the description: field in frontmatter
• •Should be concise and action-oriented
• •Example: "Convert voice recordings to text using Whisper API"

Step 2: Model Tier

Question: "Which model tier is appropriate?"

Store in model: frontmatter field.

Step 3: Execution Context

Question: "How should this skill execute?"

Store in context: frontmatter field.

Step 3b: Agent Type (v2.1.0+)

Question: "Should this skill use a specific agent type?"

Store in agent: frontmatter field (optional).

Step 4: Input Parameters

Question: "What inputs does this skill need?"

Gather:

• •Required parameters (e.g., <title>, <project>, <path>)
• •Optional parameters (e.g., [--format png], [for <project>])
• •Any flags or options

Step 5: Output Format

Question: "What does this skill produce?"

Options:

• •Creates a new note (specify type)
• •Modifies existing note
• •Generates report/output to screen
• •Creates file(s) in specific location
• •Multiple outputs

Step 6: Example Usage

Question: "Give 2-3 example commands"

Examples help users understand the skill quickly.

Phase 3: Generate Skill File

Create the skill file at .claude/skills/{{skill-name}}.md:

---
context: { { context } }
model: { { model } }
agent: { { agent or omit if not specified } }
description: { { description } }
allowed-tools: # v2.1.0+ YAML-style tool restrictions (optional)
  - Read
  - Glob
  - Grep
---

# /{{skill-name}}

{{description}}

## Usage

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

## Examples

\`\`\`
{{example 1}}
{{example 2}}
{{example 3}}
\`\`\`

## Instructions

### 1. Parse Input

Parse the command for:
{{list of parameters and their validation}}

### 2. Validate Prerequisites

{{any prerequisites or checks}}

### 3. Execute Skill

{{main skill logic - break into numbered steps}}

### 4. Output Results

{{how to present results to user}}

## Error Handling

- {{common error scenarios and recovery}}

## Related Skills

- {{links to related skills}}

Phase 4: Register Skill

1. •Add skill to CLAUDE.md skill table (suggest to user)
2. •Display the created skill content for review
3. •Offer to test the skill immediately

Phase 5: Quality Checklist

Before finalising, verify:

• • Description is concise (< 80 chars)
• • Model tier matches complexity
• • Context type is appropriate
• • Examples are realistic
• • Instructions are numbered and clear
• • Error handling is included
• • Related skills are linked

Skill Design Principles (from clawdbot)

1. •Token Efficiency: "The context window is a public good" - include only what Claude needs
2. •Progressive Disclosure: Metadata first, full instructions on-demand
3. •Documentation-First: The skill file IS the interface
4. •Minimal Dependencies: Skills should be self-contained
5. •Clear Triggers: Description should make it obvious when to use

Output

After creation:

Created skill: .claude/skills/{{skill-name}}.md

Skill Summary:
- Name: /{{skill-name}}
- Description: {{description}}
- Model: {{model}}
- Context: {{context}}

Next steps:
1. Review the skill content
2. Add to CLAUDE.md skill table
3. Test with: /{{skill-name}} {{example}}

Would you like to test this skill now?

Related Skills

• •[[.claude/skills/archive/SKILL.md|/archive]] - Skill lifecycle management
• •[[.claude/skills/rename/SKILL.md|/rename]] - Batch operations pattern