YourAITools

Claude Code Subagents Starter (Free)

Three subagents worth having in every repo, and a linter that tells you why an agent file isn't showing up.

Claude Code Subagents Starter (Free) cover

What it is

Three Claude Code subagents (https://code.claude.com/docs/en/sub-agents) worth having in every repo, plus lint_agents.py, which finds the agent files Claude Code silently skips.

SubagentToolsWhat it does
code-reviewerRead, Grep, Glob, BashReviews your diff for bugs, security problems, risky changes and missing tests; doesn't edit files
test-writerRead, Grep, Glob, Edit, Write, BashWrites tests in your existing framework; for bugs, writes the failing regression test first
debuggerRead, Grep, Glob, Edit, BashReproduces a failure, finds the root cause, applies the smallest fix and re-runs the tests

What you get

The screenshot is real output from the kit’s own commands. Tested from a fresh download of this exact zip: ./run_tests.sh ran 8 tests OK on Python 3.13 and 3.10.

Real terminal output from Claude Code Subagents Starter: demo and passing tests

Install

mkdir -p .claude/agents && cp agents/*.md .claude/agents/     # this project (commit it)
mkdir -p ~/.claude/agents && cp agents/*.md ~/.claude/agents/ # all your projects

If .claude/agents/ is new, restart Claude Code once. Then ask "use the code-reviewer subagent on my changes".

Why isn't my subagent loading?

python3 tools/lint_agents.py .claude/agents ~/.claude/agents

Claude Code skips agent files without telling you when the frontmatter isn't on line 1, the YAML won't parse (an unquoted : in a description does it), name or description is missing, or the name contains :. It also silently ignores misspelled fields like maxturns, and refuses to launch an agent whose tools list doesn't resolve. The linter checks all of that, plus invalid model/color/effort values and tools subagents never get. ./demo.sh shows it on examples/broken-agents/; ./run_tests.sh runs the tests. Python 3.9+, no dependencies.

Honest limits

  • Includes 3 subagents; the full set is in the paid pack.

Format and license

Zip, 14 KB, v1.0, 15 files. Free to use, modify and share for any purpose, including commercial work, as long as this notice stays in copies. Not affiliated with or endorsed by Anthropic.

FAQ

Is it really free?
Yes, free to use, change and share.
Where do the files go?
.claude/agents/ for one project or ~/.claude/agents/ for all.
What's in the paid pack?
7 more agents, an installer and plugin packaging.
How do I get the files?
Click Download free. The zip downloads straight away: no checkout, no account.
Do I have to sign up for the newsletter?
No. The form is optional and the download works without it.

Get Claude Code Subagents Starter (Free)

3 free Claude Code subagent examples (code reviewer, test writer, debugger) and a linter that shows why a subagent file isn't loading.

Free free download

Download free (zip)Or get Claude Code Subagents Pack →

Pairs well with

Download$19

CSV & Excel MCP Server

Read-only MCP server for CSV, TSV and Excel: describe columns, SQL joins across files and sheets, column stats. No uploads, no dependencies. $19 once.

View CSV & Excel MCP Server
Download$19

Claude Code Plugin Marketplace Template

Start a Claude Code plugin marketplace: marketplace.json, 3 example plugins, team auto-install settings, CI and an offline checker. $19 once.

View Claude Code Plugin Marketplace Template
Download$39

Cursor Rules All-Stacks Bundle

86 Cursor rules for Next.js 16, Laravel 13, FastAPI, SvelteKit 3, Expo SDK 58, Django, Rails 8 and Supabase. Detects each repo's stack. $39 ($108 value).

View Cursor Rules All-Stacks Bundle

Related