What problem does it solve?
OpenCode users face friction in creating and configuring agents across projects. This skill provides a structured, reusable blueprint to create and configure OpenCode agents (primary and subagents), assign prompts, tools, permissions, and models, and manage templates across global and project scopes.
Core Features & Use Cases
- Agent creation and configuration: Create Markdown or JSON agent definitions with frontmatter and body instructions.
- Templates and references: Reuse provided assets/templates and references/REFERENCE.md to standardize agent behavior.
- Global vs project scope: Manage global and project-specific agent configurations via SKILL.md frontmatter and resources.
- Permission and tool control: Configure tools, permission policies, and task orchestration to govern agent actions.
- Templates for common roles: Use built-in templates like read-only reviewer, security auditor, docs writer, careful dev, etc.
- Guidance and best practices: Step-by-step instructions for building and testing agents.
Quick Start
- Review the skill's SKILL.md to understand the allowed agent definitions.
- Place new agent definitions in .opencode/agents/NAME.md (or ~/.config/opencode/agents/NAME.md).
- Reuse templates from assets/templates to bootstrap new agents.