GitHub - shaedis/agency-agents: 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
Skip to content

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

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

 
 

Latest commit

 

History

293 Commits

Folders and files

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: Install with APM (Agent Package Manager)

APM is Microsoft's open-source dependency manager for AI agents — like npm but for agent configurations. Works with Claude, Copilot, Cursor, Codex, and Gemini.

Install APM:

curl -sSL https://raw.githubusercontent.com/microsoft/apm/main/install.sh | sh

Install the entire Agency roster (all 55+ agents):

apm install shaedis/agency-agents
apm compile

apm compile generates CLAUDE.md and AGENTS.md automatically — every agent is immediately available across all supported AI tools.

Install a whole division (skill):

# Engineering team
apm install shaedis/agency-agents/engineering

# Design team
apm install shaedis/agency-agents/design

# Marketing team
apm install shaedis/agency-agents/marketing

# Product team
apm install shaedis/agency-agents/product

# Project Management team
apm install shaedis/agency-agents/project-management

# Testing team
apm install shaedis/agency-agents/testing

# Support team
apm install shaedis/agency-agents/support

# Spatial Computing team
apm install shaedis/agency-agents/spatial-computing

# Specialized agents
apm install shaedis/agency-agents/specialized

apm compile

Install a single agent:

# Example: just the Frontend Developer
apm install shaedis/agency-agents/engineering/engineering-frontend-developer.md

# Example: just the Growth Hacker
apm install shaedis/agency-agents/marketing/marketing-growth-hacker.md

# Example: just the Reality Checker
apm install shaedis/agency-agents/testing/testing-reality-checker.md

apm compile

Option 2: Use with Claude Code (Manual)

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

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

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

Option 3: Use as Reference

Each agent file contains:

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

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

Option 3: Use with Other Tools (GitHub Copilot, Antigravity, Gemini CLI, OpenCode, OpenClaw, Cursor, Aider, Windsurf, Kimi Code)

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

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

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

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
🔧 Filament Optimization Specialist Filament PHP admin UX, structural form redesign, resource optimization Restructuring Filament resources/forms/tables for faster, cleaner admin workflows
🔒 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
🧭 Codebase Onboarding Engineer Fast developer onboarding, read-only codebase exploration, factual explanation Helping new developers understand unfamiliar repos quickly by reading the code, tracing code paths, and stating facts about structure and behavior
📚 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
🧱 CMS Developer WordPress & Drupal themes, plugins/modules, content architecture Code-first CMS implementation and customization
📧 Email Intelligence Engineer Email parsing, MIME extraction, structured data for AI agents Turning raw email threads into reasoning-ready context
🎙️ Voice AI Integration Engineer Speech-to-text pipelines, Whisper, ASR, speaker diarization End-to-end transcription pipelines, audio preprocessing, structured transcript delivery

🎨 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
🎯 Sales Outreach Cold prospecting, multi-touch cadences, objection handling, proposals Top-of-funnel B2B outreach — from cold email to booked discovery call

📢 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
🇨🇳 China Market Localization Strategist Full-stack China market localization, Douyin/Xiaohongshu/WeChat GTM Turning trend signals into executable China go-to-market strategies
🎬 Video Optimization Specialist YouTube algorithm strategy, chaptering, thumbnail concepts YouTube channel growth, video SEO, audience retention optimization

📊 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
🏗️ Civil Engineer Structural analysis, geotechnical design, global building codes Multi-standard structural engineering across Eurocode, ACI, AISC, and more
🎧 Customer Service Omnichannel support, complaint handling, retention, escalation Any industry customer support — retail, SaaS, hospitality, finance, logistics
🏥 Healthcare Customer Service HIPAA-aware patient support, billing, insurance, emergency routing Healthcare organizations needing compliant, empathetic patient support
🏨 Hospitality Guest Services Reservations, concierge, complaint recovery, loyalty, events Hotels, resorts, restaurants, and event venues
🤝 HR Onboarding Pre-boarding, compliance, benefits enrollment, 30-60-90 day plans Any company onboarding new hires — from startups to enterprise
🌐 Language Translator Spanish ↔ English translation, dialect awareness, cultural context Travel, business, medical, and legal translation needs
⏱️ Legal Billing & Time Tracking Time capture, billing narratives, IOLTA compliance, collections Law firms maximizing revenue recovery and billing accuracy
📋 Legal Client Intake Prospect qualification, conflict screening, consultation scheduling Law firms converting inquiries into retained clients
⚖️ Legal Document Review Contract review, risk flagging, version comparison, compliance Attorney-ready first-pass review across any practice area
🏦 Loan Officer Assistant Borrower intake, TRID compliance, pipeline tracking, closing coordination Mortgage and consumer lending teams
🏠 Real Estate Buyer & Seller Buyer/seller representation, offers, transaction coordination Residential and investment real estate transactions
🛒 Retail Customer Returns Return processing, fraud prevention, exchanges, vendor returns Brick-and-mortar, e-commerce, and omnichannel retail

💵 Finance Division

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

Agent Specialty When to Use
📒 Bookkeeper & Controller Month-end close, reconciliation, GAAP compliance, internal controls Day-to-day accounting operations, audit readiness, financial record-keeping
📊 Financial Analyst Financial modeling, forecasting, scenario analysis, decision support Three-statement models, variance analysis, data-driven business intelligence
📈 FP&A Analyst Budgeting, rolling forecasts, variance analysis, business reviews Annual operating plans, monthly business reviews, strategic resource allocation
🔍 Investment Researcher Due diligence, portfolio analysis, asset valuation, equity research Investment thesis development, risk assessment, market research
🏛️ Tax Strategist Tax optimization, multi-jurisdictional compliance, transfer pricing Entity structuring, ETR analysis, audit defense, strategic tax planning

🎮 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 4: Paid Media Account Takeover

Your Team:

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

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


Scenario 5: Full Agency Product Discovery

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

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

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


🤝 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/
  • Antigravity — SKILL.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
  • OpenClaw — SOUL.md + AGENTS.md + IDENTITY.md per agent
  • Qwen Code — .md SubAgent files → ~/.qwen/agents/
  • Kimi Code — YAML agent specs → ~/.config/kimi/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/agency-agents)
  [x]  7)  [*]  Cursor          (.cursor/rules)
  [ ]  8)  [ ]  Aider           (CONVENTIONS.md)
  [ ]  9)  [ ]  Windsurf        (.windsurfrules)
  [ ] 10)  [ ]  Qwen Code       (~/.qwen/agents)
  [ ] 11)  [ ]  Kimi Code       (~/.config/kimi/agents)

  [1-11] 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/convert.sh --tool openclaw
./scripts/install.sh --tool openclaw

If the openclaw CLI is available, the installer registers each workspace automatically. Run openclaw gateway restart after installation so the new agents are activated.

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

Kimi Code

Agents are converted to Kimi Code CLI format (YAML + system prompt) and installed to ~/.config/kimi/agents/.

# Convert and install
./scripts/convert.sh --tool kimi
./scripts/install.sh --tool kimi

Usage with Kimi Code:

# Use an agent
kimi --agent-file ~/.config/kimi/agents/frontend-developer/agent.yaml

# In a project
kimi --agent-file ~/.config/kimi/agents/frontend-developer/agent.yaml \
     --work-dir /your/project \
     "Review this React component"

See integrations/kimi/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 (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, Kimi 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 141 translated agents + 46 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. Install via APM (apm install msitarzewski/agency-agents && apm compile) or manually copy to ~/.claude/agents/
  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

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages