|
| 1 | +# claude-agents |
| 2 | + |
| 3 | +**Seven specialist Claude Code subagents** by [@iannuttall](https://github.com/iannuttall) that give your Claude Code setup expert-level, opinionated help across the full product and engineering lifecycle. |
| 4 | + |
| 5 | +## What it does |
| 6 | + |
| 7 | +Drop these agents into your Claude Code project (`.claude/agents/`) or your global Claude directory (`~/.claude/agents/`) and Claude will automatically invoke the right specialist for each task — no manual prompting required. |
| 8 | + |
| 9 | +## The seven subagents |
| 10 | + |
| 11 | +| Subagent | What it does | |
| 12 | +|---|---| |
| 13 | +| **code-refactorer** | Improves code structure, naming, and readability without changing behaviour. Proposes changes before touching any file. | |
| 14 | +| **security-auditor** | Performs a full security audit: authentication, input validation, API protection, dependency review. Outputs a `security-report.md` with severity-rated findings and remediation checklists. | |
| 15 | +| **frontend-designer** | Converts mockups, wireframes, and screenshots into detailed component architectures and design-system specs for React, Vue, or any other stack. | |
| 16 | +| **prd-writer** | Creates comprehensive Product Requirements Documents — business goals, user personas, functional requirements, user stories with acceptance criteria, and phased milestones. | |
| 17 | +| **project-task-planner** | Turns a PRD into a sequenced development task list covering backend, frontend, integration, and deployment phases. | |
| 18 | +| **content-writer** | Explains complex topics for general audiences. Works in outline mode (research + structure) or write mode (section-by-section drafting at Flesch-Kincaid grade 8). | |
| 19 | +| **vibe-coding-coach** | Translates a user's vision and aesthetic "vibe" into working applications — handling all technical complexity while keeping the conversation focused on outcomes. | |
| 20 | + |
| 21 | +## Installation |
| 22 | + |
| 23 | +```bash |
| 24 | +# Project-specific |
| 25 | +mkdir -p .claude/agents |
| 26 | +cp agents/*.md .claude/agents/ |
| 27 | + |
| 28 | +# Global (all projects) |
| 29 | +mkdir -p ~/.claude/agents |
| 30 | +cp agents/*.md ~/.claude/agents/ |
| 31 | +``` |
| 32 | + |
| 33 | +## Key capabilities |
| 34 | + |
| 35 | +- **Zero dependencies** — pure Markdown agent definitions, no runtime installs |
| 36 | +- **Automatic invocation** — Claude Code selects the right specialist automatically |
| 37 | +- **Non-destructive by default** — agents propose changes and ask for confirmation before editing files |
| 38 | +- **Full lifecycle coverage** — from product idea → PRD → tasks → code → security → content |
| 39 | + |
| 40 | +## Example usage |
| 41 | + |
| 42 | +``` |
| 43 | +# In Claude Code: |
| 44 | +"Refactor this 300-line auth module" → code-refactorer takes over |
| 45 | +"Audit our API for vulnerabilities" → security-auditor produces a report |
| 46 | +"Turn this Figma screenshot into React" → frontend-designer specs the components |
| 47 | +"Write a PRD for a blog platform" → prd-writer creates prd.md |
| 48 | +"Create a task list from my PRD" → project-task-planner generates plan.md |
| 49 | +"I want to build an Instagram for pets" → vibe-coding-coach guides the build |
| 50 | +``` |
| 51 | + |
| 52 | +## Links |
| 53 | + |
| 54 | +- Repository: https://github.com/iannuttall/claude-agents |
| 55 | +- GitAgent Protocol: https://gitagent.sh |
| 56 | +- Registry: https://registry.gitagent.sh |
0 commit comments