Skip to main content
We welcome contributions to Claude Code Templates! This guide will help you get started with contributing components, templates, and improvements to the project.

​
Quick Start

1

Fork and Clone

# Fork the repository on GitHub
# Then clone your fork
git clone https://github.com/your-username/claude-code-templates.git
cd claude-code-templates
2

Install Dependencies

# Navigate to CLI tool directory
cd cli-tool

# Install dependencies
npm install

# Link for local testing
npm link
3

Create Feature Branch

git checkout -b feature/your-contribution
4

Make Your Changes

Follow the guidelines in this documentation for your specific contribution type.

​
What Can You Contribute?

There are several ways to contribute to the project:

​
Individual Components

The easiest way to contribute is by adding individual components:
  • Agents (400+) - AI specialists for specific domains
  • Commands (225+) - Custom slash commands for workflows
  • MCPs (65+) - External service integrations
  • Settings (60+) - Claude Code configuration files
  • Hooks (45+) - Automation triggers
  • Skills - Modular capabilities using Anthropic’s progressive disclosure pattern

​
Complete Templates

Templates are complete project configurations that include CLAUDE.md, .claude/* files, and .mcp.json.

​
Additional Tools

For advanced contributors, you can improve CLI tools like:
  • Analytics dashboard
  • Health check diagnostics
  • Chat monitor interface

​
Before You Start

Read our Code of Conduct to ensure a respectful and inclusive environment for all contributors.

​
Browse Existing Components

Before creating a new component:
  1. Visit aitmpl.com to browse existing components
  2. Check if a similar component already exists
  3. Review successful components for structure reference
  4. Understand the naming conventions and patterns

​
Prerequisites

  • Node.js 14+ for the CLI tool
  • npm or yarn for package management
  • Git for version control
  • Python 3.x (optional, for component catalog generation)

​
Your First Contribution

All components must be reviewed using the component-reviewer agent before submitting. See Component Guidelines for details.
A good first contribution is adding a simple agent or command: 
# Create a new agent file
cd cli-tool/components/agents/domain-experts/
touch your-agent-name.md
See the Adding Components guide for detailed instructions.

​
Testing Your Changes

Before submitting a pull request: 
# Test component installation
npx claude-code-templates@latest --agent your-agent --dry-run

# Run test suite
npm test
See the Testing guide for comprehensive testing workflows.

​
Getting Help

​
Community Support

​
Quick Start Guides

  • Browse existing components at aitmpl.com
  • Check component examples in the repository
  • Review successful templates for best practices

​
What We’re Looking For

​
High Priority Components

  • Security Agents - Security auditing, vulnerability scanning
  • Performance Commands - Optimization, profiling, monitoring
  • Cloud MCPs - AWS, Azure, GCP integrations
  • Framework Agents - React, Vue, Angular, Next.js specialists

​
High Priority Templates

  • Modern Frameworks - Svelte, SvelteKit, Astro, Qwik
  • Backend Frameworks - NestJS, Fastify, Hono, tRPC
  • Full-Stack - T3 Stack, create-remix-app, SvelteKit
  • Mobile - React Native, Expo, Flutter

​
Medium Priority Tools

  • Analytics Enhancements - Better visualizations, export options
  • Chat Monitor Features - Search, filtering, conversation history
  • Health Check Improvements - More diagnostic categories, fix suggestions

​
Next Steps

Adding Components

Learn how to create agents, commands, MCPs, hooks, and settings

Component Guidelines

Best practices and quality standards for components

Testing Workflow

Complete testing guide before submitting contributions

Publishing Workflow

Learn the process for publishing to npm

​
Recognition

All contributors are recognized in:
  • GitHub Contributors page
  • Release Notes for significant contributions
  • Community Discussions for helpful contributions
Thank you for helping make Claude Code Templates better for everyone!