{"id":46747283,"url":"https://github.com/msitarzewski/agency-agents","last_synced_at":"2026-03-09T22:01:24.794Z","repository":{"id":341846798,"uuid":"1075372545","full_name":"msitarzewski/agency-agents","owner":"msitarzewski","description":"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.","archived":false,"fork":false,"pushed_at":"2026-03-03T17:40:47.000Z","size":92,"stargazers_count":3141,"open_issues_count":3,"forks_count":573,"subscribers_count":57,"default_branch":"main","last_synced_at":"2026-03-03T19:49:06.656Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/msitarzewski.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":"support/support-analytics-reporter.md","governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-10-13T12:12:29.000Z","updated_at":"2026-03-03T19:48:22.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/msitarzewski/agency-agents","commit_stats":null,"previous_names":["msitarzewski/agency-agents"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/msitarzewski/agency-agents","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/msitarzewski%2Fagency-agents","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/msitarzewski%2Fagency-agents/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/msitarzewski%2Fagency-agents/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/msitarzewski%2Fagency-agents/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/msitarzewski","download_url":"https://codeload.github.com/msitarzewski/agency-agents/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/msitarzewski%2Fagency-agents/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30314365,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-09T20:05:46.299Z","status":"ssl_error","status_checked_at":"2026-03-09T19:57:04.425Z","response_time":61,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-03-09T20:00:32.365Z","updated_at":"2026-03-09T22:01:24.788Z","avatar_url":"https://github.com/msitarzewski.png","language":null,"readme":"# 🎭 The Agency: AI Specialists Ready to Transform Your Workflow\n\n\u003e **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.\n\n[![GitHub stars](https://img.shields.io/github/stars/msitarzewski/agency-agents?style=social)](https://github.com/msitarzewski/agency-agents)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://makeapullrequest.com)\n[![Sponsor](https://img.shields.io/badge/Sponsor-%E2%9D%A4-pink?logo=github)](https://github.com/sponsors/msitarzewski)\n\n---\n\n## 🚀 What Is This?\n\nBorn from a Reddit thread and months of iteration, **The Agency** is a growing collection of meticulously crafted AI agent personalities. Each agent is:\n\n- **🎯 Specialized**: Deep expertise in their domain (not generic prompt templates)\n- **🧠 Personality-Driven**: Unique voice, communication style, and approach\n- **📋 Deliverable-Focused**: Real code, processes, and measurable outcomes\n- **✅ Production-Ready**: Battle-tested workflows and success metrics\n\n**Think of it as**: Assembling your dream team, except they're AI specialists who never sleep, never complain, and always deliver.\n\n---\n\n## ⚡ Quick Start\n\n### Option 1: Use with Claude Code (Recommended)\n\n```bash\n# Copy agents to your Claude Code directory\ncp -r agency-agents/* ~/.claude/agents/\n\n# Now activate any agent in your Claude Code sessions:\n# \"Hey Claude, activate Frontend Developer mode and help me build a React component\"\n```\n\n### Option 2: Use as Reference\n\nEach agent file contains:\n- Identity \u0026 personality traits\n- Core mission \u0026 workflows\n- Technical deliverables with code examples\n- Success metrics \u0026 communication style\n\nBrowse the agents below and copy/adapt the ones you need!\n\n### Option 3: Use with Other Tools (Cursor, Aider, Windsurf, Gemini CLI, OpenCode)\n\n```bash\n# Step 1 -- generate integration files for all supported tools\n./scripts/convert.sh\n\n# Step 2 -- install interactively (auto-detects what you have installed)\n./scripts/install.sh\n\n# Or target a specific tool directly\n./scripts/install.sh --tool cursor\n./scripts/install.sh --tool aider\n./scripts/install.sh --tool windsurf\n```\n\nSee the [Multi-Tool Integrations](#-multi-tool-integrations) section below for full details.\n\n---\n\n## 🎨 The Agency Roster\n\n### 💻 Engineering Division\n\nBuilding the future, one commit at a time.\n\n| Agent | Specialty | When to Use |\n|-------|-----------|-------------|\n| 🎨 [Frontend Developer](engineering/engineering-frontend-developer.md) | React/Vue/Angular, UI implementation, performance | Modern web apps, pixel-perfect UIs, Core Web Vitals optimization |\n| 🏗️ [Backend Architect](engineering/engineering-backend-architect.md) | API design, database architecture, scalability | Server-side systems, microservices, cloud infrastructure |\n| 📱 [Mobile App Builder](engineering/engineering-mobile-app-builder.md) | iOS/Android, React Native, Flutter | Native and cross-platform mobile applications |\n| 🤖 [AI Engineer](engineering/engineering-ai-engineer.md) | ML models, deployment, AI integration | Machine learning features, data pipelines, AI-powered apps |\n| 🚀 [DevOps Automator](engineering/engineering-devops-automator.md) | CI/CD, infrastructure automation, cloud ops | Pipeline development, deployment automation, monitoring |\n| ⚡ [Rapid Prototyper](engineering/engineering-rapid-prototyper.md) | Fast POC development, MVPs | Quick proof-of-concepts, hackathon projects, fast iteration |\n| 💎 [Senior Developer](engineering/engineering-senior-developer.md) | Laravel/Livewire, advanced patterns | Complex implementations, architecture decisions |\n| 🔒 [Security Engineer](engineering/engineering-security-engineer.md) | Threat modeling, secure code review, security architecture | Application security, vulnerability assessment, security CI/CD |\n\n### 🎨 Design Division\n\nMaking it beautiful, usable, and delightful.\n\n| Agent | Specialty | When to Use |\n|-------|-----------|-------------|\n| 🎯 [UI Designer](design/design-ui-designer.md) | Visual design, component libraries, design systems | Interface creation, brand consistency, component design |\n| 🔍 [UX Researcher](design/design-ux-researcher.md) | User testing, behavior analysis, research | Understanding users, usability testing, design insights |\n| 🏛️ [UX Architect](design/design-ux-architect.md) | Technical architecture, CSS systems, implementation | Developer-friendly foundations, implementation guidance |\n| 🎭 [Brand Guardian](design/design-brand-guardian.md) | Brand identity, consistency, positioning | Brand strategy, identity development, guidelines |\n| 📖 [Visual Storyteller](design/design-visual-storyteller.md) | Visual narratives, multimedia content | Compelling visual stories, brand storytelling |\n| ✨ [Whimsy Injector](design/design-whimsy-injector.md) | Personality, delight, playful interactions | Adding joy, micro-interactions, Easter eggs, brand personality |\n| 📷 [Image Prompt Engineer](design/design-image-prompt-engineer.md) | AI image generation prompts, photography | Photography prompts for Midjourney, DALL-E, Stable Diffusion |\n\n### 📢 Marketing Division\n\nGrowing your audience, one authentic interaction at a time.\n\n| Agent | Specialty | When to Use |\n|-------|-----------|-------------|\n| 🚀 [Growth Hacker](marketing/marketing-growth-hacker.md) | Rapid user acquisition, viral loops, experiments | Explosive growth, user acquisition, conversion optimization |\n| 📝 [Content Creator](marketing/marketing-content-creator.md) | Multi-platform content, editorial calendars | Content strategy, copywriting, brand storytelling |\n| 🐦 [Twitter Engager](marketing/marketing-twitter-engager.md) | Real-time engagement, thought leadership | Twitter strategy, LinkedIn campaigns, professional social |\n| 📱 [TikTok Strategist](marketing/marketing-tiktok-strategist.md) | Viral content, algorithm optimization | TikTok growth, viral content, Gen Z/Millennial audience |\n| 📸 [Instagram Curator](marketing/marketing-instagram-curator.md) | Visual storytelling, community building | Instagram strategy, aesthetic development, visual content |\n| 🤝 [Reddit Community Builder](marketing/marketing-reddit-community-builder.md) | Authentic engagement, value-driven content | Reddit strategy, community trust, authentic marketing |\n| 📱 [App Store Optimizer](marketing/marketing-app-store-optimizer.md) | ASO, conversion optimization, discoverability | App marketing, store optimization, app growth |\n| 🌐 [Social Media Strategist](marketing/marketing-social-media-strategist.md) | Cross-platform strategy, campaigns | Overall social strategy, multi-platform campaigns |\n| 📕 [Xiaohongshu Specialist](marketing/marketing-xiaohongshu-specialist.md) | Lifestyle content, trend-driven strategy | Xiaohongshu growth, aesthetic storytelling, Gen Z audience |\n| 💬 [WeChat Official Account Manager](marketing/marketing-wechat-official-account.md) | Subscriber engagement, content marketing | WeChat OA strategy, community building, conversion optimization |\n| 🧠 [Zhihu Strategist](marketing/marketing-zhihu-strategist.md) | Thought leadership, knowledge-driven engagement | Zhihu authority building, Q\u0026A strategy, lead generation |\n\n### 📊 Product Division\n\nBuilding the right thing at the right time.\n\n| Agent | Specialty | When to Use |\n|-------|-----------|-------------|\n| 🎯 [Sprint Prioritizer](product/product-sprint-prioritizer.md) | Agile planning, feature prioritization | Sprint planning, resource allocation, backlog management |\n| 🔍 [Trend Researcher](product/product-trend-researcher.md) | Market intelligence, competitive analysis | Market research, opportunity assessment, trend identification |\n| 💬 [Feedback Synthesizer](product/product-feedback-synthesizer.md) | User feedback analysis, insights extraction | Feedback analysis, user insights, product priorities |\n\n### 🎬 Project Management Division\n\nKeeping the trains running on time (and under budget).\n\n| Agent | Specialty | When to Use |\n|-------|-----------|-------------|\n| 🎬 [Studio Producer](project-management/project-management-studio-producer.md) | High-level orchestration, portfolio management | Multi-project oversight, strategic alignment, resource allocation |\n| 🐑 [Project Shepherd](project-management/project-management-project-shepherd.md) | Cross-functional coordination, timeline management | End-to-end project coordination, stakeholder management |\n| ⚙️ [Studio Operations](project-management/project-management-studio-operations.md) | Day-to-day efficiency, process optimization | Operational excellence, team support, productivity |\n| 🧪 [Experiment Tracker](project-management/project-management-experiment-tracker.md) | A/B tests, hypothesis validation | Experiment management, data-driven decisions, testing |\n| 👔 [Senior Project Manager](project-management/project-manager-senior.md) | Realistic scoping, task conversion | Converting specs to tasks, scope management |\n\n### 🧪 Testing Division\n\nBreaking things so users don't have to.\n\n| Agent | Specialty | When to Use |\n|-------|-----------|-------------|\n| 📸 [Evidence Collector](testing/testing-evidence-collector.md) | Screenshot-based QA, visual proof | UI testing, visual verification, bug documentation |\n| 🔍 [Reality Checker](testing/testing-reality-checker.md) | Evidence-based certification, quality gates | Production readiness, quality approval, release certification |\n| 📊 [Test Results Analyzer](testing/testing-test-results-analyzer.md) | Test evaluation, metrics analysis | Test output analysis, quality insights, coverage reporting |\n| ⚡ [Performance Benchmarker](testing/testing-performance-benchmarker.md) | Performance testing, optimization | Speed testing, load testing, performance tuning |\n| 🔌 [API Tester](testing/testing-api-tester.md) | API validation, integration testing | API testing, endpoint verification, integration QA |\n| 🛠️ [Tool Evaluator](testing/testing-tool-evaluator.md) | Technology assessment, tool selection | Evaluating tools, software recommendations, tech decisions |\n| 🔄 [Workflow Optimizer](testing/testing-workflow-optimizer.md) | Process analysis, workflow improvement | Process optimization, efficiency gains, automation opportunities |\n| ♿ [Accessibility Auditor](testing/testing-accessibility-auditor.md) | WCAG auditing, assistive technology testing | Accessibility compliance, screen reader testing, inclusive design verification |\n\n### 🛟 Support Division\n\nThe backbone of the operation.\n\n| Agent | Specialty | When to Use |\n|-------|-----------|-------------|\n| 💬 [Support Responder](support/support-support-responder.md) | Customer service, issue resolution | Customer support, user experience, support operations |\n| 📊 [Analytics Reporter](support/support-analytics-reporter.md) | Data analysis, dashboards, insights | Business intelligence, KPI tracking, data visualization |\n| 💰 [Finance Tracker](support/support-finance-tracker.md) | Financial planning, budget management | Financial analysis, cash flow, business performance |\n| 🏗️ [Infrastructure Maintainer](support/support-infrastructure-maintainer.md) | System reliability, performance optimization | Infrastructure management, system operations, monitoring |\n| ⚖️ [Legal Compliance Checker](support/support-legal-compliance-checker.md) | Compliance, regulations, legal review | Legal compliance, regulatory requirements, risk management |\n| 📑 [Executive Summary Generator](support/support-executive-summary-generator.md) | C-suite communication, strategic summaries | Executive reporting, strategic communication, decision support |\n\n### 🥽 Spatial Computing Division\n\nBuilding the immersive future.\n\n| Agent | Specialty | When to Use |\n|-------|-----------|-------------|\n| 🏗️ [XR Interface Architect](spatial-computing/xr-interface-architect.md) | Spatial interaction design, immersive UX | AR/VR/XR interface design, spatial computing UX |\n| 💻 [macOS Spatial/Metal Engineer](spatial-computing/macos-spatial-metal-engineer.md) | Swift, Metal, high-performance 3D | macOS spatial computing, Vision Pro native apps |\n| 🌐 [XR Immersive Developer](spatial-computing/xr-immersive-developer.md) | WebXR, browser-based AR/VR | Browser-based immersive experiences, WebXR apps |\n| 🎮 [XR Cockpit Interaction Specialist](spatial-computing/xr-cockpit-interaction-specialist.md) | Cockpit-based controls, immersive systems | Cockpit control systems, immersive control interfaces |\n| 🍎 [visionOS Spatial Engineer](spatial-computing/visionos-spatial-engineer.md) | Apple Vision Pro development | Vision Pro apps, spatial computing experiences |\n| 🔌 [Terminal Integration Specialist](spatial-computing/terminal-integration-specialist.md) | Terminal integration, command-line tools | CLI tools, terminal workflows, developer tools |\n\n### 🎯 Specialized Division\n\nThe unique specialists who don't fit in a box.\n\n| Agent | Specialty | When to Use |\n|-------|-----------|-------------|\n| 🎭 [Agents Orchestrator](specialized/agents-orchestrator.md) | Multi-agent coordination, workflow management | Complex projects requiring multiple agent coordination |\n| 📊 [Data Analytics Reporter](specialized/data-analytics-reporter.md) | Business intelligence, data insights | Deep data analysis, business metrics, strategic insights |\n| 🔍 [LSP/Index Engineer](specialized/lsp-index-engineer.md) | Language Server Protocol, code intelligence | Code intelligence systems, LSP implementation, semantic indexing |\n| 📥 [Sales Data Extraction Agent](specialized/sales-data-extraction-agent.md) | Excel monitoring, sales metric extraction | Sales data ingestion, MTD/YTD/Year End metrics |\n| 📈 [Data Consolidation Agent](specialized/data-consolidation-agent.md) | Sales data aggregation, dashboard reports | Territory summaries, rep performance, pipeline snapshots |\n| 📬 [Report Distribution Agent](specialized/report-distribution-agent.md) | Automated report delivery | Territory-based report distribution, scheduled sends |\n| 🔐 [Agentic Identity \u0026 Trust Architect](specialized/agentic-identity-trust.md) | Agent identity, authentication, trust verification | Multi-agent identity systems, agent authorization, audit trails |\n\n---\n\n## 🎯 Real-World Use Cases\n\n### Scenario 1: Building a Startup MVP\n\n**Your Team**:\n1. 🎨 **Frontend Developer** - Build the React app\n2. 🏗️ **Backend Architect** - Design the API and database\n3. 🚀 **Growth Hacker** - Plan user acquisition\n4. ⚡ **Rapid Prototyper** - Fast iteration cycles\n5. 🔍 **Reality Checker** - Ensure quality before launch\n\n**Result**: Ship faster with specialized expertise at every stage.\n\n---\n\n### Scenario 2: Marketing Campaign Launch\n\n**Your Team**:\n1. 📝 **Content Creator** - Develop campaign content\n2. 🐦 **Twitter Engager** - Twitter strategy and execution\n3. 📸 **Instagram Curator** - Visual content and stories\n4. 🤝 **Reddit Community Builder** - Authentic community engagement\n5. 📊 **Analytics Reporter** - Track and optimize performance\n\n**Result**: Multi-channel coordinated campaign with platform-specific expertise.\n\n---\n\n### Scenario 3: Enterprise Feature Development\n\n**Your Team**:\n1. 👔 **Senior Project Manager** - Scope and task planning\n2. 💎 **Senior Developer** - Complex implementation\n3. 🎨 **UI Designer** - Design system and components\n4. 🧪 **Experiment Tracker** - A/B test planning\n5. 📸 **Evidence Collector** - Quality verification\n6. 🔍 **Reality Checker** - Production readiness\n\n**Result**: Enterprise-grade delivery with quality gates and documentation.\n\n---\n\n### Scenario 4: Full Agency Product Discovery\n\n**Your Team**: All 8 divisions working in parallel on a single mission.\n\nSee 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.\n\n**Result**: Comprehensive, cross-functional product blueprint produced in a single session. [More examples](examples/).\n\n---\n\n## 🤝 Contributing\n\nWe welcome contributions! Here's how you can help:\n\n### Add a New Agent\n\n1. Fork the repository\n2. Create a new agent file in the appropriate category\n3. Follow the agent template structure:\n   - Frontmatter with name, description, color\n   - Identity \u0026 Memory section\n   - Core Mission\n   - Critical Rules (domain-specific)\n   - Technical Deliverables with examples\n   - Workflow Process\n   - Success Metrics\n4. Submit a PR with your agent\n\n### Improve Existing Agents\n\n- Add real-world examples\n- Enhance code samples\n- Update success metrics\n- Improve workflows\n\n### Share Your Success Stories\n\nHave you used these agents successfully? Share your story in the [Discussions](https://github.com/msitarzewski/agency-agents/discussions)!\n\n---\n\n## 📖 Agent Design Philosophy\n\nEach agent is designed with:\n\n1. **🎭 Strong Personality**: Not generic templates - real character and voice\n2. **📋 Clear Deliverables**: Concrete outputs, not vague guidance\n3. **✅ Success Metrics**: Measurable outcomes and quality standards\n4. **🔄 Proven Workflows**: Step-by-step processes that work\n5. **💡 Learning Memory**: Pattern recognition and continuous improvement\n\n---\n\n## 🎁 What Makes This Special?\n\n### Unlike Generic AI Prompts:\n- ❌ Generic \"Act as a developer\" prompts\n- ✅ Deep specialization with personality and process\n\n### Unlike Prompt Libraries:\n- ❌ One-off prompt collections\n- ✅ Comprehensive agent systems with workflows and deliverables\n\n### Unlike AI Tools:\n- ❌ Black box tools you can't customize\n- ✅ Transparent, forkable, adaptable agent personalities\n\n---\n\n## 🎨 Agent Personality Highlights\n\n\u003e \"I don't just test your code - I default to finding 3-5 issues and require visual proof for everything.\"\n\u003e\n\u003e -- **Evidence Collector** (Testing Division)\n\n\u003e \"You're not marketing on Reddit - you're becoming a valued community member who happens to represent a brand.\"\n\u003e\n\u003e -- **Reddit Community Builder** (Marketing Division)\n\n\u003e \"Every playful element must serve a functional or emotional purpose. Design delight that enhances rather than distracts.\"\n\u003e\n\u003e -- **Whimsy Injector** (Design Division)\n\n\u003e \"Let me add a celebration animation that reduces task completion anxiety by 40%\"\n\u003e\n\u003e -- **Whimsy Injector** (during a UX review)\n\n---\n\n## 📊 Stats\n\n- 🎭 **61 Specialized Agents** across 9 divisions\n- 📝 **10,000+ lines** of personality, process, and code examples\n- ⏱️ **Months of iteration** from real-world usage\n- 🌟 **Battle-tested** in production environments\n- 💬 **50+ requests** in first 12 hours on Reddit\n\n---\n\n## 🔌 Multi-Tool Integrations\n\nThe Agency works natively with Claude Code, and ships conversion + install scripts so you can use the same agents across every major agentic coding tool.\n\n### Supported Tools\n\n- **[Claude Code](https://claude.ai/code)** — native `.md` agents, no conversion needed → `~/.claude/agents/`\n- **[Antigravity](https://github.com/google-gemini/antigravity)** — `SKILL.md` per agent → `~/.gemini/antigravity/skills/`\n- **[Gemini CLI](https://github.com/google-gemini/gemini-cli)** — extension + `SKILL.md` files → `~/.gemini/extensions/agency-agents/`\n- **[OpenCode](https://opencode.ai)** — `.md` agent files → `.opencode/agent/`\n- **[Cursor](https://cursor.sh)** — `.mdc` rule files → `.cursor/rules/`\n- **[Aider](https://aider.chat)** — single `CONVENTIONS.md` → `./CONVENTIONS.md`\n- **[Windsurf](https://codeium.com/windsurf)** — single `.windsurfrules` → `./.windsurfrules`\n\n---\n\n### ⚡ Quick Install\n\n**Step 1 -- Generate integration files:**\n```bash\n./scripts/convert.sh\n```\n\n**Step 2 -- Install (interactive, auto-detects your tools):**\n```bash\n./scripts/install.sh\n```\n\nThe installer scans your system for installed tools, shows a checkbox UI, and lets you pick exactly what to install:\n\n```\n  +------------------------------------------------+\n  |   The Agency -- Tool Installer                 |\n  +------------------------------------------------+\n\n  System scan: [*] = detected on this machine\n\n  [x]  1)  [*]  Claude Code     (claude.ai/code)\n  [x]  2)  [*]  Antigravity     (~/.gemini/antigravity)\n  [ ]  3)  [ ]  Gemini CLI      (gemini extension)\n  [ ]  4)  [ ]  OpenCode        (opencode.ai)\n  [x]  5)  [*]  Cursor          (.cursor/rules)\n  [ ]  6)  [ ]  Aider           (CONVENTIONS.md)\n  [ ]  7)  [ ]  Windsurf        (.windsurfrules)\n\n  [1-7] toggle   [a] all   [n] none   [d] detected\n  [Enter] install   [q] quit\n```\n\n**Or install a specific tool directly:**\n```bash\n./scripts/install.sh --tool cursor\n./scripts/install.sh --tool opencode\n./scripts/install.sh --tool antigravity\n```\n\n**Non-interactive (CI/scripts):**\n```bash\n./scripts/install.sh --no-interactive --tool all\n```\n\n---\n\n### Tool-Specific Instructions\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eClaude Code\u003c/strong\u003e\u003c/summary\u003e\n\nAgents are copied directly from the repo into `~/.claude/agents/` -- no conversion needed.\n\n```bash\n./scripts/install.sh --tool claude-code\n```\n\nThen activate in Claude Code:\n```\nUse the Frontend Developer agent to review this component.\n```\n\nSee [integrations/claude-code/README.md](integrations/claude-code/README.md) for details.\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eAntigravity (Gemini)\u003c/strong\u003e\u003c/summary\u003e\n\nEach agent becomes a skill in `~/.gemini/antigravity/skills/agency-\u003cslug\u003e/`.\n\n```bash\n./scripts/install.sh --tool antigravity\n```\n\nActivate in Gemini with Antigravity:\n```\n@agency-frontend-developer review this React component\n```\n\nSee [integrations/antigravity/README.md](integrations/antigravity/README.md) for details.\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eGemini CLI\u003c/strong\u003e\u003c/summary\u003e\n\nInstalls as a Gemini CLI extension with 61 skills + a manifest.\n\n```bash\n./scripts/install.sh --tool gemini-cli\n```\n\nSee [integrations/gemini-cli/README.md](integrations/gemini-cli/README.md) for details.\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eOpenCode\u003c/strong\u003e\u003c/summary\u003e\n\nAgents are placed in `.opencode/agent/` in your project root (project-scoped).\n\n```bash\ncd /your/project\n/path/to/agency-agents/scripts/install.sh --tool opencode\n```\n\nOr install globally:\n```bash\nmkdir -p ~/.config/opencode/agent\ncp integrations/opencode/agent/*.md ~/.config/opencode/agent/\n```\n\nActivate in OpenCode:\n```\nUse the Backend Architect agent to design this API.\n```\n\nSee [integrations/opencode/README.md](integrations/opencode/README.md) for details.\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eCursor\u003c/strong\u003e\u003c/summary\u003e\n\nEach agent becomes a `.mdc` rule file in `.cursor/rules/` of your project.\n\n```bash\ncd /your/project\n/path/to/agency-agents/scripts/install.sh --tool cursor\n```\n\nRules are auto-applied when Cursor detects them in the project. Reference them explicitly:\n```\nUse the @security-engineer rules to review this code.\n```\n\nSee [integrations/cursor/README.md](integrations/cursor/README.md) for details.\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eAider\u003c/strong\u003e\u003c/summary\u003e\n\nAll agents are compiled into a single `CONVENTIONS.md` file that Aider reads automatically.\n\n```bash\ncd /your/project\n/path/to/agency-agents/scripts/install.sh --tool aider\n```\n\nThen reference agents in your Aider session:\n```\nUse the Frontend Developer agent to refactor this component.\n```\n\nSee [integrations/aider/README.md](integrations/aider/README.md) for details.\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eWindsurf\u003c/strong\u003e\u003c/summary\u003e\n\nAll agents are compiled into `.windsurfrules` in your project root.\n\n```bash\ncd /your/project\n/path/to/agency-agents/scripts/install.sh --tool windsurf\n```\n\nReference agents in Windsurf's Cascade:\n```\nUse the Reality Checker agent to verify this is production ready.\n```\n\nSee [integrations/windsurf/README.md](integrations/windsurf/README.md) for details.\n\u003c/details\u003e\n\n---\n\n### Regenerating After Changes\n\nWhen you add new agents or edit existing ones, regenerate all integration files:\n\n```bash\n./scripts/convert.sh        # regenerate all\n./scripts/convert.sh --tool cursor   # regenerate just one tool\n```\n\n---\n\n## 🗺️ Roadmap\n\n- [ ] Interactive agent selector web tool\n- [x] Multi-agent workflow examples -- see [examples/](examples/)\n- [x] Multi-tool integration scripts (Claude Code, Antigravity, Gemini CLI, OpenCode, Cursor, Aider, Windsurf)\n- [ ] Video tutorials on agent design\n- [ ] Community agent marketplace\n- [ ] Agent \"personality quiz\" for project matching\n- [ ] \"Agent of the Week\" showcase series\n\n---\n\n## 🌐 Community Translations \u0026 Localizations\n\nCommunity-maintained translations and regional adaptations. These are independently maintained -- see each repo for coverage and version compatibility.\n\n| Language | Maintainer | Link | Notes |\n|----------|-----------|------|-------|\n| 🇨🇳 简体中文 (zh-CN) | [@jnMetaCode](https://github.com/jnMetaCode) | [agency-agents-zh](https://github.com/jnMetaCode/agency-agents-zh) | 26 translated agents + 4 China-market agents |\n\nWant to add a translation? Open an issue and we'll link it here.\n\n---\n\n## 📜 License\n\nMIT License - Use freely, commercially or personally. Attribution appreciated but not required.\n\n---\n\n## 🙏 Acknowledgments\n\nBorn from a Reddit discussion about AI agent specialization. Thanks to the community for the feedback, requests, and inspiration.\n\nSpecial recognition to the 50+ Redditors who requested this within the first 12 hours - you proved there's demand for real, specialized AI agent systems.\n\n---\n\n## 💬 Community\n\n- **GitHub Discussions**: [Share your success stories](https://github.com/msitarzewski/agency-agents/discussions)\n- **Issues**: [Report bugs or request features](https://github.com/msitarzewski/agency-agents/issues)\n- **Reddit**: Join the conversation on r/ClaudeAI\n- **Twitter/X**: Share with #TheAgency\n\n---\n\n## 🚀 Get Started\n\n1. **Browse** the agents above and find specialists for your needs\n2. **Copy** the agents to `~/.claude/agents/` for Claude Code integration\n3. **Activate** agents by referencing them in your Claude conversations\n4. **Customize** agent personalities and workflows for your specific needs\n5. **Share** your results and contribute back to the community\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n**🎭 The Agency: Your AI Dream Team Awaits 🎭**\n\n[⭐ 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)\n\nMade with ❤️ by the community, for the community\n\n\u003c/div\u003e\n","funding_links":["https://github.com/sponsors/msitarzewski"],"categories":["AI开源项目","Shell","Repos","others","\u003ca name=\"Shell\"\u003e\u003c/a\u003eShell","🤖 Multi-Agent Orchestration \u0026 Collaboration","精选文章"],"sub_categories":["AI Agent"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmsitarzewski%2Fagency-agents","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmsitarzewski%2Fagency-agents","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmsitarzewski%2Fagency-agents/lists"}