home / skills / 0xdarkmatter / claude-mods / claude-code-templates

claude-code-templates skill

safe

This skill provides boilerplate templates and quick-start workflows for creating Claude Code extensions, including agent, skill, command, and hook-script

npx playbooks add skill 0xdarkmatter/claude-mods --skill claude-code-templates

Review the files below or copy the command above to add this skill to your agents.

Files (7)

SKILL.md

3.0 KB

---
name: claude-code-templates
description: "Boilerplate templates for Claude Code extensions. Triggers on: create agent, new skill, command template, hook script, extension scaffold."
compatibility: "Claude Code CLI"
allowed-tools: "Read Write"
depends-on: []
related-skills: [claude-code-hooks, claude-code-debug]
---

# 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

```bash
# 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

```bash
# 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

```bash
# 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

```bash
# 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

```bash
# 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

Overview

This skill provides lightweight boilerplate templates and scaffolds for building Claude Code extensions, including agents, skills, commands, and hook scripts. It speeds up project setup with consistent naming, validation checks, and secure hook examples. Use it to standardize new extensions and reduce repetitive configuration.

How this skill works

Templates live in an assets folder and can be copied into your Claude Code workspace to create new agents, skills, commands, or hooks. Each template includes frontmatter, example fields, and execution notes so you can edit name, description, focus areas, and triggers. Basic validation steps and examples for making hook scripts executable are included to help avoid common errors.

When to use it

Bootstrapping a new Claude Code agent persona with expert focus areas and references.
Creating a new skill scaffold with commands, examples, and metadata.
Adding a slash command that documents execution flow and options.
Implementing automated hooks with secure parsing and exit codes.
Enforcing consistent naming and frontmatter validation across extensions.

Best practices

Follow the provided naming patterns to keep agents, skills, commands, and hooks discoverable.
Populate frontmatter fields (name, description, triggers, examples) before publishing.
Make hook scripts executable and handle input/exit codes securely.
Run the included validation steps and project tests after editing templates.
Keep references and quality-check items in agent templates to guide behavior and evaluation.

Example use cases

Create a React expert agent scaffold with focus areas, references, and a quality checklist.
Scaffold a git-workflow skill directory with multiple documented commands and examples.
Add a review slash command that documents execution flow, options, and sample inputs.
Implement a pre-write validation hook script that parses input and returns proper exit codes.
Standardize new extensions across a team using the same asset templates and validation steps.

FAQ

Where should I place the templates in my project?

Copy the relevant template from the assets folder into your workspace location for agents, skills, commands, or hooks and then edit the metadata and examples.

How do I validate a new skill’s metadata?

Check the frontmatter fields for required keys and run the project’s tests or validation commands to ensure names match file patterns.