Agent Builder

Create in-depth custom agents and corresponding skills for OpenCode with comprehensive research phases.

What It Does

The Agent Builder guides you through creating production-quality custom agents and associated skills for the OpenCode platform. It supports both interactive (14-question Q&A) and non-interactive (fast-path) modes.

Capabilities

• Guide interactive agent creation through structured Q&A
• Execute parallel research subagents
• Generate research-backed agent files with proper frontmatter
• Create associated skills for complex instructions
• Validate agent configuration (90% threshold)
• Support OpenCode-only and Claude-compliant formats
• Recommend tool permissions based on least privilege
• Store research findings in agent research/ subfolder

Modes

Non-Interactive (Fast-Path)

Use when you have complete specifications:

• "Create agent for [domain/technology]"
• "Build a [type] agent that handles [capabilities]"
• Complete specification already defined

Behavior: Skip Q&A, use specification directly.

Interactive (Full Q&A)

Use when exploring requirements:

• "How do I create an agent for..."
• "Help me figure out what I need"
• Vague or exploratory questions

Behavior: Execute full 14-question workflow.

Configuration Defaults

Setting	Default	Options
scope	global	global, project
claude_compliant	0	0 (OpenCode-only), 1 (Claude-compliant)
research_extent	standard	quick, standard, deep, expert
quality_threshold	0.90	0.0-1.0
max_iterations	3	Integer ≥ 1

Usage

Invoke agent builder when you need to:

• Create a new specialized agent
• Define skills for existing agents
• Migrate agents from other systems
• Validate agent configuration quality

Research Phases

1. Phase 1: Agent Requirements (Q1-Q8)
2. Phase 2: Research Configuration (Q9-Q14)
3. Phase 3: Parallel Research Dispatch
4. Phase 4: Research Synthesis
5. Phase 5: Agent Generation
6. Phase 6: Quality Validation
7. Phase 7: Final Output

Output

For each agent built:

• Agent file (agent.md) with proper frontmatter
• Associated skill files (SKILL.md) if needed
• Research folder with findings (research/)
• Update instructions (research/INSTRUCTIONS.md)

License

MIT License - see LICENSE file for details.