A complete AI agency at your fingertips - From frontend wizards to Reddit community ninjas, from whimsy injectors to reality checkers. Each agent is a specialized expert with personality, processes, and proven deliverables.

🚀 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: Use with Claude Code (Recommended)

# Copy agents to your Claude Code directory
cp -r agency-agents/* ~/.claude/agents/

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

Option 2: 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 3: Use with Other Tools (Cursor, Aider, Windsurf, Gemini CLI, OpenCode)

# 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 cursor
./scripts/install.sh --tool aider
./scripts/install.sh --tool windsurf

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

🎨 The Agency Roster

💻 Engineering Division

Building the future, one commit at a time.

Agent	Specialty	When to Use
🎨 Frontend Developer	React/Vue/Angular, UI implementation, performance	Modern web apps, pixel-perfect UIs, Core Web Vitals optimization
🏗️ Backend Architect	API design, database architecture, scalability	Server-side systems, microservices, cloud infrastructure
📱 Mobile App Builder	iOS/Android, React Native, Flutter	Native and cross-platform mobile applications
🤖 AI Engineer	ML models, deployment, AI integration	Machine learning features, data pipelines, AI-powered apps
🚀 DevOps Automator	CI/CD, infrastructure automation, cloud ops	Pipeline development, deployment automation, monitoring
⚡ Rapid Prototyper	Fast POC development, MVPs	Quick proof-of-concepts, hackathon projects, fast iteration
💎 Senior Developer	Laravel/Livewire, advanced patterns	Complex implementations, architecture decisions
🔒 Security Engineer	Threat modeling, secure code review, security architecture	Application security, vulnerability assessment, security CI/CD

🎨 Design Division

Making it beautiful, usable, and delightful.

Agent	Specialty	When to Use
🎯 UI Designer	Visual design, component libraries, design systems	Interface creation, brand consistency, component design
🔍 UX Researcher	User testing, behavior analysis, research	Understanding users, usability testing, design insights
🏛️ UX Architect	Technical architecture, CSS systems, implementation	Developer-friendly foundations, implementation guidance
🎭 Brand Guardian	Brand identity, consistency, positioning	Brand strategy, identity development, guidelines
📖 Visual Storyteller	Visual narratives, multimedia content	Compelling visual stories, brand storytelling
✨ Whimsy Injector	Personality, delight, playful interactions	Adding joy, micro-interactions, Easter eggs, brand personality
📷 Image Prompt Engineer	AI image generation prompts, photography	Photography prompts for Midjourney, DALL-E, Stable Diffusion

📢 Marketing Division

Growing your audience, one authentic interaction at a time.

Agent	Specialty	When to Use
🚀 Growth Hacker	Rapid user acquisition, viral loops, experiments	Explosive growth, user acquisition, conversion optimization
📝 Content Creator	Multi-platform content, editorial calendars	Content strategy, copywriting, brand storytelling
🐦 Twitter Engager	Real-time engagement, thought leadership	Twitter strategy, LinkedIn campaigns, professional social
📱 TikTok Strategist	Viral content, algorithm optimization	TikTok growth, viral content, Gen Z/Millennial audience
📸 Instagram Curator	Visual storytelling, community building	Instagram strategy, aesthetic development, visual content
🤝 Reddit Community Builder	Authentic engagement, value-driven content	Reddit strategy, community trust, authentic marketing
📱 App Store Optimizer	ASO, conversion optimization, discoverability	App marketing, store optimization, app growth
🌐 Social Media Strategist	Cross-platform strategy, campaigns	Overall social strategy, multi-platform campaigns
📕 Xiaohongshu Specialist	Lifestyle content, trend-driven strategy	Xiaohongshu growth, aesthetic storytelling, Gen Z audience
💬 WeChat Official Account Manager	Subscriber engagement, content marketing	WeChat OA strategy, community building, conversion optimization
🧠 Zhihu Strategist	Thought leadership, knowledge-driven engagement	Zhihu authority building, Q&A strategy, lead generation

📊 Product Division

Building the right thing at the right time.

Agent	Specialty	When to Use
🎯 Sprint Prioritizer	Agile planning, feature prioritization	Sprint planning, resource allocation, backlog management
🔍 Trend Researcher	Market intelligence, competitive analysis	Market research, opportunity assessment, trend identification
💬 Feedback Synthesizer	User feedback analysis, insights extraction	Feedback analysis, user insights, product priorities

🎬 Project Management Division

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

Agent	Specialty	When to Use
🎬 Studio Producer	High-level orchestration, portfolio management	Multi-project oversight, strategic alignment, resource allocation
🐑 Project Shepherd	Cross-functional coordination, timeline management	End-to-end project coordination, stakeholder management
⚙️ Studio Operations	Day-to-day efficiency, process optimization	Operational excellence, team support, productivity
🧪 Experiment Tracker	A/B tests, hypothesis validation	Experiment management, data-driven decisions, testing
👔 Senior Project Manager	Realistic scoping, task conversion	Converting specs to tasks, scope management

🧪 Testing Division

Breaking things so users don't have to.

Agent	Specialty	When to Use
📸 Evidence Collector	Screenshot-based QA, visual proof	UI testing, visual verification, bug documentation
🔍 Reality Checker	Evidence-based certification, quality gates	Production readiness, quality approval, release certification
📊 Test Results Analyzer	Test evaluation, metrics analysis	Test output analysis, quality insights, coverage reporting
⚡ Performance Benchmarker	Performance testing, optimization	Speed testing, load testing, performance tuning
🔌 API Tester	API validation, integration testing	API testing, endpoint verification, integration QA
🛠️ Tool Evaluator	Technology assessment, tool selection	Evaluating tools, software recommendations, tech decisions
🔄 Workflow Optimizer	Process analysis, workflow improvement	Process optimization, efficiency gains, automation opportunities
♿ Accessibility Auditor	WCAG auditing, assistive technology testing	Accessibility compliance, screen reader testing, inclusive design verification

🛟 Support Division

The backbone of the operation.

Agent	Specialty	When to Use
💬 Support Responder	Customer service, issue resolution	Customer support, user experience, support operations
📊 Analytics Reporter	Data analysis, dashboards, insights	Business intelligence, KPI tracking, data visualization
💰 Finance Tracker	Financial planning, budget management	Financial analysis, cash flow, business performance
🏗️ Infrastructure Maintainer	System reliability, performance optimization	Infrastructure management, system operations, monitoring
⚖️ Legal Compliance Checker	Compliance, regulations, legal review	Legal compliance, regulatory requirements, risk management
📑 Executive Summary Generator	C-suite communication, strategic summaries	Executive reporting, strategic communication, decision support

🥽 Spatial Computing Division

Building the immersive future.

Agent	Specialty	When to Use
🏗️ XR Interface Architect	Spatial interaction design, immersive UX	AR/VR/XR interface design, spatial computing UX
💻 macOS Spatial/Metal Engineer	Swift, Metal, high-performance 3D	macOS spatial computing, Vision Pro native apps
🌐 XR Immersive Developer	WebXR, browser-based AR/VR	Browser-based immersive experiences, WebXR apps
🎮 XR Cockpit Interaction Specialist	Cockpit-based controls, immersive systems	Cockpit control systems, immersive control interfaces
🍎 visionOS Spatial Engineer	Apple Vision Pro development	Vision Pro apps, spatial computing experiences
🔌 Terminal Integration Specialist	Terminal integration, command-line tools	CLI tools, terminal workflows, developer tools

🎯 Specialized Division

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

Agent	Specialty	When to Use
🎭 Agents Orchestrator	Multi-agent coordination, workflow management	Complex projects requiring multiple agent coordination
📊 Data Analytics Reporter	Business intelligence, data insights	Deep data analysis, business metrics, strategic insights
🔍 LSP/Index Engineer	Language Server Protocol, code intelligence	Code intelligence systems, LSP implementation, semantic indexing
📥 Sales Data Extraction Agent	Excel monitoring, sales metric extraction	Sales data ingestion, MTD/YTD/Year End metrics
📈 Data Consolidation Agent	Sales data aggregation, dashboard reports	Territory summaries, rep performance, pipeline snapshots
📬 Report Distribution Agent	Automated report delivery	Territory-based report distribution, scheduled sends
🔐 Agentic Identity & Trust Architect	Agent identity, authentication, trust verification	Multi-agent identity systems, agent authorization, audit trails

🎯 Real-World Use Cases

Scenario 1: Building a Startup MVP

Your Team:

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

Result: Ship faster with specialized expertise at every stage.

Scenario 2: Marketing Campaign Launch

Your Team:

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

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

Scenario 3: Enterprise Feature Development

Your Team:

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

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

Scenario 4: 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.

🤝 Contributing

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

Add a New Agent

Fork the repository
Create a new agent file in the appropriate category
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
Submit a PR with your agent

Improve Existing Agents

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

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

📖 Agent Design Philosophy

Each agent is designed with:

🎭 Strong Personality: Not generic templates - real character and voice
📋 Clear Deliverables: Concrete outputs, not vague guidance
✅ Success Metrics: Measurable outcomes and quality standards
🔄 Proven Workflows: Step-by-step processes that work
💡 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

🎭 61 Specialized Agents across 9 divisions
📝 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/
Antigravity — SKILL.md per agent → ~/.gemini/antigravity/skills/
Gemini CLI — extension + SKILL.md files → ~/.gemini/extensions/agency-agents/
OpenCode — .md agent files → .opencode/agent/
Cursor — .mdc rule files → .cursor/rules/
Aider — single CONVENTIONS.md → ./CONVENTIONS.md
Windsurf — single .windsurfrules → ./.windsurfrules

⚡ Quick Install

Step 1 -- Generate integration files:

./scripts/convert.sh

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

./scripts/install.sh

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)  [*]  Antigravity     (~/.gemini/antigravity)
  [ ]  3)  [ ]  Gemini CLI      (gemini extension)
  [ ]  4)  [ ]  OpenCode        (opencode.ai)
  [x]  5)  [*]  Cursor          (.cursor/rules)
  [ ]  6)  [ ]  Aider           (CONVENTIONS.md)
  [ ]  7)  [ ]  Windsurf        (.windsurfrules)

  [1-7] 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 antigravity

Non-interactive (CI/scripts):

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

Tool-Specific Instructions

Claude Code

Agents are copied directly from the repo into ~/.claude/agents/ -- no conversion needed.

./scripts/install.sh --tool claude-code

Then activate in Claude Code:

Use the Frontend Developer agent to review this component.

See integrations/claude-code/README.md for details.

Antigravity (Gemini)

Each agent becomes a skill in ~/.gemini/antigravity/skills/agency-<slug>/.

./scripts/install.sh --tool antigravity

Activate in Gemini with Antigravity:

@agency-frontend-developer review this React component

See integrations/antigravity/README.md for details.

Gemini CLI

Installs as a Gemini CLI extension with 61 skills + a manifest.

./scripts/install.sh --tool gemini-cli

See integrations/gemini-cli/README.md for details.

OpenCode

Agents are placed in .opencode/agent/ in your project root (project-scoped).

cd /your/project
/path/to/agency-agents/scripts/install.sh --tool opencode

Or install globally:

mkdir -p ~/.config/opencode/agent
cp integrations/opencode/agent/*.md ~/.config/opencode/agent/

Activate in OpenCode:

Use the Backend Architect agent to design this API.

See integrations/opencode/README.md for details.

Cursor

Each agent becomes a .mdc rule file in .cursor/rules/ of your project.

cd /your/project
/path/to/agency-agents/scripts/install.sh --tool cursor

Rules are auto-applied when Cursor detects them in the project. Reference them explicitly:

Use the @security-engineer rules to review this code.

See integrations/cursor/README.md for details.

Aider

All agents are compiled into a single CONVENTIONS.md file that Aider reads automatically.

cd /your/project
/path/to/agency-agents/scripts/install.sh --tool aider

Then reference agents in your Aider session:

Use the Frontend Developer agent to refactor this component.

See integrations/aider/README.md for details.

Windsurf

All agents are compiled into .windsurfrules in your project root.

cd /your/project
/path/to/agency-agents/scripts/install.sh --tool windsurf

Reference agents in Windsurf's Cascade:

Use the Reality Checker agent to verify this is production ready.

See integrations/windsurf/README.md for details.

Regenerating After Changes

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

./scripts/convert.sh        # regenerate all
./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, Antigravity, Gemini CLI, OpenCode, Cursor, Aider, Windsurf)
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.

Language	Maintainer	Link	Notes
🇨🇳 简体中文 (zh-CN)	@jnMetaCode	agency-agents-zh	26 translated agents + 4 China-market agents

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

Born from a Reddit discussion about AI agent specialization. Thanks to the community for the feedback, requests, and inspiration.

Special recognition to the 50+ Redditors who requested this within the first 12 hours - you proved there's demand for real, specialized AI agent systems.

💬 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

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

🎭 The Agency: Your AI Dream Team Awaits 🎭

⭐ Star this repo • 🍴 Fork it • 🐛 Report an issue • ❤️ Sponsor

Made with ❤️ by the community, for the community

README.md

🎭 The Agency: AI Specialists Ready to Transform Your Workflow

🚀 What Is This?

⚡ Quick Start

Option 1: Use with Claude Code (Recommended)

Option 2: Use as Reference

Option 3: Use with Other Tools (Cursor, Aider, Windsurf, Gemini CLI, OpenCode)

🎨 The Agency Roster

💻 Engineering Division

🎨 Design Division

📢 Marketing Division

📊 Product Division

🎬 Project Management Division

🧪 Testing Division

🛟 Support Division

🥽 Spatial Computing Division

🎯 Specialized Division

🎯 Real-World Use Cases

Scenario 1: Building a Startup MVP

Scenario 2: Marketing Campaign Launch

Scenario 3: Enterprise Feature Development

Scenario 4: Full Agency Product Discovery

🤝 Contributing

Add a New Agent

Improve Existing Agents

Share Your Success Stories

📖 Agent Design Philosophy

🎁 What Makes This Special?

Unlike Generic AI Prompts:

Unlike Prompt Libraries:

Unlike AI Tools:

🎨 Agent Personality Highlights

📊 Stats

🔌 Multi-Tool Integrations

Supported Tools

⚡ Quick Install

Tool-Specific Instructions

Regenerating After Changes

🗺️ Roadmap

🌐 Community Translations & Localizations

📜 License

🙏 Acknowledgments

💬 Community

🚀 Get Started