Claude Code Templates

Starter templates for building Claude Code extensions.

Template Selection

Building	Template	Key Features
Expert persona	`agent-template.md`	Focus areas, quality checklist, references
Tool capability	`skill-template.md`	Commands, examples, triggers
User workflow	`command-template.md`	Execution flow, options
Automation	`hook-script.sh`	Input parsing, exit codes

Quick Start

Create an Agent

# Copy template
cp ~/.claude/skills/claude-code-templates/assets/agent-template.md \
   ~/.claude/agents/my-expert.md

# Edit: name, description, focus areas, references

Create a Skill

# Create skill directory
mkdir -p ~/.claude/skills/my-skill

# Copy template
cp ~/.claude/skills/claude-code-templates/assets/skill-template.md \
   ~/.claude/skills/my-skill/SKILL.md

# Edit: name, description, commands, examples

Create a Command

# Copy template
cp ~/.claude/skills/claude-code-templates/assets/command-template.md \
   ~/.claude/commands/my-command.md

# Edit: name, description, execution flow

Create a Hook Script

# Copy template
cp ~/.claude/skills/claude-code-templates/assets/hook-script.sh \
   .claude/hooks/my-hook.sh

# Make executable
chmod +x .claude/hooks/my-hook.sh

Template Locations

Templates are in ./assets/:

File	Purpose
`agent-template.md`	Expert agent boilerplate
`skill-template.md`	Skill with YAML frontmatter
`command-template.md`	Slash command scaffold
`hook-script.sh`	Secure hook script template

Naming Conventions

Type	Pattern	Example
Agent	`{technology}-expert.md`	`react-expert.md`
Skill	`{tool-or-pattern}/SKILL.md`	`git-workflow/SKILL.md`
Command	`{action}.md`	`review.md`
Hook	`{event}-{action}.sh`	`pre-write-validate.sh`

Validation

# Validate YAML frontmatter
head -20 my-extension.md

# Check name matches filename
grep "^name:" my-extension.md

# Run project tests
just test

Official Documentation

https://code.claude.com/docs/en/skills - Skills reference
https://code.claude.com/docs/en/sub-agents - Custom subagents
https://code.claude.com/docs/en/hooks - Hooks reference
https://agentskills.io/specification - Agent Skills open standard

Assets

./assets/agent-template.md - Expert agent scaffold
./assets/skill-template.md - Skill with references pattern
./assets/command-template.md - Slash command scaffold
./assets/hook-script.sh - Secure bash hook template

See Also: claude-code-debug for troubleshooting extensions