This guide covers how to create and add individual components like agents, commands, MCPs, settings, hooks, and skills to the Claude Code Templates project.Documentation Index
Fetch the complete documentation index at: https://docs.aitmpl.com/llms.txt
Use this file to discover all available pages before exploring further.
Component Types Overview
| Type | Count | Format | Description |
|---|---|---|---|
| Agents | 400+ | Markdown | AI specialists for specific domains |
| Commands | 225+ | Markdown | Custom slash commands for workflows |
| MCPs | 65+ | JSON | External service integrations |
| Settings | 60+ | JSON | Claude Code configuration files |
| Hooks | 39+ | JSON + Scripts | Automation triggers for events |
| Skills | Growing | Markdown | Modular capabilities (Anthropic format) |
Adding Agents
Agents are AI specialists for specific domains like security, performance, frameworks, etc.1. Create Agent File
2. Agent File Structure
Agents use Markdown with YAML frontmatter:3. Available Categories
development-team/- Full-stack developers, architectsdomain-experts/- Security, performance, accessibility specialistscreative-team/- Content creators, designersbusiness-team/- Product managers, analystsdevelopment-tools/- Tool specialists, DevOps experts
4. Real Example: Frontend Developer
Location:cli-tool/components/agents/development-team/frontend-developer.md
See the full example at
~/workspace/source/cli-tool/components/agents/development-team/frontend-developer.mdAdding Commands
Commands are custom slash commands that extend Claude Code functionality.1. Create Command File
2. Command File Structure
Commands use Markdown with YAML frontmatter:3. Command Categories
testing/- Test generation, validation, coverageutilities/- Code analysis, optimization, debuggingsetup/- Environment setup, configurationteam/- Collaboration, planning, documentationsync/- Integration with external toolssimulation/- Scenario modeling and analysis
4. Real Example: Generate Tests
Location:cli-tool/components/commands/testing/generate-tests.md
Adding MCPs
MCPs provide external service integrations for Claude Code.1. Create MCP File
2. MCP File Structure
3. MCP Categories
audio/- Audio processing, text-to-speech, transcriptionintegration/- GitHub, GitLab, Jiradatabase/- PostgreSQL, MySQL, MongoDBcloud/- AWS, Azure, GCP servicesdevtools/- Build tools, testing frameworksai-services/- OpenAI, Anthropic, other AI APIs
Adding Settings
Settings configure Claude Code behavior and performance.1. Create Settings File
2. Settings File Structure
3. Settings Categories
performance/- Memory, timeout, cache settingsui/- Interface customization, themesmcp/- MCP server configurationssecurity/- Access control, permissions
Adding Hooks
Hooks provide automation triggers for different development events.1. Create Hook File
2. Hook File Structure
3. Hook Categories
git/- Pre-commit, post-commit, pre-pushdevelopment-tools/- File changes, formatting, lintingtesting/- Test execution, coverage checksautomation/- Notifications, deployments, monitoringsecurity/- Security scanning, secret detectionperformance/- Performance monitoring, budget guards
4. Real Example: Simple Notifications
Location:cli-tool/components/hooks/automation/simple-notifications.json
5. Hook Types
- PreToolUse - Runs before a tool is executed
- PostToolUse - Runs after a tool completes
- OnError - Runs when an error occurs
- OnSessionStart - Runs when Claude Code session starts
- OnSessionEnd - Runs when Claude Code session ends
Adding Skills
Skills are modular capabilities using Anthropic’s progressive disclosure pattern.1. Create Skill Directory
2. Skill Structure
3. SKILL.md Format
Creating New Categories
If your component doesn’t fit existing categories, create a new one:New categories are automatically detected when the component catalog is regenerated.
Next Steps
After creating your component:Submit Pull Request
See Publishing Workflow for details
Resources
- Component Guidelines - Best practices and quality standards
- Testing Workflow - How to test your components
- Code Standards - Coding conventions and style guide
- Browse existing components - See examples and patterns