Scaffold a new Claude Code skill — creates the SKILL.md with proper frontmatter and optional supporting files. Invoke with: /new-skill <skill-name> [description]
Scaffold a complete Claude Code skill from scratch based on the arguments provided.
Invocation:
/new-skill <skill-name> [one-line description]
$ARGUMENTS — first token is the skill name (kebab-case), the rest form the description.
Follow these steps exactly, in order:
Extract from $ARGUMENTS:
If description is missing or very short, ask:
/skill-name), automatically by Claude, or both?Skip questions that are already clear from $ARGUMENTS.
Based on the answers, select appropriate frontmatter:
| Need | Field to add |
|---|---|
Hide from / menu | user-invocable: false |
| Prevent auto-trigger | disable-model-invocation: true |
| Run in subagent | context: fork |
| Limit tools | allowed-tools: Read Grep ... |
| Arguments hint | argument-hint: <format> |
| Specific model | model: sonnet or model: opus |
| Effort level | effort: low / medium / high / max |
Write clear, step-by-step instructions in the SKILL.md body:
Use $ARGUMENTS, $0, $1, ${CLAUDE_SKILL_DIR}, ${CLAUDE_SESSION_ID} where dynamic values are needed.
Keep SKILL.md under 500 lines. Move bulky reference material to supporting files.
.claude/skills/<skill-name>/SKILL.md with the designed contentAfter creating the files, display:
Skill created: /home/.../.claude/skills/<skill-name>/
Files:
SKILL.md — main skill file
[other files] — supporting files (if any)
Invoke with:
/<skill-name> [arguments]
Frontmatter used:
[list key fields chosen]
Use this template as the base for every new SKILL.md:
---