msitarzewski/agency-agents

🚀 What Is This?

Born from a Reddit thread and months of iteration, The Agency is a growing collection of meticulously crafted AI agent personalities. Each agent is:

• 🎯 Specialized: Deep expertise in their domain (not generic prompt templates)
• 🧠 Personality-Driven: Unique voice, communication style, and approach
• 📋 Deliverable-Focused: Real code, processes, and measurable outcomes
• ✅ Production-Ready: Battle-tested workflows and success metrics

Think of it as: Assembling your dream team, except they're AI specialists who never sleep, never complain, and always deliver.

⚡ Quick Start

Option 1: Install the app (Recommended)

The fastest way in — no clone, no terminal. Agency Agents is a native desktop app (macOS · Linux · Windows) that browses the whole roster and installs agents into Claude Code, Cursor, Codex, Gemini CLI, OpenCode, Qwen, and Osaurus for you, then keeps them up to date.

⬇ Download the latest release — or on a Mac:

brew install --cask msitarzewski/agency-agents/agency-agents

Prefer the command line? The script-based options below install the same agents.

Option 2: Use with Claude Code

# Install all agents to your Claude Code directory
./scripts/install.sh --tool claude-code

# Or manually copy a category if you only want one division
cp engineering/*.md ~/.claude/agents/

# Then activate any agent in your Claude Code sessions:
# "Hey Claude, activate Frontend Developer mode and help me build a React component"

Option 3: Use as Reference

Each agent file contains:

• Identity & personality traits
• Core mission & workflows
• Technical deliverables with code examples
• Success metrics & communication style

Browse the agents below and copy/adapt the ones you need!

Option 4: Use with Other Tools (GitHub Copilot, Antigravity, Gemini CLI, OpenCode, OpenClaw, Cursor, Aider, Windsurf, Kimi Code, Codex, Osaurus, Hermes, Mistral Vibe, DeepSeek Harness)

# Step 1 -- generate integration files for all supported tools
./scripts/convert.sh

# Step 2 -- install interactively (auto-detects what you have installed)
./scripts/install.sh

# Or target a specific tool directly
./scripts/install.sh --tool antigravity
./scripts/install.sh --tool gemini-cli
./scripts/install.sh --tool opencode
./scripts/install.sh --tool copilot
./scripts/install.sh --tool openclaw
./scripts/install.sh --tool cursor
./scripts/install.sh --tool aider
./scripts/install.sh --tool windsurf
./scripts/install.sh --tool kimi
./scripts/install.sh --tool codex
./scripts/install.sh --tool osaurus
./scripts/install.sh --tool hermes
./scripts/install.sh --tool vibe
./scripts/install.sh --tool dsh

Install only the teams you need (not everyone wants every division):

./scripts/install.sh                                    # interactive wizard: pick tools + teams
./scripts/install.sh --tool claude-code --division engineering,security
./scripts/install.sh --tool cursor --agent frontend-developer,ui-designer
./scripts/install.sh --list teams                       # see every team + agent count
./scripts/install.sh --tool opencode --division engineering --dry-run

--agent and --agents-file take an agent's slug (as --list agents prints it), its display name, or its file name without .md — the id the runbook rosters use — so a runbook's team installs as listed:

python3 -c 'import json, sys
for r in json.load(open("strategy/runbooks.json"))["runbooks"]:
    if r["slug"] == sys.argv[1]: [print(a) for g in r["roster"] for a in g["agents"]]' startup-mvp > team.txt
./scripts/install.sh --tool claude-code --agents-file team.txt

OpenCode note: OpenCode's runtime currently registers only ~119 agents and silently drops the rest (upstream bug). Installing a subset with --division keeps you under that limit. The installer warns you when a selection would exceed it.

See the Multi-Tool Integrations section below for full details.

🎨 The Agency Roster

💻 Engineering Division

Building the future, one commit at a time.

🎨 Design Division

Making it beautiful, usable, and delightful.

💰 Paid Media Division

Turning ad spend into measurable business outcomes.

💼 Sales Division

Turning pipeline into revenue through craft, not CRM busywork.

📢 Marketing Division

Growing your audience, one authentic interaction at a time.

📊 Product Division

Building the right thing at the right time.

🎬 Project Management Division

Keeping the trains running on time (and under budget).

🧪 Testing Division

Breaking things so users don't have to.

🔒 Security Division

Defending the stack — from secure-by-design architecture to breach response.

🛟 Support Division

The backbone of the operation.

🥽 Spatial Computing Division

Building the immersive future.

🎯 Specialized Division

The unique specialists who don't fit in a box.

💵 Finance Division

Accounting, financial analysis, tax strategy, and investment research specialists.

🎮 Game Development Division

Building worlds, systems, and experiences across every major engine.

Cross-Engine Agents (Engine-Agnostic)

Unity

Unreal Engine

Godot

Blender

Roblox Studio

📚 Academic Division

Scholarly rigor for world-building, storytelling, and narrative design.

🌍 GIS Division

Mapping the Earth, analyzing the built world, and extracting intelligence from geospatial data.

🏥 Healthcare Division

Building AI agents for regulated clinical and sovereign health contexts.

🔍 Research Division

Finding, evaluating, and synthesizing existing evidence rather than generating new primary data.

🎯 Real-World Use Cases

Scenario 1: Building a Startup MVP

Your Team:

1. 🎨 Frontend Developer - Build the React app
2. 🏗️ Backend Architect - Design the API and database
3. 🚀 Growth Hacker - Plan user acquisition
4. ⚡ Rapid Prototyper - Fast iteration cycles
5. 🔍 Reality Checker - Ensure quality before launch

Result: Ship faster with specialized expertise at every stage.

Scenario 2: Marketing Campaign Launch

Your Team:

1. 📝 Content Creator - Develop campaign content
2. 🐦 Twitter Engager - Twitter strategy and execution
3. 📸 Instagram Curator - Visual content and stories
4. 🤝 Reddit Community Builder - Authentic community engagement
5. 📊 Analytics Reporter - Track and optimize performance

Result: Multi-channel coordinated campaign with platform-specific expertise.

Scenario 3: Enterprise Feature Development

Your Team:

1. 👔 Senior Project Manager - Scope and task planning
2. 💎 Senior Developer - Complex implementation
3. 🎨 UI Designer - Design system and components
4. 🧪 Experiment Tracker - A/B test planning
5. 📸 Evidence Collector - Quality verification
6. 🔍 Reality Checker - Production readiness

Result: Enterprise-grade delivery with quality gates and documentation.

Scenario 4: Paid Media Account Takeover

Your Team:

1. 📋 Paid Media Auditor - Comprehensive account assessment
2. 📡 Tracking & Measurement Specialist - Verify conversion tracking accuracy
3. 💰 PPC Campaign Strategist - Redesign account architecture
4. 🔍 Search Query Analyst - Clean up wasted spend from search terms
5. ✍️ Ad Creative Strategist - Refresh all ad copy and extensions
6. 📊 Analytics Reporter (Support Division) - Build reporting dashboards

Result: Systematic account takeover with tracking verified, waste eliminated, structure optimized, and creative refreshed — all within the first 30 days.

Scenario 5: Full Agency Product Discovery

Your Team: All 8 divisions working in parallel on a single mission.

See the Nexus Spatial Discovery Exercise -- a complete example where 8 agents (Product Trend Researcher, Backend Architect, Brand Guardian, Growth Hacker, Support Responder, UX Researcher, Project Shepherd, and XR Interface Architect) were deployed simultaneously to evaluate a software opportunity and produce a unified product plan covering market validation, technical architecture, brand strategy, go-to-market, support systems, UX research, project execution, and spatial UI design.

Result: Comprehensive, cross-functional product blueprint produced in a single session. More examples.

Scenario 6: Smart Campus Digital Twin

Your Team:

1. 🧠 Technical Consultant - Define the digital twin strategy: BIM for buildings, GIS for campus, IoT for real-time
2. 🏗️ BIM/GIS Specialist - Convert Revit building models to GIS scene layers, design indoor floor plans
3. 🛸 Drone/Reality Mapping - Fly the campus, generate orthomosaic and 3D mesh for context
4. 🌐 Web GIS Developer - Build the campus dashboard with MapLibre, building layer, and room finder
5. 🏔️ 3D & Scene Developer - Create immersive 3D scene with terrain, buildings, and flyover tour
6. 🤖 GeoAI/ML Engineer - Extract building footprints and tree canopy from drone imagery
7. ✅ GIS QA Engineer - Validate data accuracy, check topology, verify CRS consistency

Result: A campus digital twin that combines BIM detail, drone reality capture, 3D visualization, and web accessibility — delivered by coordinated specialists in a single pipeline.

🤝 Contributing

We welcome contributions! Here's how you can help:

Add a New Agent

1. Fork the repository
2. Create a new agent file in the appropriate category
3. Follow the agent template structure:
   • Frontmatter with name, description, color
   • Identity & Memory section
   • Core Mission
   • Critical Rules (domain-specific)
   • Technical Deliverables with examples
   • Workflow Process
   • Success Metrics
4. Submit a PR with your agent

Improve Existing Agents

• Add real-world examples
• Enhance code samples
• Update success metrics
• Improve workflows

Share Your Success Stories

Have you used these agents successfully? Share your story in the Discussions!

📖 Agent Design Philosophy

Each agent is designed with:

1. 🎭 Strong Personality: Not generic templates - real character and voice
2. 📋 Clear Deliverables: Concrete outputs, not vague guidance
3. ✅ Success Metrics: Measurable outcomes and quality standards
4. 🔄 Proven Workflows: Step-by-step processes that work
5. 💡 Learning Memory: Pattern recognition and continuous improvement

🎁 What Makes This Special?

Unlike Generic AI Prompts:

• ❌ Generic "Act as a developer" prompts
• ✅ Deep specialization with personality and process

Unlike Prompt Libraries:

• ❌ One-off prompt collections
• ✅ Comprehensive agent systems with workflows and deliverables

Unlike AI Tools:

• ❌ Black box tools you can't customize
• ✅ Transparent, forkable, adaptable agent personalities

🎨 Agent Personality Highlights

"I don't just test your code - I default to finding 3-5 issues and require visual proof for everything."

-- Evidence Collector (Testing Division)

"You're not marketing on Reddit - you're becoming a valued community member who happens to represent a brand."

-- Reddit Community Builder (Marketing Division)

"Every playful element must serve a functional or emotional purpose. Design delight that enhances rather than distracts."

-- Whimsy Injector (Design Division)

"Let me add a celebration animation that reduces task completion anxiety by 40%"

-- Whimsy Injector (during a UX review)

📊 Stats

• 🎭 230+ Specialized Agents across every division
• 📝 10,000+ lines of personality, process, and code examples
• ⏱️ Months of iteration from real-world usage
• 🌟 Battle-tested in production environments
• 💬 50+ requests in first 12 hours on Reddit

🔌 Multi-Tool Integrations

The Agency works natively with Claude Code, and ships conversion + install scripts so you can use the same agents across every major agentic coding tool.

Supported Tools

• Claude Code — native .md agents, no conversion needed → ~/.claude/agents/
• GitHub Copilot — native .md agents, no conversion needed → ~/.github/agents/ + ~/.copilot/agents/
• Antigravity — SKILL.md per agent → ~/.gemini/config/skills/
• Gemini CLI -- .md agent files -> ~/.gemini/agents/
• OpenCode — .md agent files → .opencode/agents/
• Cursor — .mdc rule files → .cursor/rules/
• Aider — CONVENTIONS.md roster index → ./CONVENTIONS.md
• Windsurf — single .windsurfrules → ./.windsurfrules
• OpenClaw — SOUL.md + AGENTS.md + IDENTITY.md per agent
• Qwen Code — .md SubAgent files → ~/.qwen/agents/
• Kimi Code — YAML agent specs → ~/.config/kimi/agents/
• Codex — TOML custom agents → ~/.codex/agents/
• Osaurus -- SKILL.md skills -> ~/.osaurus/skills/
• Hermes -- lazy-router plugin -> ~/.hermes/plugins/
• DeepSeek Harness — SKILL.md skills → ~/.dsh/skills/ (user) or .dsh/skills/ (project)

⚡ Quick Install

Step 1 -- Generate integration files:

./scripts/convert.sh
# Faster (parallel, output order may vary): ./scripts/convert.sh --parallel

Step 2 -- Install (interactive, auto-detects your tools):

./scripts/install.sh
# Faster (parallel, output order may vary): ./scripts/install.sh --no-interactive --parallel

The installer scans your system for installed tools, shows a checkbox UI, and lets you pick exactly what to install:

  +------------------------------------------------+
  |   The Agency -- Tool Installer                 |
  +------------------------------------------------+

  System scan: [*] = detected on this machine

  [x]  1)  [*]  Claude Code     (claude.ai/code)
  [x]  2)  [*]  Copilot         (~/.github + ~/.copilot)
  [x]  3)  [*]  Antigravity     (~/.gemini/antigravity)
  [ ]  4)  [ ]  Gemini CLI      (~/.gemini/agents)
  [ ]  5)  [ ]  OpenCode        (opencode.ai)
  [ ]  6)  [ ]  OpenClaw        (~/.openclaw/agency-agents)
  [x]  7)  [*]  Cursor          (.cursor/rules)
  [ ]  8)  [ ]  Aider           (CONVENTIONS.md)
  [ ]  9)  [ ]  Windsurf        (.windsurfrules)
  [ ] 10)  [ ]  Qwen Code       (~/.qwen/agents)
  [ ] 11)  [ ]  Kimi Code       (~/.config/kimi/agents)
  [ ] 12)  [ ]  Codex           (~/.codex/agents)
  [ ] 13)  [ ]  Osaurus         (~/.osaurus/skills)
  [ ] 14)  [ ]  Hermes          (~/.hermes/plugins)

  [1-14] toggle   [a] all   [n] none   [d] detected
  [Enter] install   [q] quit

Or install a specific tool directly:

./scripts/install.sh --tool cursor
./scripts/install.sh --tool opencode
./scripts/install.sh --tool openclaw
./scripts/install.sh --tool antigravity
./scripts/install.sh --tool codex
./scripts/install.sh --tool osaurus
./scripts/install.sh --tool hermes

Non-interactive (CI/scripts):

./scripts/install.sh --no-interactive --tool all

Faster runs (parallel) — On multi-core machines, use --parallel so each tool is processed in parallel. Output order across tools is non-deterministic. Works with both interactive and non-interactive install: e.g. ./scripts/install.sh --interactive --parallel (pick tools, then install in parallel) or ./scripts/install.sh --no-interactive --parallel. Job count defaults to nproc (Linux), sysctl -n hw.ncpu (macOS), or 4; override with --jobs N.

./scripts/convert.sh --parallel                    # convert all tools in parallel
./scripts/convert.sh --parallel --jobs 8           # cap parallel jobs
./scripts/install.sh --no-interactive --parallel   # install all detected tools in parallel
./scripts/install.sh --interactive --parallel      # pick tools, then install in parallel
./scripts/install.sh --no-interactive --parallel --jobs 4

Tool-Specific Instructions

Regenerating After Changes

When you add new agents or edit existing ones, regenerate all integration files:

./scripts/convert.sh                    # regenerate all (serial)
./scripts/convert.sh --parallel         # regenerate all in parallel (faster)
./scripts/convert.sh --tool codex       # regenerate just one tool
./scripts/convert.sh --tool cursor      # regenerate just one tool

🗺️ Roadmap

• Interactive agent selector web tool
• Multi-agent workflow examples -- see examples/
• Multi-tool integration scripts (Claude Code, GitHub Copilot, Antigravity, Gemini CLI, OpenCode, OpenClaw, Cursor, Aider, Windsurf, Qwen Code, Kimi Code, Codex, Osaurus, Hermes)
• Video tutorials on agent design
• Community agent marketplace
• Agent "personality quiz" for project matching
• "Agent of the Week" showcase series

🌐 Community Translations & Localizations

Community-maintained translations and regional adaptations. These are independently maintained -- see each repo for coverage and version compatibility.

Want to add a translation? Open an issue and we'll link it here.

📜 License

MIT License - Use freely, commercially or personally. Attribution appreciated but not required.

🙏 Acknowledgments

What started as a Reddit thread about AI agent specialization has grown into something remarkable — 230+ agents across every division, supported by a community of contributors from around the world. Every agent in this repo exists because someone cared enough to write it, test it, and share it.

To everyone who has opened a PR, filed an issue, started a Discussion, or simply tried an agent and told us what worked — thank you. You're the reason The Agency keeps getting better.

💬 Community

• GitHub Discussions: Share your success stories
• Issues: Report bugs or request features
• Reddit: Join the conversation on r/ClaudeAI
• Twitter/X: Share with #TheAgency

🚀 Get Started

1. Browse the agents above and find specialists for your needs
2. Copy the agents to ~/.claude/agents/ for Claude Code integration
3. Activate agents by referencing them in your Claude conversations
4. Customize agent personalities and workflows for your specific needs
5. Share your results and contribute back to the community