npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

@apparaomulpuri/agency-agents

v1.1.0

Published

193 battle-tested AI agent personalities for Claude Code, Cursor, and 8+ other AI coding tools

Downloads

20

Readme

🎭 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

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.

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.

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.

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.

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.

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.

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.

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.

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.

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
  • [x] Multi-agent workflow examples -- see examples/
  • [x] 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