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: Batt
Add this skill
npx mdskills install msitarzewski/agency-agentsComprehensive collection of specialized AI agent personas with strong documentation but lacks individual agent detail
1# 🎭 The Agency: AI Specialists Ready to Transform Your Workflow23> **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.45[](https://github.com/msitarzewski/agency-agents)6[](https://opensource.org/licenses/MIT)7[](https://makeapullrequest.com)8[](https://github.com/sponsors/msitarzewski)910---1112## 🚀 What Is This?1314Born from a Reddit thread and months of iteration, **The Agency** is a growing collection of meticulously crafted AI agent personalities. Each agent is:1516- **🎯 Specialized**: Deep expertise in their domain (not generic prompt templates)17- **🧠 Personality-Driven**: Unique voice, communication style, and approach18- **📋 Deliverable-Focused**: Real code, processes, and measurable outcomes19- **✅ Production-Ready**: Battle-tested workflows and success metrics2021**Think of it as**: Assembling your dream team, except they're AI specialists who never sleep, never complain, and always deliver.2223---2425## ⚡ Quick Start2627### Option 1: Use with Claude Code (Recommended)2829```bash30# Copy agents to your Claude Code directory31cp -r agency-agents/* ~/.claude/agents/3233# Now activate any agent in your Claude Code sessions:34# "Hey Claude, activate Frontend Developer mode and help me build a React component"35```3637### Option 2: Use as Reference3839Each agent file contains:40- Identity & personality traits41- Core mission & workflows42- Technical deliverables with code examples43- Success metrics & communication style4445Browse the agents below and copy/adapt the ones you need!4647### Option 3: Use with Other Tools (Cursor, Aider, Windsurf, Gemini CLI, OpenCode)4849```bash50# Step 1 -- generate integration files for all supported tools51./scripts/convert.sh5253# Step 2 -- install interactively (auto-detects what you have installed)54./scripts/install.sh5556# Or target a specific tool directly57./scripts/install.sh --tool cursor58./scripts/install.sh --tool copilot59./scripts/install.sh --tool aider60./scripts/install.sh --tool windsurf61```6263See the [Multi-Tool Integrations](#-multi-tool-integrations) section below for full details.6465---6667## 🎨 The Agency Roster6869### 💻 Engineering Division7071Building the future, one commit at a time.7273| Agent | Specialty | When to Use |74|-------|-----------|-------------|75| 🎨 [Frontend Developer](engineering/engineering-frontend-developer.md) | React/Vue/Angular, UI implementation, performance | Modern web apps, pixel-perfect UIs, Core Web Vitals optimization |76| 🏗️ [Backend Architect](engineering/engineering-backend-architect.md) | API design, database architecture, scalability | Server-side systems, microservices, cloud infrastructure |77| 📱 [Mobile App Builder](engineering/engineering-mobile-app-builder.md) | iOS/Android, React Native, Flutter | Native and cross-platform mobile applications |78| 🤖 [AI Engineer](engineering/engineering-ai-engineer.md) | ML models, deployment, AI integration | Machine learning features, data pipelines, AI-powered apps |79| 🚀 [DevOps Automator](engineering/engineering-devops-automator.md) | CI/CD, infrastructure automation, cloud ops | Pipeline development, deployment automation, monitoring |80| ⚡ [Rapid Prototyper](engineering/engineering-rapid-prototyper.md) | Fast POC development, MVPs | Quick proof-of-concepts, hackathon projects, fast iteration |81| 💎 [Senior Developer](engineering/engineering-senior-developer.md) | Laravel/Livewire, advanced patterns | Complex implementations, architecture decisions |82| 🔒 [Security Engineer](engineering/engineering-security-engineer.md) | Threat modeling, secure code review, security architecture | Application security, vulnerability assessment, security CI/CD |8384### 🎨 Design Division8586Making it beautiful, usable, and delightful.8788| Agent | Specialty | When to Use |89|-------|-----------|-------------|90| 🎯 [UI Designer](design/design-ui-designer.md) | Visual design, component libraries, design systems | Interface creation, brand consistency, component design |91| 🔍 [UX Researcher](design/design-ux-researcher.md) | User testing, behavior analysis, research | Understanding users, usability testing, design insights |92| 🏛️ [UX Architect](design/design-ux-architect.md) | Technical architecture, CSS systems, implementation | Developer-friendly foundations, implementation guidance |93| 🎭 [Brand Guardian](design/design-brand-guardian.md) | Brand identity, consistency, positioning | Brand strategy, identity development, guidelines |94| 📖 [Visual Storyteller](design/design-visual-storyteller.md) | Visual narratives, multimedia content | Compelling visual stories, brand storytelling |95| ✨ [Whimsy Injector](design/design-whimsy-injector.md) | Personality, delight, playful interactions | Adding joy, micro-interactions, Easter eggs, brand personality |96| 📷 [Image Prompt Engineer](design/design-image-prompt-engineer.md) | AI image generation prompts, photography | Photography prompts for Midjourney, DALL-E, Stable Diffusion |9798### 📢 Marketing Division99100Growing your audience, one authentic interaction at a time.101102| Agent | Specialty | When to Use |103|-------|-----------|-------------|104| 🚀 [Growth Hacker](marketing/marketing-growth-hacker.md) | Rapid user acquisition, viral loops, experiments | Explosive growth, user acquisition, conversion optimization |105| 📝 [Content Creator](marketing/marketing-content-creator.md) | Multi-platform content, editorial calendars | Content strategy, copywriting, brand storytelling |106| 🐦 [Twitter Engager](marketing/marketing-twitter-engager.md) | Real-time engagement, thought leadership | Twitter strategy, LinkedIn campaigns, professional social |107| 📱 [TikTok Strategist](marketing/marketing-tiktok-strategist.md) | Viral content, algorithm optimization | TikTok growth, viral content, Gen Z/Millennial audience |108| 📸 [Instagram Curator](marketing/marketing-instagram-curator.md) | Visual storytelling, community building | Instagram strategy, aesthetic development, visual content |109| 🤝 [Reddit Community Builder](marketing/marketing-reddit-community-builder.md) | Authentic engagement, value-driven content | Reddit strategy, community trust, authentic marketing |110| 📱 [App Store Optimizer](marketing/marketing-app-store-optimizer.md) | ASO, conversion optimization, discoverability | App marketing, store optimization, app growth |111| 🌐 [Social Media Strategist](marketing/marketing-social-media-strategist.md) | Cross-platform strategy, campaigns | Overall social strategy, multi-platform campaigns |112| 📕 [Xiaohongshu Specialist](marketing/marketing-xiaohongshu-specialist.md) | Lifestyle content, trend-driven strategy | Xiaohongshu growth, aesthetic storytelling, Gen Z audience |113| 💬 [WeChat Official Account Manager](marketing/marketing-wechat-official-account.md) | Subscriber engagement, content marketing | WeChat OA strategy, community building, conversion optimization |114| 🧠 [Zhihu Strategist](marketing/marketing-zhihu-strategist.md) | Thought leadership, knowledge-driven engagement | Zhihu authority building, Q&A strategy, lead generation |115116### 📊 Product Division117118Building the right thing at the right time.119120| Agent | Specialty | When to Use |121|-------|-----------|-------------|122| 🎯 [Sprint Prioritizer](product/product-sprint-prioritizer.md) | Agile planning, feature prioritization | Sprint planning, resource allocation, backlog management |123| 🔍 [Trend Researcher](product/product-trend-researcher.md) | Market intelligence, competitive analysis | Market research, opportunity assessment, trend identification |124| 💬 [Feedback Synthesizer](product/product-feedback-synthesizer.md) | User feedback analysis, insights extraction | Feedback analysis, user insights, product priorities |125126### 🎬 Project Management Division127128Keeping the trains running on time (and under budget).129130| Agent | Specialty | When to Use |131|-------|-----------|-------------|132| 🎬 [Studio Producer](project-management/project-management-studio-producer.md) | High-level orchestration, portfolio management | Multi-project oversight, strategic alignment, resource allocation |133| 🐑 [Project Shepherd](project-management/project-management-project-shepherd.md) | Cross-functional coordination, timeline management | End-to-end project coordination, stakeholder management |134| ⚙️ [Studio Operations](project-management/project-management-studio-operations.md) | Day-to-day efficiency, process optimization | Operational excellence, team support, productivity |135| 🧪 [Experiment Tracker](project-management/project-management-experiment-tracker.md) | A/B tests, hypothesis validation | Experiment management, data-driven decisions, testing |136| 👔 [Senior Project Manager](project-management/project-manager-senior.md) | Realistic scoping, task conversion | Converting specs to tasks, scope management |137138### 🧪 Testing Division139140Breaking things so users don't have to.141142| Agent | Specialty | When to Use |143|-------|-----------|-------------|144| 📸 [Evidence Collector](testing/testing-evidence-collector.md) | Screenshot-based QA, visual proof | UI testing, visual verification, bug documentation |145| 🔍 [Reality Checker](testing/testing-reality-checker.md) | Evidence-based certification, quality gates | Production readiness, quality approval, release certification |146| 📊 [Test Results Analyzer](testing/testing-test-results-analyzer.md) | Test evaluation, metrics analysis | Test output analysis, quality insights, coverage reporting |147| ⚡ [Performance Benchmarker](testing/testing-performance-benchmarker.md) | Performance testing, optimization | Speed testing, load testing, performance tuning |148| 🔌 [API Tester](testing/testing-api-tester.md) | API validation, integration testing | API testing, endpoint verification, integration QA |149| 🛠️ [Tool Evaluator](testing/testing-tool-evaluator.md) | Technology assessment, tool selection | Evaluating tools, software recommendations, tech decisions |150| 🔄 [Workflow Optimizer](testing/testing-workflow-optimizer.md) | Process analysis, workflow improvement | Process optimization, efficiency gains, automation opportunities |151| ♿ [Accessibility Auditor](testing/testing-accessibility-auditor.md) | WCAG auditing, assistive technology testing | Accessibility compliance, screen reader testing, inclusive design verification |152153### 🛟 Support Division154155The backbone of the operation.156157| Agent | Specialty | When to Use |158|-------|-----------|-------------|159| 💬 [Support Responder](support/support-support-responder.md) | Customer service, issue resolution | Customer support, user experience, support operations |160| 📊 [Analytics Reporter](support/support-analytics-reporter.md) | Data analysis, dashboards, insights | Business intelligence, KPI tracking, data visualization |161| 💰 [Finance Tracker](support/support-finance-tracker.md) | Financial planning, budget management | Financial analysis, cash flow, business performance |162| 🏗️ [Infrastructure Maintainer](support/support-infrastructure-maintainer.md) | System reliability, performance optimization | Infrastructure management, system operations, monitoring |163| ⚖️ [Legal Compliance Checker](support/support-legal-compliance-checker.md) | Compliance, regulations, legal review | Legal compliance, regulatory requirements, risk management |164| 📑 [Executive Summary Generator](support/support-executive-summary-generator.md) | C-suite communication, strategic summaries | Executive reporting, strategic communication, decision support |165166### 🥽 Spatial Computing Division167168Building the immersive future.169170| Agent | Specialty | When to Use |171|-------|-----------|-------------|172| 🏗️ [XR Interface Architect](spatial-computing/xr-interface-architect.md) | Spatial interaction design, immersive UX | AR/VR/XR interface design, spatial computing UX |173| 💻 [macOS Spatial/Metal Engineer](spatial-computing/macos-spatial-metal-engineer.md) | Swift, Metal, high-performance 3D | macOS spatial computing, Vision Pro native apps |174| 🌐 [XR Immersive Developer](spatial-computing/xr-immersive-developer.md) | WebXR, browser-based AR/VR | Browser-based immersive experiences, WebXR apps |175| 🎮 [XR Cockpit Interaction Specialist](spatial-computing/xr-cockpit-interaction-specialist.md) | Cockpit-based controls, immersive systems | Cockpit control systems, immersive control interfaces |176| 🍎 [visionOS Spatial Engineer](spatial-computing/visionos-spatial-engineer.md) | Apple Vision Pro development | Vision Pro apps, spatial computing experiences |177| 🔌 [Terminal Integration Specialist](spatial-computing/terminal-integration-specialist.md) | Terminal integration, command-line tools | CLI tools, terminal workflows, developer tools |178179### 🎯 Specialized Division180181The unique specialists who don't fit in a box.182183| Agent | Specialty | When to Use |184|-------|-----------|-------------|185| 🎭 [Agents Orchestrator](specialized/agents-orchestrator.md) | Multi-agent coordination, workflow management | Complex projects requiring multiple agent coordination |186| 📊 [Data Analytics Reporter](specialized/data-analytics-reporter.md) | Business intelligence, data insights | Deep data analysis, business metrics, strategic insights |187| 🔍 [LSP/Index Engineer](specialized/lsp-index-engineer.md) | Language Server Protocol, code intelligence | Code intelligence systems, LSP implementation, semantic indexing |188| 📥 [Sales Data Extraction Agent](specialized/sales-data-extraction-agent.md) | Excel monitoring, sales metric extraction | Sales data ingestion, MTD/YTD/Year End metrics |189| 📈 [Data Consolidation Agent](specialized/data-consolidation-agent.md) | Sales data aggregation, dashboard reports | Territory summaries, rep performance, pipeline snapshots |190| 📬 [Report Distribution Agent](specialized/report-distribution-agent.md) | Automated report delivery | Territory-based report distribution, scheduled sends |191| 🔐 [Agentic Identity & Trust Architect](specialized/agentic-identity-trust.md) | Agent identity, authentication, trust verification | Multi-agent identity systems, agent authorization, audit trails |192| 🔗 [Identity Graph Operator](specialized/identity-graph-operator.md) | Shared identity resolution for multi-agent systems | Entity deduplication, merge proposals, cross-agent identity consistency |193194### 🎮 Game Development Division195196Building worlds, systems, and experiences across every major engine.197198#### Cross-Engine Agents (Engine-Agnostic)199200| Agent | Specialty | When to Use |201|-------|-----------|-------------|202| 🎯 [Game Designer](game-development/game-designer.md) | Systems design, GDD authorship, economy balancing, gameplay loops | Designing game mechanics, progression systems, writing design documents |203| 🗺️ [Level Designer](game-development/level-designer.md) | Layout theory, pacing, encounter design, environmental storytelling | Building levels, designing encounter flow, spatial narrative |204| 🎨 [Technical Artist](game-development/technical-artist.md) | Shaders, VFX, LOD pipeline, art-to-engine optimization | Bridging art and engineering, shader authoring, performance-safe asset pipelines |205| 🔊 [Game Audio Engineer](game-development/game-audio-engineer.md) | FMOD/Wwise, adaptive music, spatial audio, audio budgets | Interactive audio systems, dynamic music, audio performance |206| 📖 [Narrative Designer](game-development/narrative-designer.md) | Story systems, branching dialogue, lore architecture | Writing branching narratives, implementing dialogue systems, world lore |207208#### Unity209210| Agent | Specialty | When to Use |211|-------|-----------|-------------|212| 🏗️ [Unity Architect](game-development/unity/unity-architect.md) | ScriptableObjects, data-driven modularity, DOTS/ECS | Large-scale Unity projects, data-driven system design, ECS performance work |213| ✨ [Unity Shader Graph Artist](game-development/unity/unity-shader-graph-artist.md) | Shader Graph, HLSL, URP/HDRP, Renderer Features | Custom Unity materials, VFX shaders, post-processing passes |214| 🌐 [Unity Multiplayer Engineer](game-development/unity/unity-multiplayer-engineer.md) | Netcode for GameObjects, Unity Relay/Lobby, server authority, prediction | Online Unity games, client prediction, Unity Gaming Services integration |215| 🛠️ [Unity Editor Tool Developer](game-development/unity/unity-editor-tool-developer.md) | EditorWindows, AssetPostprocessors, PropertyDrawers, build validation | Custom Unity Editor tooling, pipeline automation, content validation |216217#### Unreal Engine218219| Agent | Specialty | When to Use |220|-------|-----------|-------------|221| ⚙️ [Unreal Systems Engineer](game-development/unreal-engine/unreal-systems-engineer.md) | C++/Blueprint hybrid, GAS, Nanite constraints, memory management | Complex Unreal gameplay systems, Gameplay Ability System, engine-level C++ |222| 🎨 [Unreal Technical Artist](game-development/unreal-engine/unreal-technical-artist.md) | Material Editor, Niagara, PCG, Substrate | Unreal materials, Niagara VFX, procedural content generation |223| 🌐 [Unreal Multiplayer Architect](game-development/unreal-engine/unreal-multiplayer-architect.md) | Actor replication, GameMode/GameState hierarchy, dedicated server | Unreal online games, replication graphs, server authoritative Unreal |224| 🗺️ [Unreal World Builder](game-development/unreal-engine/unreal-world-builder.md) | World Partition, Landscape, HLOD, LWC | Large open-world Unreal levels, streaming systems, terrain at scale |225226#### Godot227228| Agent | Specialty | When to Use |229|-------|-----------|-------------|230| 📜 [Godot Gameplay Scripter](game-development/godot/godot-gameplay-scripter.md) | GDScript 2.0, signals, composition, static typing | Godot gameplay systems, scene composition, performance-conscious GDScript |231| 🌐 [Godot Multiplayer Engineer](game-development/godot/godot-multiplayer-engineer.md) | MultiplayerAPI, ENet/WebRTC, RPCs, authority model | Online Godot games, scene replication, server-authoritative Godot |232| ✨ [Godot Shader Developer](game-development/godot/godot-shader-developer.md) | Godot shading language, VisualShader, RenderingDevice | Custom Godot materials, 2D/3D effects, post-processing, compute shaders |233234#### Roblox Studio235236| Agent | Specialty | When to Use |237|-------|-----------|-------------|238| ⚙️ [Roblox Systems Scripter](game-development/roblox-studio/roblox-systems-scripter.md) | Luau, RemoteEvents/Functions, DataStore, server-authoritative module architecture | Building secure Roblox game systems, client-server communication, data persistence |239| 🎯 [Roblox Experience Designer](game-development/roblox-studio/roblox-experience-designer.md) | Engagement loops, monetization, D1/D7 retention, onboarding flow | Designing Roblox game loops, Game Passes, daily rewards, player retention |240| 👗 [Roblox Avatar Creator](game-development/roblox-studio/roblox-avatar-creator.md) | UGC pipeline, accessory rigging, Creator Marketplace submission | Roblox UGC items, HumanoidDescription customization, in-experience avatar shops |241242---243244## 🎯 Real-World Use Cases245246### Scenario 1: Building a Startup MVP247248**Your Team**:2491. 🎨 **Frontend Developer** - Build the React app2502. 🏗️ **Backend Architect** - Design the API and database2513. 🚀 **Growth Hacker** - Plan user acquisition2524. ⚡ **Rapid Prototyper** - Fast iteration cycles2535. 🔍 **Reality Checker** - Ensure quality before launch254255**Result**: Ship faster with specialized expertise at every stage.256257---258259### Scenario 2: Marketing Campaign Launch260261**Your Team**:2621. 📝 **Content Creator** - Develop campaign content2632. 🐦 **Twitter Engager** - Twitter strategy and execution2643. 📸 **Instagram Curator** - Visual content and stories2654. 🤝 **Reddit Community Builder** - Authentic community engagement2665. 📊 **Analytics Reporter** - Track and optimize performance267268**Result**: Multi-channel coordinated campaign with platform-specific expertise.269270---271272### Scenario 3: Enterprise Feature Development273274**Your Team**:2751. 👔 **Senior Project Manager** - Scope and task planning2762. 💎 **Senior Developer** - Complex implementation2773. 🎨 **UI Designer** - Design system and components2784. 🧪 **Experiment Tracker** - A/B test planning2795. 📸 **Evidence Collector** - Quality verification2806. 🔍 **Reality Checker** - Production readiness281282**Result**: Enterprise-grade delivery with quality gates and documentation.283284---285286### Scenario 4: Full Agency Product Discovery287288**Your Team**: All 8 divisions working in parallel on a single mission.289290See the **[Nexus Spatial Discovery Exercise](examples/nexus-spatial-discovery.md)** -- 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.291292**Result**: Comprehensive, cross-functional product blueprint produced in a single session. [More examples](examples/).293294---295296## 🤝 Contributing297298We welcome contributions! Here's how you can help:299300### Add a New Agent3013021. Fork the repository3032. Create a new agent file in the appropriate category3043. Follow the agent template structure:305 - Frontmatter with name, description, color306 - Identity & Memory section307 - Core Mission308 - Critical Rules (domain-specific)309 - Technical Deliverables with examples310 - Workflow Process311 - Success Metrics3124. Submit a PR with your agent313314### Improve Existing Agents315316- Add real-world examples317- Enhance code samples318- Update success metrics319- Improve workflows320321### Share Your Success Stories322323Have you used these agents successfully? Share your story in the [Discussions](https://github.com/msitarzewski/agency-agents/discussions)!324325---326327## 📖 Agent Design Philosophy328329Each agent is designed with:3303311. **🎭 Strong Personality**: Not generic templates - real character and voice3322. **📋 Clear Deliverables**: Concrete outputs, not vague guidance3333. **✅ Success Metrics**: Measurable outcomes and quality standards3344. **🔄 Proven Workflows**: Step-by-step processes that work3355. **💡 Learning Memory**: Pattern recognition and continuous improvement336337---338339## 🎁 What Makes This Special?340341### Unlike Generic AI Prompts:342- ❌ Generic "Act as a developer" prompts343- ✅ Deep specialization with personality and process344345### Unlike Prompt Libraries:346- ❌ One-off prompt collections347- ✅ Comprehensive agent systems with workflows and deliverables348349### Unlike AI Tools:350- ❌ Black box tools you can't customize351- ✅ Transparent, forkable, adaptable agent personalities352353---354355## 🎨 Agent Personality Highlights356357> "I don't just test your code - I default to finding 3-5 issues and require visual proof for everything."358>359> -- **Evidence Collector** (Testing Division)360361> "You're not marketing on Reddit - you're becoming a valued community member who happens to represent a brand."362>363> -- **Reddit Community Builder** (Marketing Division)364365> "Every playful element must serve a functional or emotional purpose. Design delight that enhances rather than distracts."366>367> -- **Whimsy Injector** (Design Division)368369> "Let me add a celebration animation that reduces task completion anxiety by 40%"370>371> -- **Whimsy Injector** (during a UX review)372373---374375## 📊 Stats376377- 🎭 **80 Specialized Agents** across 10 divisions378- 📝 **10,000+ lines** of personality, process, and code examples379- ⏱️ **Months of iteration** from real-world usage380- 🌟 **Battle-tested** in production environments381- 💬 **50+ requests** in first 12 hours on Reddit382383---384385## 🔌 Multi-Tool Integrations386387The Agency works natively with Claude Code, and ships conversion + install scripts so you can use the same agents across every major agentic coding tool.388389### Supported Tools390391- **[Claude Code](https://claude.ai/code)** — native `.md` agents, no conversion needed → `~/.claude/agents/`392- **[Github Copilot](https://github.com/copilot)** — native `.md` agents, no conversion needed → `~/.github/agents/`393- **[Antigravity](https://github.com/google-gemini/antigravity)** — `SKILL.md` per agent → `~/.gemini/antigravity/skills/`394- **[Gemini CLI](https://github.com/google-gemini/gemini-cli)** — extension + `SKILL.md` files → `~/.gemini/extensions/agency-agents/`395- **[OpenCode](https://opencode.ai)** — `.md` agent files → `.opencode/agent/`396- **[Cursor](https://cursor.sh)** — `.mdc` rule files → `.cursor/rules/`397- **[Aider](https://aider.chat)** — single `CONVENTIONS.md` → `./CONVENTIONS.md`398- **[Windsurf](https://codeium.com/windsurf)** — single `.windsurfrules` → `./.windsurfrules`399400---401402### ⚡ Quick Install403404**Step 1 -- Generate integration files:**405```bash406./scripts/convert.sh407```408409**Step 2 -- Install (interactive, auto-detects your tools):**410```bash411./scripts/install.sh412```413414The installer scans your system for installed tools, shows a checkbox UI, and lets you pick exactly what to install:415416```417 +------------------------------------------------+418 | The Agency -- Tool Installer |419 +------------------------------------------------+420421 System scan: [*] = detected on this machine422423 [x] 1) [*] Claude Code (claude.ai/code)424 [x] 2) [*] Copilot (~/.github/agents)425 [x] 3) [*] Antigravity (~/.gemini/antigravity)426 [ ] 4) [ ] Gemini CLI (gemini extension)427 [ ] 5) [ ] OpenCode (opencode.ai)428 [x] 6) [*] Cursor (.cursor/rules)429 [ ] 7) [ ] Aider (CONVENTIONS.md)430 [ ] 8) [ ] Windsurf (.windsurfrules)431432 [1-8] toggle [a] all [n] none [d] detected433 [Enter] install [q] quit434```435436**Or install a specific tool directly:**437```bash438./scripts/install.sh --tool cursor439./scripts/install.sh --tool opencode440./scripts/install.sh --tool antigravity441```442443**Non-interactive (CI/scripts):**444```bash445./scripts/install.sh --no-interactive --tool all446```447448---449450### Tool-Specific Instructions451452<details>453<summary><strong>Claude Code</strong></summary>454455Agents are copied directly from the repo into `~/.claude/agents/` -- no conversion needed.456457```bash458./scripts/install.sh --tool claude-code459```460461Then activate in Claude Code:462```463Use the Frontend Developer agent to review this component.464```465466See [integrations/claude-code/README.md](integrations/claude-code/README.md) for details.467</details>468469<details>470<summary><strong>Github Copilot</strong></summary>471472Agents are copied directly from the repo into `~/.github/agents/` -- no conversion needed.473474```bash475./scripts/install.sh --tool copilot476```477478Then activate in Github Copilot:479```480Use the Frontend Developer agent to review this component.481```482483See [integrations/github-copilot/README.md](integrations/github-copilot/README.md) for details.484</details>485486<details>487<summary><strong>Antigravity (Gemini)</strong></summary>488489Each agent becomes a skill in `~/.gemini/antigravity/skills/agency-<slug>/`.490491```bash492./scripts/install.sh --tool antigravity493```494495Activate in Gemini with Antigravity:496```497@agency-frontend-developer review this React component498```499500See [integrations/antigravity/README.md](integrations/antigravity/README.md) for details.501</details>502503<details>504<summary><strong>Gemini CLI</strong></summary>505506Installs as a Gemini CLI extension with 80 skills + a manifest.507508```bash509./scripts/install.sh --tool gemini-cli510```511512See [integrations/gemini-cli/README.md](integrations/gemini-cli/README.md) for details.513</details>514515<details>516<summary><strong>OpenCode</strong></summary>517518Agents are placed in `.opencode/agent/` in your project root (project-scoped).519520```bash521cd /your/project522/path/to/agency-agents/scripts/install.sh --tool opencode523```524525Or install globally:526```bash527mkdir -p ~/.config/opencode/agent528cp integrations/opencode/agent/*.md ~/.config/opencode/agent/529```530531Activate in OpenCode:532```533Use the Backend Architect agent to design this API.534```535536See [integrations/opencode/README.md](integrations/opencode/README.md) for details.537</details>538539<details>540<summary><strong>Cursor</strong></summary>541542Each agent becomes a `.mdc` rule file in `.cursor/rules/` of your project.543544```bash545cd /your/project546/path/to/agency-agents/scripts/install.sh --tool cursor547```548549Rules are auto-applied when Cursor detects them in the project. Reference them explicitly:550```551Use the @security-engineer rules to review this code.552```553554See [integrations/cursor/README.md](integrations/cursor/README.md) for details.555</details>556557<details>558<summary><strong>Aider</strong></summary>559560All agents are compiled into a single `CONVENTIONS.md` file that Aider reads automatically.561562```bash563cd /your/project564/path/to/agency-agents/scripts/install.sh --tool aider565```566567Then reference agents in your Aider session:568```569Use the Frontend Developer agent to refactor this component.570```571572See [integrations/aider/README.md](integrations/aider/README.md) for details.573</details>574575<details>576<summary><strong>Windsurf</strong></summary>577578All agents are compiled into `.windsurfrules` in your project root.579580```bash581cd /your/project582/path/to/agency-agents/scripts/install.sh --tool windsurf583```584585Reference agents in Windsurf's Cascade:586```587Use the Reality Checker agent to verify this is production ready.588```589590See [integrations/windsurf/README.md](integrations/windsurf/README.md) for details.591</details>592593---594595### Regenerating After Changes596597When you add new agents or edit existing ones, regenerate all integration files:598599```bash600./scripts/convert.sh # regenerate all601./scripts/convert.sh --tool cursor # regenerate just one tool602```603604---605606## 🗺️ Roadmap607608- [ ] Interactive agent selector web tool609- [x] Multi-agent workflow examples -- see [examples/](examples/)610- [x] Multi-tool integration scripts (Claude Code, Antigravity, Gemini CLI, OpenCode, Cursor, Aider, Windsurf)611- [ ] Video tutorials on agent design612- [ ] Community agent marketplace613- [ ] Agent "personality quiz" for project matching614- [ ] "Agent of the Week" showcase series615616---617618## 🌐 Community Translations & Localizations619620Community-maintained translations and regional adaptations. These are independently maintained -- see each repo for coverage and version compatibility.621622| Language | Maintainer | Link | Notes |623|----------|-----------|------|-------|624| 🇨🇳 简体中文 (zh-CN) | [@jnMetaCode](https://github.com/jnMetaCode) | [agency-agents-zh](https://github.com/jnMetaCode/agency-agents-zh) | 100 translated agents + 9 China-market originals |625626Want to add a translation? Open an issue and we'll link it here.627628---629630## 🔗 Related Resources631632- [Awesome OpenClaw Agents](https://github.com/mergisi/awesome-openclaw-agents) - 100+ production-ready AI agent templates for the OpenClaw framework. SOUL.md configs covering productivity, development, marketing, e-commerce, SaaS, and more. Deploys to Telegram, Slack, Discord, and WhatsApp.633634---635636## 📜 License637638MIT License - Use freely, commercially or personally. Attribution appreciated but not required.639640---641642## 🙏 Acknowledgments643644Born from a Reddit discussion about AI agent specialization. Thanks to the community for the feedback, requests, and inspiration.645646Special recognition to the 50+ Redditors who requested this within the first 12 hours - you proved there's demand for real, specialized AI agent systems.647648---649650## 💬 Community651652- **GitHub Discussions**: [Share your success stories](https://github.com/msitarzewski/agency-agents/discussions)653- **Issues**: [Report bugs or request features](https://github.com/msitarzewski/agency-agents/issues)654- **Reddit**: Join the conversation on r/ClaudeAI655- **Twitter/X**: Share with #TheAgency656657---658659## 🚀 Get Started6606611. **Browse** the agents above and find specialists for your needs6622. **Copy** the agents to `~/.claude/agents/` for Claude Code integration6633. **Activate** agents by referencing them in your Claude conversations6644. **Customize** agent personalities and workflows for your specific needs6655. **Share** your results and contribute back to the community666667---668669<div align="center">670671**🎭 The Agency: Your AI Dream Team Awaits 🎭**672673[⭐ Star this repo](https://github.com/msitarzewski/agency-agents) • [🍴 Fork it](https://github.com/msitarzewski/agency-agents/fork) • [🐛 Report an issue](https://github.com/msitarzewski/agency-agents/issues) • [❤️ Sponsor](https://github.com/sponsors/msitarzewski)674675Made with ❤️ by the community, for the community676677</div>678
Full transparency — inspect the skill content before installing.