Skip to content

OpenCode Agent Creator

Create and configure custom agents for the OpenCode CLI. Native OpenCode V2 is the default output; V1 is still supported when you are on V1 or the files beside the new agent are V1-shaped. Covers Markdown and JSON agent definitions, the permission model, V1 → V2 migration, model and variant selection, and subagent patterns.

What it does

OpenCode V1 and V2 use different field names and different permission models for the same concepts, and a single agent must be entirely one format. The skill picks the format version first, then guides the agent through writing and testing the definition, and loads reference material by version and task rather than all at once.

Topics covered:

  • Markdown and JSON agent definitions
  • The permission model in V1 and V2
  • Migrating agents and permissions from V1 to V2
  • Model and variant selection, including cost gating
  • Multi-agent orchestration

Where it applies

Use it when an agent writes or migrates OpenCode agents. OpenCode skills, commands, plugins, MCP servers, and providers are out of scope; use the OpenCode Configuration Manager for those.

Install

# Install globally for all detected agents
npx skills add CowboyLogic/ai-dev --skill agent-creator-opencode -g

# Install for OpenCode only
npx skills add CowboyLogic/ai-dev --skill agent-creator-opencode --agent opencode -g

Verify installation

npx skills ls -g