Agent Format
Every agent is a markdown file with YAML frontmatter containing:- Description — What the agent specializes in
- Mode — Where it can run (
primary,subagent, orall) - Permission — Required tool access (e.g.,
readonly,edit,full) - Tags — Searchable keywords
- Identity — Role definition, expertise scope, and version context
- Decisions — IF/THEN decision trees for common scenarios
- Examples — Code samples showing best practices
- Quality Gate — Validation criteria before delivering work
Quality Scoring
All agents are evaluated on 8 dimensions (1-5 scale):| Dimension | What’s Measured | Excellent (5/5) |
|---|---|---|
| Frontmatter | Required metadata fields | All 3 fields present |
| Identity | Clear role paragraph | 50-300 words |
| Decisions | Decision trees with IF/THEN | ≥ 5 rules |
| Examples | Code samples | ≥ 3 examples |
| Quality Gate | Validation criteria | ≥ 5 criteria |
| Conciseness | Line count and filler ratio | 70-120 lines, ≤ 3% filler |
| No banned sections | Absence of deprecated sections | 0 legacy sections |
| Version pinning | References to specific versions | Version + year present |
Categories
Agents are organized into 10 categories:Languages
11 agents for TypeScript, Python, Go, Rust, Java, and more
AI & Machine Learning
9 agents for AI systems, ML pipelines, and LLM architecture
Web & Mobile
9 agents for React, Next.js, Vue, Angular, and mobile development
Data & API
6 agents for API design, databases, GraphQL, and Redis
DevOps & Infrastructure
9 agents for Docker, Kubernetes, Terraform, AWS, and CI/CD
DevTools
8 agents for code review, debugging, testing, and refactoring
Security
5 agents for security audits, penetration testing, and compliance
MCP
2 agents for Model Context Protocol server development
Business & Management
6 agents for product management, Scrum, and UX research
Documentation
4 agents for technical writing, API docs, and diagrams
Installation
Install agents using the OpenCode CLI:Agent Modes
- primary — Designed to be your main assistant for a session
- subagent — Specialized expert invoked via
@category/name - all — Works in both modes
FAQ
How do I invoke an agent?
How do I invoke an agent?
Use the format
@category/agent-name in OpenCode:Can I use multiple agents together?
Can I use multiple agents together?
Yes. OpenCode supports multi-agent workflows. For example:
What's the difference between agents and packs?
What's the difference between agents and packs?
- Agents are individual specialists (e.g.,
typescript-pro) - Packs are curated bundles of agents for common workflows (e.g.,
backendincludes postgres-pro, redis-specialist, api-architect, etc.)
How often are agents updated?
How often are agents updated?
Agents are curated manually and updated when new best practices, framework versions, or tooling evolves. The quality scoring system ensures all agents maintain high standards.
Can I create custom agents?
Can I create custom agents?
Yes. Create a markdown file in
.opencode/agents/<category>/<name>.md following the 4-section format. See the source repository for templates.