Agent Skills Matrix

This table reflects permission.skill allowlists in .opencode/agents/*.md.

Quick read:

• Most agents follow "*": "deny" + explicit allowlist.
• Language-heavy agents get language/domain skills.
• Docs/content/EM agents stay intentionally narrow.

Agent	Allowed skills
codebase	dotnet, python, typescript, flutter, go, java-spring, node-express, react-next, ux-responsive, ruby-rails, rust, sql-migrations
orchestrator	dotnet, python, typescript, flutter, go, java-spring, node-express, react-next, ux-responsive, ruby-rails, rust, sql-migrations, project-bootstrap, docs-validation, agent-diagnostics, blogger, brutal-critic
planner	dotnet, python, typescript, flutter, go, java-spring, node-express, react-next, ux-responsive, ruby-rails, rust, sql-migrations, project-bootstrap, docs-validation, agent-diagnostics
review	dotnet, python, typescript, flutter, go, java-spring, node-express, react-next, ux-responsive, ruby-rails, rust, sql-migrations, docs-validation, agent-diagnostics
docs	docs-validation, project-bootstrap, agent-diagnostics
em-advisor	project-bootstrap, agent-diagnostics, docs-validation
blogger	blogger, brutal-critic
brutal-critic	brutal-critic, blogger

Notes

• Baseline rule for all agents with skill access: "*": "deny".
• Skills load on demand via the skill tool.
• Keep allowlists narrow by role to reduce context/tool noise.

Skill Trigger Guide (Canonical)

Use this as the canonical trigger reference for when agents should load skills.

Task intent	Skill to load	Typical agents
Language/framework implementation or review	Matching stack skill (dotnet, python, typescript, flutter, go, java-spring, node-express, react-next, ruby-rails, rust, sql-migrations)	codebase, review, planner, orchestrator
Responsive UX across phone/tablet/desktop	ux-responsive	codebase, review, planner, orchestrator
Docs quality checks (lint/link/structure)	docs-validation	docs, review, orchestrator
Agent/package diagnostics and configuration checks	agent-diagnostics	docs, review, planner, orchestrator, em-advisor
Project bootstrap scaffolding	project-bootstrap	docs, planner, orchestrator, em-advisor
Content drafting	blogger	blogger, orchestrator
Content critique and scoring	brutal-critic	brutal-critic, blogger, orchestrator

Trigger policy:

• Load skills only on demand for the active task/phase.
• Start with one relevant skill; add a second only for explicit cross-domain needs.
• If stack/domain is ambiguous, ask a clarifying question before loading.

Skill Scope Policy

• Keep the current core-only skill set.
• Expand only when demand, gap, ownership, and licensing checks are all satisfied.

Command Routing Matrix

OpenCode commands delegate directly to a target agent. Arguments passed in /command-name [argument] are forwarded to the command body via $ARGUMENTS.

Command	Target agent	Argument hint	Purpose
/api-docs	docs	[module, file, or endpoint path]	Generate API reference documentation
/architecture-decision	docs	[decision topic or system name]	Create an ADR
/architecture-review	review	[system, component, or design document]	Review design for quality attributes
/code-review	review	[file, PR, or scope — blank for current changes]	Security, performance, and style review
/content-review	brutal-critic	[content text, file path, or topic]	Score and critique content quality
/create-readme	docs	[project name or path]	Generate or improve a README
/generate-tests	codebase	[file, class, or function name]	Generate targeted tests
/1-on-1-prep	em-advisor	[person] [context]	Prepare for a focused 1-on-1
/execution-loop	orchestrator	[task goal or deliverable]	Bounded verify-and-continue execution loop
/plan-project	orchestrator	[feature, objective, or epic]	Multi-phase implementation plan
/refactor-plan	planner	[target module, file, or scope]	Safe staged refactor strategy
/security-audit	review	[scope, file, component, or 'full project']	Security-focused code and config review
/stop-loop	orchestrator	[optional reason or scope]	Halt loop execution and report current state
/blog-post	blogger	[topic or title]	Draft a blog post