Skip to content
Back to search

awesome-codex-subagents

A collection of 130+ specialized Codex subagents covering a wide range of development use cases.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/voltagent--awesome-codex-subagents/badge.svg)](/listings/voltagent--awesome-codex-subagents)

HTML

<a href="/listings/voltagent--awesome-codex-subagents"><img src="/api/listings/voltagent--awesome-codex-subagents/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Use Codex custom agent directories exactly as documented:

- `~/.codex/agents/` for global agents (available in all projects) - `.codex/agents/` for project-specific agents (higher precedence in that repo)

1. Clone this repository. 2. Copy the `.toml` agent files you want into one of the directories above. 3. Restart or refresh your Codex session if needed. 4. Delegate explicitly in prompts (Codex does not auto-spawn custom subagents).

Examples:

mkdir -p ~/.codex/agents
cp categories/01-core-development/backend-developer.toml ~/.codex/agents/
mkdir -p .codex/agents
cp categories/04-quality-security/reviewer.toml .codex/agents/

If you use agent configuration in Codex, keep it in `.codex/config.toml` under `[agents]` as described in the official docs.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 489 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <a href="https://github.com/VoltAgent/voltagent">
  2. <img width="1500" height="500" alt="codex" src="https://github.com/user-attachments/assets/35f56654-e3e7-4023-a7d5-acd5215455de" />
  3. </a>
  4. <br />
  5. <br />
  6. <div align="center">
  7. <strong>The awesome collection of 176+ Codex subagents across 13 categories.</strong>
  8. <br />
  9. <br />
  10. </div>
  11. <div align="center">
  12. [![Awesome](https://awesome.re/badge.svg)](https://awesome.re)
  13. ![Subagent Count](https://img.shields.io/badge/subagents-176-blue?style=classic)
  14. [![Last Update](https://img.shields.io/github/last-commit/VoltAgent/awesome-codex-subagents?label=Last%20update&style=classic)](https://github.com/VoltAgent/awesome-codex-subagents)
  15. [![Discord](https://img.shields.io/discord/1361559153780195478.svg?label=&logo=discord&logoColor=ffffff&color=7389D8&labelColor=6A7EC2)](https://s.voltagent.dev/discord)
  16. [![Official MCP Servers](https://img.shields.io/badge/Official-MCP%20Servers-c2410c?style=classic&logo=github&logoColor=white&labelColor=24292f)](https://github.com/VoltAgent/official-mcp-servers)
  17. </div>
  18. <br />
  19. # Awesome Codex Subagents
  20. This repository serves as the definitive collection of [Codex Subagents](https://developers.openai.com/codex/subagents), specialized AI assistants designed for specific development tasks. Written specifically for Codex and aligned with the official docs.
  21. ## Installation
  22. Use Codex custom agent directories exactly as documented:
  23. - `~/.codex/agents/` for global agents (available in all projects)
  24. - `.codex/agents/` for project-specific agents (higher precedence in that repo)
  25. 1. Clone this repository.
  26. 2. Copy the `.toml` agent files you want into one of the directories above.
  27. 3. Restart or refresh your Codex session if needed.
  28. 4. Delegate explicitly in prompts (Codex does not auto-spawn custom subagents).
  29. Examples:
  30. ```bash
  31. mkdir -p ~/.codex/agents
  32. cp categories/01-core-development/backend-developer.toml ~/.codex/agents/
  33. ```
  34. ```bash
  35. mkdir -p .codex/agents
  36. cp categories/04-quality-security/reviewer.toml .codex/agents/
  37. ```
  38. If you use agent configuration in Codex, keep it in `.codex/config.toml` under `[agents]` as described in the official docs.
  39. ## Sponsors
  40. | | |
  41. | :-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  42. | <a href="https://crawlbase.com/?utm_source=awesome-codex-subagents&utm_medium=sponsorship&utm_campaign=voltagent_2026q3&utm_content=readme_listing"><picture><source media="(prefers-color-scheme: dark)" srcset="https://cdn.voltagent.dev/awesome-repo/crawlbase-new/crawlbase-logo-dark-mode.svg"><img alt="Crawlbase" src="https://cdn.voltagent.dev/awesome-repo/crawlbase-new/crawlbase-logo-light-mode.svg" width="425"></picture></a> | [Crawlbase](https://crawlbase.com/?utm_source=awesome-codex-subagents&utm_medium=sponsorship&utm_campaign=voltagent_2026q3&utm_content=readme_listing) is web data infrastructure trusted by 70,000+ developers. Its Crawling API, MCP server, and integrations give AI agents live access to any webpage — with JavaScript rendering, proxy rotation, and anti-bot protection. |
  43. | <a href="https://serpapi.com/awesome-codex-subagents"><img alt="SerpApi" src="https://cdn.voltagent.dev/awesome-repo/serpapi/serpapi-logo.png" width="425"></a> | [SerpApi](https://serpapi.com/awesome-codex-subagents) is a Web Search API for your AI apps. Available in Markdown and JSON for any integration. |
  44. <div align="center">
  45. <table>
  46. <tr>
  47. <td align="center" width="100%">
  48. <h4>👉 You can feature your product here and reach developers using AI coding agents like Claude Code, Codex, Gemini, and more.</h4>
  49. <a href="https://sponsors.voltagent.dev/#awesome-codex-subagents"><img src="https://img.shields.io/badge/📩_Become_a_Sponsor-Contact_Us-blue?style=for-the-badge&logoColor=white" alt="Become a Sponsor" /></a>
  50. </td>
  51. </tr>
  52. </table>
  53. </div>
  54. ### Subagent Storage Locations
  55. | Type | Path | Availability | Precedence |
  56. |------|------|--------------|------------|
  57. | Project Subagents | `.codex/agents/` | Current project only | Higher |
  58. | Global Subagents | `~/.codex/agents/` | All projects | Lower |
  59. Note: When naming conflicts occur, project-specific subagents override global ones.
  60. ## Subagent Structure
  61. Each subagent uses a Codex-native `.toml` format:
  62. ```toml
  63. name = "subagent-name"
  64. description = "When this agent should be invoked"
  65. model = "gpt-6-luna"
  66. model_reasoning_effort = "medium"
  67. sandbox_mode = "read-only"
  68. [instructions]
  69. text = """
  70. You are a [role description and expertise areas]...
  71. [Agent-specific checklists, patterns, and guidelines]...
  72. """
  73. ```
  74. ### Smart Model Routing
  75. Each subagent includes a `model` field that automatically routes it to the right model -- balancing quality and cost:
  76. | Model | When It's Used | Examples |
  77. |-------|----------------|----------|
  78. | `gpt-6.1-sol` | Complex coding, implementation, architecture, security, diagnostics, and professional analysis | `security-auditor`, `docker-expert`, `scientific-literature-researcher` |
  79. | `gpt-6-luna` | Bounded search, extraction, routing, drafting, and lightweight synthesis | `search-specialist`, `docs-researcher`, `agent-installer` |
  80. ### Sandbox Mode Philosophy
  81. Each subagent's `sandbox_mode` field controls filesystem access:
  82. - **Read-only agents** (reviewers, auditors): `sandbox_mode = "read-only"` - analyze without modifying
  83. - **Workspace-write agents** (developers, engineers): `sandbox_mode = "workspace-write"` - create and modify files
  84. ## Categories
  85. ### [01. Core Development](categories/01-core-development/)
  86. Essential development subagents for everyday coding tasks.
  87. - [**api-designer**](categories/01-core-development/api-designer.toml) - REST and GraphQL API architect
  88. - [**backend-developer**](categories/01-core-development/backend-developer.toml) - Server-side expert for scalable APIs
  89. - [**code-mapper**](categories/01-core-development/code-mapper.toml) - Code path mapping and ownership boundary analysis
  90. - [**design-bridge**](categories/01-core-development/design-bridge.toml) - Translates DESIGN.md specs into implementation-ready UI instructions
  91. - [**electron-pro**](categories/01-core-development/electron-pro.toml) - Desktop application expert
  92. - [**frontend-developer**](categories/01-core-development/frontend-developer.toml) - UI/UX specialist for React, Vue, and Angular
  93. - [**fullstack-developer**](categories/01-core-development/fullstack-developer.toml) - End-to-end feature development
  94. - [**graphql-architect**](categories/01-core-development/graphql-architect.toml) - GraphQL schema and federation expert
  95. - [**microservices-architect**](categories/01-core-development/microservices-architect.toml) - Distributed systems designer
  96. - [**mobile-developer**](categories/01-core-development/mobile-developer.toml) - Cross-platform mobile specialist
  97. - [**ui-designer**](categories/01-core-development/ui-designer.toml) - Visual design and interaction specialist
  98. - [**ui-fixer**](categories/01-core-development/ui-fixer.toml) - Smallest safe patch for reproduced UI issues
  99. - [**websocket-engineer**](categories/01-core-development/websocket-engineer.toml) - Real-time communication specialist
  100. ### [02. Language Specialists](categories/02-language-specialists/)
  101. Language-specific experts with deep framework knowledge.
  102. - [**angular-architect**](categories/02-language-specialists/angular-architect.toml) - Angular 15+ enterprise patterns expert
  103. - [**cpp-pro**](categories/02-language-specialists/cpp-pro.toml) - C++ performance expert
  104. - [**csharp-developer**](categories/02-language-specialists/csharp-developer.toml) - .NET ecosystem specialist
  105. - [**django-developer**](categories/02-language-specialists/django-developer.toml) - Django 4+ web development expert
  106. - [**dotnet-core-expert**](categories/02-language-specialists/dotnet-core-expert.toml) - .NET 8 cross-platform specialist
  107. - [**dotnet-framework-4.8-expert**](categories/02-language-specialists/dotnet-framework-4.8-expert.toml) - .NET Framework legacy enterprise specialist
  108. - [**elixir-expert**](categories/02-language-specialists/elixir-expert.toml) - Elixir and OTP fault-tolerant systems expert
  109. - [**erlang-expert**](categories/02-language-specialists/erlang-expert.toml) - Erlang/OTP and rebar3 engineering expert
  110. - [**expo-react-native-expert**](categories/02-language-specialists/expo-react-native-expert.toml) - Expo and React Native mobile development expert
  111. - [**fastapi-developer**](categories/02-language-specialists/fastapi-developer.toml) - Modern async Python API framework expert
  112. - [**flutter-expert**](categories/02-language-specialists/flutter-expert.toml) - Flutter 3+ cross-platform mobile expert
  113. - [**golang-pro**](categories/02-language-specialists/golang-pro.toml) - Go concurrency specialist
  114. - [**java-architect**](categories/02-language-specialists/java-architect.toml) - Enterprise Java expert
  115. - [**javascript-pro**](categories/02-language-specialists/javascript-pro.toml) - JavaScript development expert
  116. - [**kotlin-specialist**](categories/02-language-specialists/kotlin-specialist.toml) - Modern JVM language expert
  117. - [**laravel-specialist**](categories/02-language-specialists/laravel-specialist.toml) - Laravel 10+ PHP framework expert
  118. - [**symfony-specialist**](categories/02-language-specialists/symfony-specialist.toml) - Symfony application and Doctrine specialist
  119. - [**nextjs-developer**](categories/02-language-specialists/nextjs-developer.toml) - Next.js 14+ full-stack specialist
  120. - [**node-specialist**](categories/02-language-specialists/node-specialist.toml) - Node.js backend specialist
  121. - [**php-pro**](categories/02-language-specialists/php-pro.toml) - PHP web development expert
  122. - [**powershell-5.1-expert**](categories/02-language-specialists/powershell-5.1-expert.toml) - Windows PowerShell 5.1 and full .NET Framework automation specialist
  123. - [**powershell-7-expert**](categories/02-language-specialists/powershell-7-expert.toml) - Cross-platform PowerShell 7+ automation and modern .NET specialist
  124. - [**python-pro**](categories/02-language-specialists/python-pro.toml) - Python ecosystem master
  125. - [**rails-expert**](categories/02-language-specialists/rails-expert.toml) - Rails 8.1 rapid development expert
  126. - [**react-specialist**](categories/02-language-specialists/react-specialist.toml) - React 18+ modern patterns expert
  127. - [**rust-engineer**](categories/02-language-specialists/rust-engineer.toml) - Systems programming expert
  128. - [**spring-boot-engineer**](categories/02-language-specialists/spring-boot-engineer.toml) - Spring Boot 3+ microservices expert
  129. - [**sql-pro**](categories/02-language-specialists/sql-pro.toml) - Database query expert
  130. - [**swift-expert**](categories/02-language-specialists/swift-expert.toml) - iOS and macOS specialist
  131. - [**typescript-pro**](categories/02-language-specialists/typescript-pro.toml) - TypeScript specialist
  132. - [**vue-expert**](categories/02-language-specialists/vue-expert.toml) - Vue 3 Composition API expert
  133. ### [03. Infrastructure](categories/03-infrastructure/)
  134. DevOps, cloud, and deployment specialists.
  135. - [**azure-infra-engineer**](categories/03-infrastructure/azure-infra-engineer.toml) - Azure infrastructure and Az PowerShell automation expert
  136. - [**cloud-architect**](categories/03-infrastructure/cloud-architect.toml) - AWS/GCP/Azure specialist
  137. - [**database-administrator**](categories/03-infrastructure/database-administrator.toml) - Database management expert
  138. - [**deployment-engineer**](categories/03-infrastructure/deployment-engineer.toml) - Deployment automation specialist
  139. - [**devops-engineer**](categories/03-infrastructure/devops-engineer.toml) - CI/CD and automation expert
  140. - [**devops-incident-responder**](categories/03-infrastructure/devops-incident-responder.toml) - DevOps incident management
  141. - [**docker-expert**](categories/03-infrastructure/docker-expert.toml) - Docker containerization and optimization expert
  142. - [**incident-responder**](categories/03-infrastructure/incident-responder.toml) - System incident response expert
  143. - [**kubernetes-specialist**](categories/03-infrastructure/kubernetes-specialist.toml) - Container orchestration master
  144. - [**network-engineer**](categories/03-infrastructure/network-engineer.toml) - Network infrastructure specialist
  145. - [**platform-engineer**](categories/03-infrastructure/platform-engineer.toml) - Platform architecture expert
  146. - [**security-engineer**](categories/03-infrastructure/security-engineer.toml) - Infrastructure security specialist
  147. - [**sre-engineer**](categories/03-infrastructure/sre-engineer.toml) - Site reliability engineering expert
  148. - [**terraform-engineer**](categories/03-infrastructure/terraform-engineer.toml) - Infrastructure as Code expert
  149. - [**terragrunt-expert**](categories/03-infrastructure/terragrunt-expert.toml) - Terragrunt orchestration and DRY IaC specialist
  150. - [**windows-infra-admin**](categories/03-infrastructure/windows-infra-admin.toml) - Active Directory, DNS, DHCP, and GPO automation specialist
  151. <details>
  152. <summary><b>04. Quality & Security</b> — Testing, security, and code quality experts (21 agents)</summary>
  153. ### [04. Quality & Security](categories/04-quality-security/)
  154. - [**accessibility-tester**](categories/04-quality-security/accessibility-tester.toml) - A11y compliance expert
  155. - [**ad-security-reviewer**](categories/04-quality-security/ad-security-reviewer.toml) - Active Directory security and GPO audit specialist
  156. - [**anti-ui-slop-reviewer**](categories/04-quality-security/anti-ui-slop-reviewer.toml) - Product-specific UI finish-gate reviewer
  157. - [**ai-writing-auditor**](categories/04-quality-security/ai-writing-auditor.toml) - AI writing pattern auditor and rewriter
  158. - [**architect-reviewer**](categories/04-quality-security/architect-reviewer.toml) - Architecture review specialist
  159. - [**browser-debugger**](categories/04-quality-security/browser-debugger.toml) - Browser-based reproduction and client-side debugging
  160. - [**chaos-engineer**](categories/04-quality-security/chaos-engineer.toml) - System resilience testing expert
  161. - [**code-reviewer**](categories/04-quality-security/code-reviewer.toml) - Code quality guardian
  162. - [**compliance-auditor**](categories/04-quality-security/compliance-auditor.toml) - Regulatory compliance expert
  163. - [**debugger**](categories/04-quality-security/debugger.toml) - Advanced debugging specialist
  164. - [**error-detective**](categories/04-quality-security/error-detective.toml) - Error analysis and resolution expert
  165. - [**gdpr-ccpa-compliance**](categories/04-quality-security/gdpr-ccpa-compliance.toml) - GDPR and CCPA privacy compliance specialist
  166. - [**penetration-tester**](categories/04-quality-security/penetration-tester.toml) - Ethical hacking specialist
  167. - [**performance-engineer**](categories/04-quality-security/performance-engineer.toml) - Performance optimization expert
  168. - [**ponder-reviewer**](categories/04-quality-security/ponder-reviewer.toml) - Coverage-gated multi-pass deliberation reviewer
  169. - [**powershell-security-hardening**](categories/04-quality-security/powershell-security-hardening.toml) - PowerShell security hardening and compliance specialist
  170. - [**qa-expert**](categories/04-quality-security/qa-expert.toml) - Test automation specialist
  171. - [**reviewer**](categories/04-quality-security/reviewer.toml) - PR-style review for correctness, security, and regressions
  172. - [**security-auditor**](categories/04-quality-security/security-auditor.toml) - Security vulnerability expert
  173. - [**test-automator**](categories/04-quality-security/test-automator.toml) - Test automation framework expert
  174. - [**ui-ux-tester**](categories/04-quality-security/ui-ux-tester.toml) - Exhaustive UI/UX functional testing specialist
  175. </details>
  176. <details>
  177. <summary><b>05. Data & AI</b> — Data engineering, ML, and AI specialists (14 agents)</summary>
  178. ### [05. Data & AI](categories/05-data-ai/)
  179. - [**ai-engineer**](categories/05-data-ai/ai-engineer.toml) - AI system design and deployment expert
  180. - [**azure-databricks-platform-architect**](categories/05-data-ai/azure-databricks-platform-architect.toml) - Azure Databricks platform and lakehouse architect
  181. - [**data-analyst**](categories/05-data-ai/data-analyst.toml) - Data insights and visualization specialist
  182. - [**data-engineer**](categories/05-data-ai/data-engineer.toml) - Data pipeline architect
  183. - [**data-scientist**](categories/05-data-ai/data-scientist.toml) - Analytics and insights expert
  184. - [**database-optimizer**](categories/05-data-ai/database-optimizer.toml) - Database performance specialist
  185. - [**llm-architect**](categories/05-data-ai/llm-architect.toml) - Large language model architect
  186. - [**machine-learning-engineer**](categories/05-data-ai/machine-learning-engineer.toml) - Machine learning systems expert
  187. - [**ml-engineer**](categories/05-data-ai/ml-engineer.toml) - Machine learning specialist
  188. - [**mlops-engineer**](categories/05-data-ai/mlops-engineer.toml) - MLOps and model deployment expert
  189. - [**nlp-engineer**](categories/05-data-ai/nlp-engineer.toml) - Natural language processing expert
  190. - [**postgres-pro**](categories/05-data-ai/postgres-pro.toml) - PostgreSQL database expert
  191. - [**prompt-engineer**](categories/05-data-ai/prompt-engineer.toml) - Prompt optimization specialist
  192. - [**reinforcement-learning-engineer**](categories/05-data-ai/reinforcement-learning-engineer.toml) - Reinforcement learning and decision systems expert
  193. </details>
  194. <details>
  195. <summary><b>06. Developer Experience</b> — Tooling and developer productivity experts (14 agents)</summary>
  196. ### [06. Developer Experience](categories/06-developer-experience/)
  197. - [**build-engineer**](categories/06-developer-experience/build-engineer.toml) - Build system specialist
  198. - [**cli-developer**](categories/06-developer-experience/cli-developer.toml) - Command-line tool creator
  199. - [**dependency-manager**](categories/06-developer-experience/dependency-manager.toml) - Package and dependency specialist
  200. - [**documentation-engineer**](categories/06-developer-experience/documentation-engineer.toml) - Technical documentation expert
  201. - [**dx-optimizer**](categories/06-developer-experience/dx-optimizer.toml) - Developer experience optimization specialist
  202. - [**git-workflow-manager**](categories/06-developer-experience/git-workflow-manager.toml) - Git workflow and branching expert
  203. - [**legacy-modernizer**](categories/06-developer-experience/legacy-modernizer.toml) - Legacy code modernization specialist
  204. - [**mcp-developer**](categories/06-developer-experience/mcp-developer.toml) - Model Context Protocol specialist
  205. - [**powershell-module-architect**](categories/06-developer-experience/powershell-module-architect.toml) - PowerShell module and profile architecture specialist
  206. - [**powershell-ui-architect**](categories/06-developer-experience/powershell-ui-architect.toml) - PowerShell UI/UX specialist for WinForms, WPF, Metro frameworks, and TUIs
  207. - [**readme-generator**](categories/06-developer-experience/readme-generator.toml) - Maintainer-ready README generator with zero hallucination
  208. - [**refactoring-specialist**](categories/06-developer-experience/refactoring-specialist.toml) - Code refactoring expert
  209. - [**slack-expert**](categories/06-developer-experience/slack-expert.toml) - Slack platform and @slack/bolt specialist
  210. - [**tooling-engineer**](categories/06-developer-experience/tooling-engineer.toml) - Developer tooling specialist
  211. </details>
  212. <details>
  213. <summary><b>07. Specialized Domains</b> — Domain-specific technology experts (14 agents)</summary>
  214. ### [07. Specialized Domains](categories/07-specialized-domains/)
  215. - [**api-documenter**](categories/07-specialized-domains/api-documenter.toml) - API documentation specialist
  216. - [**blockchain-developer**](categories/07-specialized-domains/blockchain-developer.toml) - Web3 and crypto specialist
  217. - [**embedded-systems**](categories/07-specialized-domains/embedded-systems.toml) - Embedded and real-time systems expert
  218. - [**fintech-engineer**](categories/07-specialized-domains/fintech-engineer.toml) - Financial technology specialist
  219. - [**game-developer**](categories/07-specialized-domains/game-developer.toml) - Game development expert
  220. - [**healthcare-admin**](categories/07-specialized-domains/healthcare-admin.toml) - Healthcare administration, revenue cycle, and compliance specialist
  221. - [**hipaa-compliance**](categories/07-specialized-domains/hipaa-compliance.toml) - HIPAA compliance specialist for healthcare SaaS vendors
  222. - [**iot-engineer**](categories/07-specialized-domains/iot-engineer.toml) - IoT systems developer
  223. - [**m365-admin**](categories/07-specialized-domains/m365-admin.toml) - Microsoft 365, Exchange Online, Teams, and SharePoint administration specialist
  224. - [**mobile-app-developer**](categories/07-specialized-domains/mobile-app-developer.toml) - Mobile application specialist
  225. - [**payment-integration**](categories/07-specialized-domains/payment-integration.toml) - Payment systems expert
  226. - [**quant-analyst**](categories/07-specialized-domains/quant-analyst.toml) - Quantitative analysis specialist
  227. - [**risk-manager**](categories/07-specialized-domains/risk-manager.toml) - Risk assessment and management expert
  228. - [**seo-specialist**](categories/07-specialized-domains/seo-specialist.toml) - Search engine optimization expert
  229. </details>
  230. <details>
  231. <summary><b>08. Business & Product</b> — Product management and business analysis (17 agents)</summary>
  232. ### [08. Business & Product](categories/08-business-product/)
  233. - [**assumption-mapping**](categories/08-business-product/assumption-mapping.toml) - Product assumption risk and validation specialist
  234. - [**backlog-grooming**](categories/08-business-product/backlog-grooming.toml) - Agile backlog refinement specialist
  235. - [**business-analyst**](categories/08-business-product/business-analyst.toml) - Requirements specialist
  236. - [**content-marketer**](categories/08-business-product/content-marketer.toml) - Content marketing specialist
  237. - [**content-quality-editor**](categories/08-business-product/content-quality-editor.toml) - AI content quality and humanization specialist
  238. - [**customer-success-manager**](categories/08-business-product/customer-success-manager.toml) - Customer success expert
  239. - [**growth-loops**](categories/08-business-product/growth-loops.toml) - Growth loop and PLG mechanics specialist
  240. - [**legal-advisor**](categories/08-business-product/legal-advisor.toml) - Legal and compliance specialist
  241. - [**license-engineer**](categories/08-business-product/license-engineer.toml) - Software licensing and compliance systems specialist
  242. - [**product-manager**](categories/08-business-product/product-manager.toml) - Product strategy expert
  243. - [**project-manager**](categories/08-business-product/project-manager.toml) - Project management specialist
  244. - [**resume-refiner**](categories/08-business-product/resume-refiner.toml) - Resume, CV, and LinkedIn profile optimization specialist
  245. - [**sales-engineer**](categories/08-business-product/sales-engineer.toml) - Technical sales expert
  246. - [**scrum-master**](categories/08-business-product/scrum-master.toml) - Agile methodology expert
  247. - [**technical-writer**](categories/08-business-product/technical-writer.toml) - Technical documentation specialist
  248. - [**ux-researcher**](categories/08-business-product/ux-researcher.toml) - User research expert
  249. - [**wordpress-master**](categories/08-business-product/wordpress-master.toml) - WordPress development and optimization expert
  250. </details>
  251. <details>
  252. <summary><b>09. Meta & Orchestration</b> — Agent coordination and meta-programming (12 agents)</summary>
  253. ### [09. Meta & Orchestration](categories/09-meta-orchestration/)
  254. - [**agent-installer**](categories/09-meta-orchestration/agent-installer.toml) - Browse and install agents from this repository via GitHub
  255. - [**agent-organizer**](categories/09-meta-orchestration/agent-organizer.toml) - Multi-agent coordinator
  256. - [**codebase-orchestrator**](categories/09-meta-orchestration/codebase-orchestrator.toml) - Repo-wide refactor governance with approval gates
  257. - [**context-manager**](categories/09-meta-orchestration/context-manager.toml) - Context optimization expert
  258. - [**error-coordinator**](categories/09-meta-orchestration/error-coordinator.toml) - Error handling and recovery specialist
  259. - [**it-ops-orchestrator**](categories/09-meta-orchestration/it-ops-orchestrator.toml) - IT operations workflow orchestration specialist
  260. - [**knowledge-synthesizer**](categories/09-meta-orchestration/knowledge-synthesizer.toml) - Knowledge aggregation expert
  261. - [**multi-agent-coordinator**](categories/09-meta-orchestration/multi-agent-coordinator.toml) - Advanced multi-agent orchestration
  262. - [**performance-monitor**](categories/09-meta-orchestration/performance-monitor.toml) - Agent performance optimization
  263. - [**pied-piper**](https://github.com/sathish316/pied-piper/) - Orchestrate Team of AI Subagents for repetitive SDLC workflows
  264. - [**task-distributor**](categories/09-meta-orchestration/task-distributor.toml) - Task allocation specialist
  265. - [**workflow-orchestrator**](categories/09-meta-orchestration/workflow-orchestrator.toml) - Complex workflow automation
  266. </details>
  267. <details>
  268. <summary><b>10. Research & Analysis</b> — Research, search, and analysis specialists (12 agents)</summary>
  269. ### [10. Research & Analysis](categories/10-research-analysis/)
  270. - [**ab-test-analysis**](categories/10-research-analysis/ab-test-analysis.toml) - A/B test interpretation and ship/no-ship decisions
  271. - [**cohort-analysis**](categories/10-research-analysis/cohort-analysis.toml) - Retention, cohort behavior, and activation-metric analysis
  272. - [**competitive-analyst**](categories/10-research-analysis/competitive-analyst.toml) - Competitive intelligence specialist
  273. - [**data-researcher**](categories/10-research-analysis/data-researcher.toml) - Data discovery and analysis expert
  274. - [**docs-researcher**](categories/10-research-analysis/docs-researcher.toml) - Documentation-backed API and framework verification
  275. - [**first-principles-thinking**](categories/10-research-analysis/first-principles-thinking.toml) - Assumption-challenging, first-principles problem solving
  276. - [**market-researcher**](categories/10-research-analysis/market-researcher.toml) - Market analysis and consumer insights
  277. - [**project-idea-validator**](categories/10-research-analysis/project-idea-validator.toml) - Brutal idea pressure-tester and go/no-go strategist
  278. - [**research-analyst**](categories/10-research-analysis/research-analyst.toml) - Comprehensive research specialist
  279. - [**scientific-literature-researcher**](categories/10-research-analysis/scientific-literature-researcher.toml) - Evidence-grounded research from published scientific studies
  280. - [**search-specialist**](categories/10-research-analysis/search-specialist.toml) - Advanced information retrieval expert
  281. - [**trend-analyst**](categories/10-research-analysis/trend-analyst.toml) - Emerging trends and forecasting expert
  282. </details>
  283. <details>
  284. <summary><b>11. AI Governance & Safety</b> - Governance, guardrails, and trustworthy AI specialists (4 agents)</summary>
  285. ### [11. AI Governance & Safety](categories/11-ai-governance-safety/)
  286. - [**ai-governance-auditor**](categories/11-ai-governance-safety/ai-governance-auditor.toml) - AI governance controls and deployment readiness reviewer
  287. - [**model-risk-manager**](categories/11-ai-governance-safety/model-risk-manager.toml) - Model failure-mode prioritization and mitigation specialist
  288. - [**policy-guardrail-designer**](categories/11-ai-governance-safety/policy-guardrail-designer.toml) - Prompt, tool, and workflow guardrail designer
  289. - [**responsible-ai-reviewer**](categories/11-ai-governance-safety/responsible-ai-reviewer.toml) - Fairness, misuse, transparency, and oversight reviewer
  290. </details>
  291. <details>
  292. <summary><b>12. Platform Engineering & IDP</b> - Internal developer platform and golden-path specialists (4 agents)</summary>
  293. ### [12. Platform Engineering & IDP](categories/12-platform-engineering-idp/)
  294. - [**backstage-specialist**](categories/12-platform-engineering-idp/backstage-specialist.toml) - Backstage catalog, templates, and portal specialist
  295. - [**golden-path-designer**](categories/12-platform-engineering-idp/golden-path-designer.toml) - Opinionated self-service workflow designer
  296. - [**idp-architect**](categories/12-platform-engineering-idp/idp-architect.toml) - Internal developer platform architecture specialist
  297. - [**platform-product-manager**](categories/12-platform-engineering-idp/platform-product-manager.toml) - Platform roadmap, adoption, and success-metrics specialist
  298. </details>
  299. <details>
  300. <summary><b>13. LLMOps, Evals & Observability</b> - Production AI quality and runtime visibility specialists (4 agents)</summary>
  301. ### [13. LLMOps, Evals & Observability](categories/13-llmops-evals-observability/)
  302. - [**ai-observability-engineer**](categories/13-llmops-evals-observability/ai-observability-engineer.toml) - AI-native traces, metrics, and logging specialist
  303. - [**eval-engineer**](categories/13-llmops-evals-observability/eval-engineer.toml) - Prompt, tool, and workflow evaluation specialist
  304. - [**hallucination-investigator**](categories/13-llmops-evals-observability/hallucination-investigator.toml) - Factuality and context-breakdown root-cause investigator
  305. - [**prompt-regression-tester**](categories/13-llmops-evals-observability/prompt-regression-tester.toml) - Regression-suite designer for AI behavior changes
  306. </details>
  307. ## Understanding Subagents
  308. Subagents are specialized AI assistants that enhance Codex's capabilities by providing task-specific expertise. They act as dedicated helpers that Codex can call upon when encountering particular types of work.
  309. ### What Makes Subagents Special?
  310. **Independent Context Windows**
  311. Every subagent operates within its own isolated context space, preventing cross-contamination between different tasks and maintaining clarity in the primary conversation thread.
  312. **Domain-Specific Intelligence**
  313. Subagents come equipped with carefully crafted instructions tailored to their area of expertise, resulting in superior performance on specialized tasks.
  314. **Shared Across Projects**
  315. After creating a subagent, you can utilize it throughout various projects and distribute it among team members to ensure consistent development practices.
  316. **Explicit Delegation**
  317. Codex does not spawn subagents automatically. Use explicit delegation prompts to specify which agents to spawn, how to divide the work, and what shape the result should take.
  318. ### Core Advantages
  319. - **Memory Efficiency**: Isolated contexts prevent the main conversation from becoming cluttered with task-specific details
  320. - **Enhanced Accuracy**: Specialized prompts and configurations lead to better results in specific domains
  321. - **Workflow Consistency**: Team-wide subagent sharing ensures uniform approaches to common tasks
  322. - **Codex-Native**: Uses `.toml` agent files aligned with official Codex subagent docs
  323. ### Example Workflows
  324. **PR review workflow:**
  325. ```text
  326. Review this branch with parallel subagents. Have reviewer look for correctness, security, and missing tests. Have docs_researcher verify the framework APIs this patch depends on. Wait for both and summarize the findings with file references.
  327. ```
  328. **Bug investigation workflow:**
  329. ```text
  330. Investigate the broken settings flow. Have code_mapper trace the owning code paths, browser_debugger reproduce the bug in the browser, and frontend_developer propose the smallest fix after the failure is understood. Wait for the read-heavy agents first, then continue.
  331. ```
  332. **Repo exploration and planning workflow:**
  333. ```text
  334. Use search_specialist to locate the code related to payment retries, knowledge_synthesizer to summarize the current design, and refactoring_specialist to propose a minimal refactor plan. Return a concrete action list.
  335. ```
  336. ## AI Design + Build Ecosystem Tools
  337. <br/>
  338. You ship products with AI, but every launch still dies quietly because nobody posts about it. [EveryFeed](https://everyfeed.ai/) plugs your AI assistant into a social workspace that drafts, schedules, and publishes across 35+ channels — no agency, no marketing hire.
  339. <a href="https://everyfeed.ai/">
  340. <img src="https://cdn.voltagent.dev/awesome-repo/everyfeed-social.png" alt="everyfeed" /><br/>
  341. </a>
  342. <br/>
  343. <a href="https://launchkit.getdesign.md/">
  344. <img src="https://cdn.voltagent.dev/awesome-repo/website-starter-kit-banner-dark-0315e5f9c1.png" alt="launchkit" /><br/>
  345. </a>
  346. <br/>
  347. <a href="https://mobile-starterkit.getdesign.md/">
  348. <img src="https://cdn.voltagent.dev/awesome-repo/mobile-starter-kit-banner-light-450ba0a9b0.png" alt="mobilekit" /><br/>
  349. </a>
  350. <br/>
  351. ## Contributing
  352. We welcome contributions! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
  353. - Submit new subagents via PR
  354. - Improve existing definitions
  355. - Report issues and bugs
  356. ## License
  357. MIT License - see [LICENSE](LICENSE)
  358. This repository is a curated collection of subagent definitions contributed by both the maintainers and the community. All subagents are provided "as is" without warranty. We do not audit or guarantee the security or correctness of any subagent. Review before use, the maintainers accept no liability for any issues arising from their use.
  359. If you find an issue with a listed subagent or want your contribution removed, please open an issue in this repository and we'll address it promptly.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.