| name | create-skill |
| description | Scaffold a new Claude Code skill with proper structure. Use when the user wants to create a new skill, add a skill, or scaffold a SKILL.md. Creates the skill directory and generates a well-structured SKILL.md file. |
Create Skill
Scaffolds a new Claude Code skill by creating the directory structure and SKILL.md file.
User arguments: $ARGUMENTS
Process
1. Parse arguments
Check if the user provided arguments. Arguments can be:
- Just a name:
my-skill
- Name and description:
my-skill "Description of what it does"
If no arguments provided, proceed to guided mode.
2. Gather information (if not from arguments)
If name or description are missing, ask the user using AskUserQuestion:
Skill name - Must be:
- Lowercase letters, numbers, and hyphens only
- Maximum 64 characters
- Cannot contain "anthropic" or "claude"
Description - Should include:
- What the skill does
- When Claude should trigger it (trigger phrases)
3. Ask for location
Always ask where to create the skill:
| Option | Path | Use case |
|---|
| Personal (global) | ~/.claude/skills/<name>/ | Available across all projects |
| Project-specific | .claude/skills/<name>/ | Version controlled with the project |
4. Validate
Before creating, check:
- Directory doesn't already exist
- Name follows naming rules
- Description is non-empty and under 1024 characters
If validation fails, inform the user and ask for corrections.
5. Create the skill
Create the directory and write the SKILL.md file:
mkdir -p <location>/<skill-name>
Write SKILL.md with this structure:
---
name: <skill-name>
description: <description>
---
# <Skill Title>
<Brief description of what this skill does>
## Process
1. [First step]
2. [Second step]
3. [...]
## Guidelines
- [Key guideline 1]
- [Key guideline 2]
6. Confirm creation
Tell the user:
- The full path to the created SKILL.md
- Remind them to edit the file to add their specific instructions
- How to invoke it:
/<skill-name> or /<skill-name> arguments
