What Is Agency Agents? A Collection of Ready-Made Expert Agents: Divisions, Installation and What to Watch Out For
You pick the division you need from Agency Agents and copy it into Claude Code (or a tool like Codex, Gemini CLI, Cursor or Copilot); the tool then works with ready-made expert agent roles for engineering, marketing or specialized fields. msitarzewski/agency-agents is an MIT-licensed collection: the 18 divisions counted in the repository directory hold 282 agent files in total (the largest: engineering 65, specialized 59, marketing 37). Each agent is a role instruction (Markdown), not executable code. To install for Claude Code: `./scripts/install.sh --tool claude-code`; it copies the files as-is into the ~/.claude/agents folder. The script overwrites files with the same name without warning; on Windows you need Git Bash or WSL.
- What it does
- Adds ready-made expert agent roles to your coding tool
- Type
- Agent collection (Markdown instruction files + install scripts)
- Where
- Claude Code (primary), Codex, Gemini CLI, Cursor, Copilot and more
- Contents
- 18 divisions, 282 agent files (directory count)
- Watch out
- Overwrites files with the same name without warning
- Turkish
- Not stated in the official documentation
- Cost
- Free (MIT); no paid plan
What Is Agency Agents For? What's Inside?
In Claude Code, a "subagent" is an instruction file written to work in a specific role: a frontend developer, a security auditor, an SEO specialist. Instead of writing these from scratch, this collection offers ready-made role definitions you can copy and use. Each file is a Markdown text with a YAML header (name, description); it's prompt text, not executable code. Claude Code still does the work, and its permission rules apply.
Divisions and agent counts (counted from the repository directory, October 13, 2026; the catalog says 250+, the README says 230+):
| Division | Agents | What for |
|---|---|---|
| engineering | 65 | Code, architecture, DevOps, databases, payments, performance, accessibility. |
| specialized | 59 | Niche specialists that don't fit the other divisions. |
| marketing | 37 | Content, social media, growth, ASO. |
| game-development | 21 | Unity and similar game engine work. |
| gis | 13 | Maps and geographic data. |
| security | 12 | Security review and implementation. |
| design | 10 | UI/UX, branding, image prompt design. |
| sales, testing | 9 + 9 | Sales discovery and proposals; testing and validation. |
| paid-media, project-management | 7 + 7 | Ad accounts and measurement; project management. |
| academic, product, spatial-computing, support | 6 + 6 + 6 + 6 | Academic; product management; XR; customer support. |
| finance, healthcare, research | 5 + 3 + 1 | Finance; healthcare; research. |
Who it's for: people who use Claude Code in different roles and want a ready-made starting point. Installing everything means hundreds of files; the README also gives examples of installing only the divisions you need.
How to Install Agency Agents
Requirements: git and bash. The install script's header says "Linux, macOS, Windows Git Bash / WSL"; on Windows, PowerShell alone isn't enough. No account, key or payment is needed. The commands are taken verbatim from the README and the script's help.
› git clone https://github.com/msitarzewski/agency-agents.git› cd agency-agents› ./scripts/install.sh --tool claude-code› ./scripts/install.sh --tool claude-code --division engineering› ./scripts/install.sh --list teams› ./scripts/install.sh --tool claude-code --dry-runFor multiple divisions, separate them with commas: --division engineering,security. For specific agents, --agent or --agents-file. You can also copy manually: cp engineering/*.md ~/.claude/agents/.
› ./scripts/install.shFor a direct target, use --tool gemini-cli, codex, copilot, cursor, opencode and so on. For tools that need conversion, ./scripts/convert.sh.
The same maker has a separate desktop app (separate repository: agency-agents-app, version 0.3.2, October 3, 2026). The README gives a Homebrew command for macOS; for Windows, Linux and macOS you download it from the releases page. The agencyagents.app site is the site for this app, not for the agent repository. The Windows installer isn't code-signed yet (it triggers a SmartScreen warning).
!When copying, the script overwrites files with the same name without warning (there's no safeguard on the cp command in the source code). If your own agents have the same names as the ones in the repository, back up the ~/.claude/agents folder before installing, or run --dry-run first. There's no uninstall script.
A version-pinned install line (f99f6aa, October 7, 2026) can still be checked out, but the main branch is 6 days ahead. The repository has no tags or releases; pinning can only be done by commit.
How to Use Agency Agents
After installing, restart Claude Code. Since the agent files land in Claude Code's subagent folder, you can refer to an agent by name; the README doesn't give detailed usage steps.
› ./scripts/install.sh --list agentsFor a symbolic link instead of a copy, there's the --link flag: when you update the repository, the agents update too. It doesn't overwrite your own files; it skips existing ones.
Which Tools Does Agency Agents Work With?
| Claude CodeYes | No conversion; the files are copied to ~/.claude/agents or the project's .claude/agents. |
|---|---|
| Codex, Gemini CLI, GitHub CopilotYes | Installed with conversion (Codex: TOML; Copilot: ~/.copilot/agents and ~/.github/agents). |
| CursorPartly | Project level only (.cursor/rules); no user-wide installation. |
| opencodePartly | Doesn't load more than about 119 agents (README: an upstream bug); install a subset with --division. |
| Qwen Code, ZCodePartly | An open issue (#1081): they can't start because ${identifier} appears in 16 agent files. |
| Aider, Antigravity, Kimi, Windsurf, Hermes and othersYes | Install targets are in the tool list (17 targets in total); the desktop app only writes to 8 tools. |
What Does Agency Agents Access, and What Should You Watch Out For?
The script is 1,801 lines long. It has no curl, wget, npm, pip or sudo calls; it needs no network access apart from git clone. Only for the Hermes target does it edit the Hermes configuration file (it makes a backup). SECURITY.md tells contributors to review the scripts before running them.
~/.claude/agents (Claude Code); for other tools, the folders in the tool list. The path changes with --path and environment variables. convert.sh writes converted files inside the repository under integrations/.
17 of the 282 files have a tools: line (WebFetch, WebSearch, Read, Write, Edit; 7 of them also Bash). The rest don't specify tool restrictions. What an agent does while running is subject to Claude Code's permission system.
Apart from overwriting files with the same name, nothing is deleted; there's no uninstall script either. To remove it, you delete the relevant .md files in ~/.claude/agents yourself.
Agent files count as community content: a hidden directive may have been added to an agent instruction. Among the closed issues are prompt injection via hidden Unicode characters (#478) and --path validation (#819); both are closed. SECURITY.md asks for suspicious agent definitions to be reported. A GitHub Security Advisories scan shows no published advisories; this doesn't mean "safe."
Is Agency Agents Free?
Yes. The repository and the desktop app are MIT-licensed; the README says "use freely for commercial or personal purposes, attribution is appreciated but not required." There's no paid plan or subscription; the README only has an optional GitHub Sponsors link. Claude Code's own subscription is separate.
- MIT: commercial and personal use allowed
- The target tools' (Claude Code, Codex, etc.) own account and plan terms apply
Source: README. This is not legal advice.
Common Problems and Fixes
| What's happening | What to do |
|---|---|
| My existing agent with the same name was overwritten | The installer copies over files with the same name. Back up ~/.claude/agents before installing; see the plan with --dry-run. |
| The script doesn't run on Windows | The script needs bash (Git Bash or WSL). Reported by users Open issue #229: the agents' command examples are Linux/Bash only; #153, a proposal for Windows support, is open. |
| The agent list in opencode is incomplete or broken | opencode doesn't register more than about 119 agents; install a subset with --division. The installer warns when you exceed it. |
| Reported by users Some agents won't open in Qwen Code or ZCode | Open issue #1081 (October 8, 2026): ${identifier} appears inside a code block in 16 agent files. Not resolved. |
| The Windows desktop app triggers a SmartScreen warning | The installer isn't code-signed yet (release note): More info › Run anyway. |
How to Uninstall Agency Agents
- If you installed with the script: delete the relevant .md files from ~/.claude/agents. If you installed everything, that's 282 files; the names are in the form division-name.md or name.md and start with the division folder names.
- If you installed with the desktop app: the app tracks the files it installed; its site describes an "undo" feature, but the step-by-step path isn't detailed on the official page.
There's no separate uninstall command in the official documentation.
Frequently asked questions
What is Agency Agents?
An MIT-licensed collection of ready-made expert agent definitions that you copy into Claude Code and other tools. The repository directory has 282 agent files in 18 divisions. Each agent is a role instruction, not executable code.
Should I install all of them?
No. The README gives examples of installing only the divisions you need. All of them means hundreds of agent files in Claude Code. First look at the divisions with --list teams, and see the plan with --dry-run.
Do the agents do work on their own?
No. Each agent is a role instruction; Claude Code does the work and its permission rules apply. 17 of the 282 files request specific tools (WebFetch, WebSearch, Read, Write, Edit, some also Bash).
Are agencyagents.app and the GitHub repository the same thing?
No. The repository holds the agent content and the scripts. agencyagents.app is the site of the same maker's separate desktop app; the app installs the same agents and, according to the README, needs no account and has no telemetry.
What should I check before running the script?
SECURITY.md asks you to review it before running it. Things to check: which folders it will write to (--dry-run), overwriting files with the same name, whether --link is used, and the tool permissions requested in the agent files.
Related guides
Sources
Not clear in the official sources: The individual content of each of the 282 agent files · a Turkish interface for the desktop app · the detailed content of the "specialized" division · an OSV scan. Each is covered in its section.