MCPcopy Index your code
hub / github.com/msitarzewski/agency-agents

github.com/msitarzewski/agency-agents @main

repository ↗ · DeepWiki ↗ · What it actually does → · Ask this repo → · + Follow
8 symbols 23 edges 1 files 0 documented · 0% updated today★ 127,36946 open issues
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 Download the app

🆕 There's an app now

Agency Agents is a native app for macOS, Linux & Windows that browses the entire roster and installs it into Claude Code, Cursor, Codex, Gemini, Osaurus, and more — with a click. No clone, no scripts, and it auto-updates.

Download the latest release · agencyagents.app


🚀 What Is This?

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

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

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


⚡ Quick Start

Option 1: Install the app (Recommended)

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

⬇ Download the latest release — or on a Mac:

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

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

Option 2: Use with Claude Code

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

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

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

Option 3: Use as Reference

Each agent file contains: - Identity & personality traits - Core mission & workflows - Technical deliverables with code examples - Success metrics & communication style

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

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

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

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

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

Install only the teams you need (not everyone wants all 16 divisions):

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

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

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


🎨 The Agency Roster

💻 Engineering Division

Building the future, one commit at a time.

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
🌐 Network Engineer Cisco IOS/IOS-XE, Juniper Junos, Palo Alto PAN-OS Router/switch/firewall configuration, BGP/OSPF, ACLs, show-output troubleshooting
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
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
💬 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
🖧 IT Service Manager ITIL 4 service management Incident/problem/change management, SLAs, CMDB
🪡 Minimal Change Engineer Minimum-viable diffs Fixing only what's asked, no scope creep
📜 OrgScript Engineer OrgScript grammar & AST validation Designing/parsing OrgScript business-logic definitions
🧬 Prompt Engineer LLM prompt design & optimization Turning vague instructions into reliable AI behaviors
🕸️ Multi-Agent Systems Architect Multi-agent pipeline design & governance Topology, context, trust, failure recovery for agent systems
🛒 Drupal Shopping Cart Engineer Drupal Commerce storefronts Catalog, payments, checkout, orders on Drupal 10/11
🛍️ WordPress Shopping Cart Engineer WooCommerce storefronts Catalog, payments, checkout, conversion on WordPress

🎨 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
🎭 Persona Walkthrough Specialist Persona-driven cognitive walkthroughs Simulating user reactions and friction at each scroll position

💰 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, comp

Core symbols most depended-on inside this repo

slugify
called by 1
scripts/build-hermes-plugin.py
parse_agent
called by 1
scripts/build-hermes-plugin.py
collect_agents
called by 1
scripts/build-hermes-plugin.py
plugin_yaml
called by 1
scripts/build-hermes-plugin.py
init_py
called by 1
scripts/build-hermes-plugin.py
readme
called by 1
scripts/build-hermes-plugin.py
build
called by 1
scripts/build-hermes-plugin.py
main
called by 1
scripts/build-hermes-plugin.py

Shape

Function 8

Languages

Python100%

Modules by API surface

scripts/build-hermes-plugin.py8 symbols

Datastores touched

(mongodb)Database · 1 repos
(mysql)Database · 1 repos
ticketsDatabase · 1 repos

For agents

$ claude mcp add agency-agents \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact