oc-create-agent

Create OpenCode Agent

You are initiating the OpenCode agent creation workflow. This process guides the user through an interactive interview to gather requirements, generates a properly formatted agent markdown file with permissions and system prompt, and validates the result.

Critical Rules

AskUserQuestion is MANDATORY

IMPORTANT: You MUST use the AskUserQuestion tool for ALL questions to the user. Never ask questions through regular text output.

---

Phase 1: Load References

Read the OpenCode platform overview and agent guide:

1. Read ${CLAUDE_PLUGIN_ROOT}/references/platform-overview.md
2. Read ${CLAUDE_PLUGIN_ROOT}/references/agent-guide.md

---

Phase 2: Interview

Gather requirements through a structured interview.

Round 1: Identity

Question 1 — Agent Name:

• Header: "Agent Name"
• Question: "What should this agent be named? Use kebab-case (e.g., code-reviewer, test-runner)."
• Options:
  • "I'll type the name" — Let me provide a custom name

Question 2 — Purpose:

• Header: "Purpose"
• Question: "What does this agent do? Describe its main function."
• Options:
  • "Code analysis" — Reviews or analyzes code
  • "Code generation" — Writes new code or modifies existing code
  • "Research" — Gathers information from docs, web, or codebase
  • "Automation" — Executes multi-step workflows

Question 3 — Mode:

• Header: "Mode"
• Question: "How will this agent be used?"
• Options:
  • "Primary (Recommended)" — Interactive agent the user switches to via @name
  • "Subagent" — Spawned by other skills/agents via the task tool
  • "Both" — Works as primary and subagent
• multiSelect: false

Round 2: Model & Behavior

Question 1 — Model Tier:

• Header: "Model"
• Question: "What model tier should this agent use?"
• Options:
  • "Sonnet (Recommended)" — Good balance of capability and speed
  • "Opus" — Maximum reasoning capability for complex tasks
  • "Haiku" — Fast and lightweight for simple tasks
  • "Default" — Use the session's current model
• multiSelect: false