Claude Code Recipes

September 6, 2026 · View on GitHub

47 copy-paste recipes for Claude Code - commands, subagents, hooks, skills, and MCP configs that work out of the box.

Stop configuring from scratch. Drop these recipes into your .claude/ folder and start building.

Something installed but silent? Claude Code config fails quietly, so start at TROUBLESHOOTING.md.

How to Use

Browse the recipe catalog below
Copy the file you need
Paste it into your project's .claude/ directory:
- Commands go in .claude/commands/
- Subagents go in .claude/agents/
- Skills go in .claude/skills/
- Hooks go in .claude/settings.json
- MCP configs go in .mcp.json
Use it immediately - every recipe works out of the box

Recipe Catalog

Commands (15 recipes)

Drop these into .claude/commands/ and use them with /command-name.

Recipe	What It Does	Model	Link
`/code-review`	Review staged changes for bugs, style, and security	sonnet	code-review.md
`/pr-description`	Generate PR title + description from branch diff	haiku	pr-description.md
`/commit-message`	Generate conventional commit message	haiku	commit-message.md
`/refactor`	Plan and execute a refactoring with safety checks	sonnet	refactor.md
`/test-gen`	Generate tests for a file or function	sonnet	test-gen.md
`/doc-gen`	Generate documentation for code	haiku	doc-gen.md
`/debug`	Systematic debugging: reproduce, isolate, fix, verify	opus	debug.md
`/migrate`	Migrate between framework versions or languages	opus	migrate.md
`/security-audit`	Scan for OWASP Top 10 vulnerabilities	sonnet	security-audit.md
`/performance-audit`	Find performance bottlenecks	sonnet	performance-audit.md
`/api-gen`	Generate REST endpoints from a spec	sonnet	api-gen.md
`/component-gen`	Generate React/Vue components from description	sonnet	component-gen.md
`/check-all-prs`	Check all open PRs across your GitHub repos	haiku	check-all-prs.md
`/audit-repos`	Audit all repos for health, hygiene, and security	sonnet	audit-repos.md
`/update-status`	Refresh a STATUS.md dashboard with live GitHub data	sonnet	update-status.md

Subagents (9 recipes)

Drop these into .claude/agents/ for specialized delegation.

Recipe	Specialty	Model	Link
Researcher	Explore codebase, find patterns, report findings	haiku	researcher.md
Test Runner	Run tests, fix failures, report results	sonnet	test-runner.md
Code Reviewer	Thorough review: bugs, style, security, perf	sonnet	code-reviewer.md
Frontend Dev	React/Vue/CSS specialist	sonnet	frontend-dev.md
Backend Dev	API, database, auth specialist	sonnet	backend-dev.md
DevOps Engineer	CI/CD, Docker, cloud infrastructure	sonnet	devops-engineer.md
Security Analyst	Vulnerability detection and remediation	sonnet	security-analyst.md
Tech Writer	Documentation, README, API docs	haiku	tech-writer.md
Database Architect	Schema design, migrations, query optimization	sonnet	database-architect.md

Hooks (5 recipes)

Event-triggered scripts for automation.

Recipe	Trigger	What It Does	Link
Pre-commit Lint	Before `git commit`	Run linter and block if errors	pre-commit-lint.sh
Post-edit Format	After Claude edits a file	Auto-format with Prettier/Black	post-edit-format.sh
Pre-push Test	Before `git push`	Run test suite and block if failing	pre-push-test.sh
Notification	On task completion	Desktop notification when done	notification.sh
Settings Example	--	Hook configuration for settings.json	settings-hook-examples.json

Skills (5 recipes)

Reusable knowledge modules - drop the folder into .claude/skills/.

Recipe	Domain	Link
React Patterns	Component patterns, hooks, state management	react-patterns/
API Design	REST conventions, status codes, pagination	api-design/
Git Workflow	Branch naming, commit format, PR conventions	git-workflow/
Testing Strategy	What to test, how to structure tests	testing-strategy/
TypeScript Strict	Strict mode patterns, type utilities	typescript-strict/

MCP Configs (5 recipes)

Model Context Protocol server configurations for .mcp.json.

Recipe	What It Connects	Link
GitHub	Issues, PRs, repos, actions	github.json
Filesystem	Enhanced file operations	filesystem.json
PostgreSQL	Database queries and schema	postgres.json
Memory	Persistent key-value memory	memory.json
Context7	Library documentation lookup	context7.json

Workflows (5 recipes)

End-to-end guides combining multiple recipes.

Recipe	Scenario	Link
New Feature	Plan, implement, test, PR - full cycle	new-feature.md
Bug Fix	Reproduce, isolate, fix, verify, commit	bug-fix.md
Code Migration	Audit, plan, migrate, test, validate	code-migration.md
PR Review Cycle	Review, request changes, iterate, approve	pr-review-cycle.md
Project Setup	Configure Claude Code for a new project	project-setup.md

CLAUDE.md Templates (3 recipes)

Optimized project configuration templates.

Recipe	Best For	Link
Starter	Solo projects, quick setup	starter.md
Team Project	Team conventions, CI/CD	team-project.md
Monorepo	Multi-package workspaces	monorepo.md

Quick Reference

See the cheatsheet for a one-page summary, and TROUBLESHOOTING.md when a recipe is installed but does nothing.

Every recipe in this repo is checked on each push and pull request: frontmatter validity, the hook config schema, JSON parsing, shellcheck, working links, and that the recipe counts above match the files on disk.

Run the same checks yourself:

bash scripts/validate-recipes.sh

Installation

One recipe at a time

# Copy a command
cp claude-code-recipes/commands/code-review.md .claude/commands/

# Copy a subagent
cp claude-code-recipes/subagents/researcher.md .claude/agents/

# Copy a skill
cp -r claude-code-recipes/skills/react-patterns .claude/skills/

All recipes at once

# Clone and copy everything
git clone https://github.com/Sagargupta16/claude-code-recipes.git /tmp/recipes
mkdir -p .claude/commands .claude/agents .claude/skills
cp /tmp/recipes/commands/*.md .claude/commands/
rm -f .claude/commands/README.md
cp /tmp/recipes/subagents/*.md .claude/agents/
rm -f .claude/agents/README.md
cp -r /tmp/recipes/skills/* .claude/skills/
rm -f .claude/skills/README.md

Contributing

We welcome recipe contributions! See CONTRIBUTING.md.

Ways to contribute:

Add a recipe: Commands, subagents, skills, hooks, or MCP configs
Improve existing recipes: Better prompts, additional edge cases
Add a workflow: End-to-end guides for common scenarios
Report issues: Recipes that don't work as expected

Repo	What It Is	Why You'd Want It
claude-cost-optimizer	Strategies, benchmarks, copy-paste configs, and interactive tools for cutting Claude Code costs	Once the recipes here are installed, this is how you keep the bill down
agent-recipes	Copy-paste AI agent workflows for real-world dev tasks - code review, testing, security scanning, DevOps automation	The same idea one layer up: whole workflows rather than single config files
claude-skills	Custom Claude Code plugin marketplace with skills for FARM stack, open source contributions, repo maintenance, and portfolio management	Install skills as a versioned plugin instead of copying folders
awesome-mcp-servers	A curated list of MCP (Model Context Protocol) servers, tools, frameworks, and resources	Where to look when the five MCP configs here are not the server you need
ai-git-hooks	AI-powered git hooks - auto-review diffs, generate commit messages, scan for secrets. Supports Claude, OpenAI, and Ollama	Git-side counterpart to the hooks here, which are Claude-Code-side
skillcheck	Conformance suite for Agent Skills: lint SKILL.md against the spec, run against real agent runtimes, publish a compatibility matrix	Validate a SKILL.md you write from the skills templates
craftsmanship	Skills that encode engineering discipline -- plan, guard, verify, review, audit, ship	Process skills, where the ones here are stack-specific
mcp-toolkit	TypeScript middleware toolkit for MCP servers - authentication, caching, rate limiting, CORS, logging (beta)	For when you move from configuring MCP servers to writing one
shanraisshan/claude-code-best-practice	Best practices documentation	Third-party reading on how to use Claude Code well

License

MIT - use these recipes however you want.