Skip to content

msitarzewski/agency-agents

Repository files navigation

🎭 The Agency: AI Specialists Ready to Transform Your Workflow

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.

GitHub stars License: MIT PRs Welcome Sponsor


🚀 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 copilot
./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
Autonomous Optimization Architect LLM routing, cost optimization, shadow testing Autonomous systems needing intelligent API selection and cost guardrails
🔩 Embedded Firmware Engineer Bare-metal, RTOS, ESP32/STM32/Nordic firmware Production-grade embedded systems and IoT devices
🚨 Incident Response Commander Incident management, post-mortems, on-call Managing production incidents and building incident readiness
⛓️ Solidity Smart Contract Engineer EVM contracts, gas optimization, DeFi Secure, gas-optimized smart contracts and DeFi protocols
📚 Technical Writer Developer docs, API reference, tutorials Clear, accurate technical documentation
🎯 Threat Detection Engineer SIEM rules, threat hunting, ATT&CK mapping Building detection layers and threat hunting
💬 WeChat Mini Program Developer WeChat ecosystem, Mini Programs, payment integration Building performant apps for the WeChat ecosystem
👁️ Code Reviewer Constructive code review, security, maintainability PR reviews, code quality gates, mentoring through review
🗄️ Database Optimizer Schema design, query optimization, indexing strategies PostgreSQL/MySQL tuning, slow query debugging, migration planning
🌿 Git Workflow Master Branching strategies, conventional commits, advanced Git Git workflow design, history cleanup, CI-friendly branch management
🏛️ Software Architect System design, DDD, architectural patterns, trade-off analysis Architecture decisions, domain modeling, system evolution strategy
🛡️ SRE SLOs, error budgets, observability, chaos engineering Production reliability, toil reduction, capacity planning
🧬 AI Data Remediation Engineer Self-healing pipelines, air-gapped SLMs, semantic clustering Fixing broken data at scale with zero data loss
🔧 Data Engineer Data pipelines, lakehouse architecture, ETL/ELT Building reliable data infrastructure and warehousing
🔗 Feishu Integration Developer Feishu/Lark Open Platform, bots, workflows Building integrations for the Feishu ecosystem

🎨 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
🌈 Inclusive Visuals Specialist Representation, bias mitigation, authentic imagery Generating culturally accurate AI images and video

💰 Paid Media Division

Turning ad spend into measurable business outcomes.

Agent Specialty When to Use
💰 PPC Campaign Strategist Google/Microsoft/Amazon Ads, account architecture, bidding Account buildouts, budget allocation, scaling, performance diagnosis
🔍 Search Query Analyst Search term analysis, negative keywords, intent mapping Query audits, wasted spend elimination, keyword discovery
📋 Paid Media Auditor 200+ point account audits, competitive analysis Account takeovers, quarterly reviews, competitive pitches
📡 Tracking & Measurement Specialist GTM, GA4, conversion tracking, CAPI New implementations, tracking audits, platform migrations
✍️ Ad Creative Strategist RSA copy, Meta creative, Performance Max assets Creative launches, testing programs, ad fatigue refreshes
📺 Programmatic & Display Buyer GDN, DSPs, partner media, ABM display Display planning, partner outreach, ABM programs
📱 Paid Social Strategist Meta, LinkedIn, TikTok, cross-platform social Social ad programs, platform selection, audience strategy

💼 Sales Division

Turning pipeline into revenue through craft, not CRM busywork.

Agent Specialty When to Use
🎯 Outbound Strategist Signal-based prospecting, multi-channel sequences, ICP targeting Building pipeline through research-driven outreach, not volume
🔍 Discovery Coach SPIN, Gap Selling, Sandler — question design and call structure Preparing for discovery calls, qualifying opportunities, coaching reps
♟️ Deal Strategist MEDDPICC qualification, competitive positioning, win planning Scoring deals, exposing pipeline risk, building win strategies
🛠️ Sales Engineer Technical demos, POC scoping, competitive battlecards Pre-sales technical wins, demo prep, competitive positioning
🏹 Proposal Strategist RFP response, win themes, narrative structure Writing proposals that persuade, not just comply
📊 Pipeline Analyst Forecasting, pipeline health, deal velocity, RevOps Pipeline reviews, forecast accuracy, revenue operations
🗺️ Account Strategist Land-and-expand, QBRs, stakeholder mapping Post-sale expansion, account planning, NRR growth
🏋️ Sales Coach Rep development, call coaching, pipeline review facilitation Making every rep and every deal better through structured coaching

📢 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
🇨🇳 Baidu SEO Specialist Baidu optimization, China SEO, ICP compliance Ranking in Baidu and reaching China's search market
🎬 Bilibili Content Strategist B站 algorithm, danmaku culture, UP主 growth Building audiences on Bilibili with community-first content
🎠 Carousel Growth Engine TikTok/Instagram carousels, autonomous publishing Generating and publishing viral carousel content
💼 LinkedIn Content Creator Personal branding, thought leadership, professional content LinkedIn growth, professional audience building, B2B content
🛒 China E-Commerce Operator Taobao, Tmall, Pinduoduo, live commerce Running multi-platform e-commerce in China
🎥 Kuaishou Strategist Kuaishou, 老铁 community, grassroots growth Building authentic audiences in lower-tier markets
🔍 SEO Specialist Technical SEO, content strategy, link building Driving sustainable organic search growth
📘 Book Co-Author Thought-leadership books, ghostwriting, publishing Strategic book collaboration for founders and experts
🌏 Cross-Border E-Commerce Specialist Amazon, Shopee, Lazada, cross-border fulfillment Full-funnel cross-border e-commerce strategy
🎵 Douyin Strategist Douyin platform, short-video marketing, algorithm Growing audiences on China's leading short-video platform
🎙️ Livestream Commerce Coach Host training, live room optimization, conversion Building high-performing livestream e-commerce operations
🎧 Podcast Strategist Podcast content strategy, platform optimization Chinese podcast market strategy and operations
🔒 Private Domain Operator WeCom, private traffic, community operations Building enterprise WeChat private domain ecosystems
🎬 Short-Video Editing Coach Post-production, editing workflows, platform specs Hands-on short-video editing training and optimization
🔥 Weibo Strategist Sina Weibo, trending topics, fan engagement Full-spectrum Weibo operations and growth
🔮 AI Citation Strategist AEO/GEO, AI recommendation visibility, citation auditing Improving brand visibility across ChatGPT, Claude, Gemini, Perplexity

📊 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
🧠 Behavioral Nudge Engine Behavioral psychology, nudge design, engagement Maximizing user motivation through behavioral science

| 🧭 Product Manager | Full lifecycle product ownership | Discovery, PRDs, roadmap planning, GTM, outcome measurement |

🎬 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
📋 Jira Workflow Steward Git workflow, branch strategy, traceability Enforcing Jira-linked Git discipline and delivery

🧪 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
🔍 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
🔗 Identity Graph Operator Shared identity resolution for multi-agent systems Entity deduplication, merge proposals, cross-agent identity consistency
💸 Accounts Payable Agent Payment processing, vendor management, audit Autonomous payment execution across crypto, fiat, stablecoins
🛡️ Blockchain Security Auditor Smart contract audits, exploit analysis Finding vulnerabilities in contracts before deployment
📋 Compliance Auditor SOC 2, ISO 27001, HIPAA, PCI-DSS Guiding organizations through compliance certification
🌍 Cultural Intelligence Strategist Global UX, representation, cultural exclusion Ensuring software resonates across cultures
🗣️ Developer Advocate Community building, DX, developer content Bridging product and developer community
🔬 Model QA Specialist ML audits, feature analysis, interpretability End-to-end QA for machine learning models
🗃️ ZK Steward Knowledge management, Zettelkasten, notes Building connected, validated knowledge bases
🔌 MCP Builder Model Context Protocol servers, AI agent tooling Building MCP servers that extend AI agent capabilities
📄 Document Generator PDF, PPTX, DOCX, XLSX generation from code Professional document creation, reports, data visualization
⚙️ Automation Governance Architect Automation governance, n8n, workflow auditing Evaluating and governing business automations at scale
📚 Corporate Training Designer Enterprise training, curriculum development Designing training systems and learning programs
🏛️ Government Digital Presales Consultant China ToG presales, digital transformation Government digital transformation proposals and bids
⚕️ Healthcare Marketing Compliance China healthcare advertising compliance Healthcare marketing regulatory compliance
🎯 Recruitment Specialist Talent acquisition, recruiting operations Recruitment strategy, sourcing, and hiring processes
🎓 Study Abroad Advisor International education, application planning Study abroad planning across US, UK, Canada, Australia
🔗 Supply Chain Strategist Supply chain management, procurement strategy Supply chain optimization and procurement planning
🗺️ Workflow Architect Workflow discovery, mapping, and specification Mapping every path through a system before code is written
☁️ Salesforce Architect Multi-cloud Salesforce design, governor limits, integrations Enterprise Salesforce architecture, org strategy, deployment pipelines
🇫🇷 French Consulting Market Navigator ESN/SI ecosystem, portage salarial, rate positioning Freelance consulting in the French IT market
🇰🇷 Korean Business Navigator Korean business culture, 품의 process, relationship mechanics Foreign professionals navigating Korean business relationships

🎮 Game Development Division

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

Cross-Engine Agents (Engine-Agnostic)

Agent Specialty When to Use
🎯 Game Designer Systems design, GDD authorship, economy balancing, gameplay loops Designing game mechanics, progression systems, writing design documents
🗺️ Level Designer Layout theory, pacing, encounter design, environmental storytelling Building levels, designing encounter flow, spatial narrative
🎨 Technical Artist Shaders, VFX, LOD pipeline, art-to-engine optimization Bridging art and engineering, shader authoring, performance-safe asset pipelines
🔊 Game Audio Engineer FMOD/Wwise, adaptive music, spatial audio, audio budgets Interactive audio systems, dynamic music, audio performance
📖 Narrative Designer Story systems, branching dialogue, lore architecture Writing branching narratives, implementing dialogue systems, world lore

Unity

Agent Specialty When to Use
🏗️ Unity Architect ScriptableObjects, data-driven modularity, DOTS/ECS Large-scale Unity projects, data-driven system design, ECS performance work
Unity Shader Graph Artist Shader Graph, HLSL, URP/HDRP, Renderer Features Custom Unity materials, VFX shaders, post-processing passes
🌐 Unity Multiplayer Engineer Netcode for GameObjects, Unity Relay/Lobby, server authority, prediction Online Unity games, client prediction, Unity Gaming Services integration
🛠️ Unity Editor Tool Developer EditorWindows, AssetPostprocessors, PropertyDrawers, build validation Custom Unity Editor tooling, pipeline automation, content validation

Unreal Engine

Agent Specialty When to Use
⚙️ Unreal Systems Engineer C++/Blueprint hybrid, GAS, Nanite constraints, memory management Complex Unreal gameplay systems, Gameplay Ability System, engine-level C++
🎨 Unreal Technical Artist Material Editor, Niagara, PCG, Substrate Unreal materials, Niagara VFX, procedural content generation
🌐 Unreal Multiplayer Architect Actor replication, GameMode/GameState hierarchy, dedicated server Unreal online games, replication graphs, server authoritative Unreal
🗺️ Unreal World Builder World Partition, Landscape, HLOD, LWC Large open-world Unreal levels, streaming systems, terrain at scale

Godot

Agent Specialty When to Use
📜 Godot Gameplay Scripter GDScript 2.0, signals, composition, static typing Godot gameplay systems, scene composition, performance-conscious GDScript
🌐 Godot Multiplayer Engineer MultiplayerAPI, ENet/WebRTC, RPCs, authority model Online Godot games, scene replication, server-authoritative Godot
Godot Shader Developer Godot shading language, VisualShader, RenderingDevice Custom Godot materials, 2D/3D effects, post-processing, compute shaders

Blender

Agent Specialty When to Use
🧩 Blender Addon Engineer Blender Python (bpy), custom operators/panels, asset validators, exporters, pipeline automation Building Blender add-ons, asset prep tools, export workflows, and DCC pipeline automation

Roblox Studio

Agent Specialty When to Use
⚙️ Roblox Systems Scripter Luau, RemoteEvents/Functions, DataStore, server-authoritative module architecture Building secure Roblox game systems, client-server communication, data persistence
🎯 Roblox Experience Designer Engagement loops, monetization, D1/D7 retention, onboarding flow Designing Roblox game loops, Game Passes, daily rewards, player retention
👗 Roblox Avatar Creator UGC pipeline, accessory rigging, Creator Marketplace submission Roblox UGC items, HumanoidDescription customization, in-experience avatar shops

📚 Academic Division

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

Agent Specialty When to Use
🌍 Anthropologist Cultural systems, kinship, rituals, belief systems Designing culturally coherent societies with internal logic
🌐 Geographer Physical/human geography, climate, cartography Building geographically coherent worlds with realistic terrain and settlements
📚 Historian Historical analysis, periodization, material culture Validating historical coherence, enriching settings with authentic period detail
📜 Narratologist Narrative theory, story structure, character arcs Analyzing and improving story structure with established theoretical frameworks
🧠 Psychologist Personality theory, motivation, cognitive patterns Building psychologically credible characters grounded in research

🎯 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 5: 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 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

  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

  • 🎭 144 Specialized Agents across 12 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/
  • GitHub Copilot — native .md agents, no conversion needed → ~/.github/agents/ + ~/.copilot/agents/
  • AntigravitySKILL.md per agent → ~/.gemini/antigravity/skills/
  • Gemini CLI — extension + SKILL.md files → ~/.gemini/extensions/agency-agents/
  • OpenCode.md agent files → .opencode/agents/
  • Cursor.mdc rule files → .cursor/rules/
  • Aider — single CONVENTIONS.md./CONVENTIONS.md
  • Windsurf — single .windsurfrules./.windsurfrules
  • OpenClawSOUL.md + AGENTS.md + IDENTITY.md per agent
  • Qwen Code.md SubAgent files → ~/.qwen/agents/

⚡ 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 extension)
  [ ]  5)  [ ]  OpenCode        (opencode.ai)
  [ ]  6)  [ ]  OpenClaw        (~/.openclaw)
  [x]  7)  [*]  Cursor          (.cursor/rules)
  [ ]  8)  [ ]  Aider           (CONVENTIONS.md)
  [ ]  9)  [ ]  Windsurf        (.windsurfrules)
  [ ] 10)  [ ]  Qwen Code       (~/.qwen/agents)

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

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

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.

GitHub Copilot

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

./scripts/install.sh --tool copilot

Then activate in GitHub Copilot:

Use the Frontend Developer agent to review this component.

See integrations/github-copilot/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 one skill per agent plus a manifest. On a fresh clone, generate the Gemini extension files before running the installer.

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

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

OpenCode

Agents are placed in .opencode/agents/ 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/agents
cp integrations/opencode/agents/*.md ~/.config/opencode/agents/

Activate in OpenCode:

@backend-architect 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.

OpenClaw

Each agent becomes a workspace with SOUL.md, AGENTS.md, and IDENTITY.md in ~/.openclaw/agency-agents/.

./scripts/install.sh --tool openclaw

Agents are registered and available by agentId in OpenClaw sessions.

See integrations/openclaw/README.md for details.

Qwen Code

SubAgents are installed to .qwen/agents/ in your project root (project-scoped).

# Convert and install (run from your project root)
cd /your/project
./scripts/convert.sh --tool qwen
./scripts/install.sh --tool qwen

Usage in Qwen Code:

  • Reference by name: Use the frontend-developer agent to review this component
  • Or let Qwen auto-delegate based on task context
  • Manage via /agents command in interactive mode

📚 Qwen SubAgents Docs


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 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)
  • 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 100 translated agents + 9 China-market originals
🇨🇳 简体中文 (zh-CN) @dsclca12 agent-teams Independent translation with Bilibili, WeChat, Xiaohongshu localization

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


🔗 Related Resources


📜 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 — 147 agents across 12 divisions, 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


🚀 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

🎭 The Agency: Your AI Dream Team Awaits 🎭

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

Made with ❤️ by the community, for the community

About

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.

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages