skills.rest
scottwater
scottwaterCOMMUNITY
Explore all skills by this author →
Website𝕏@scottwGitHub

converting-claude-subagents

Convert Claude Code subagents to OpenCode agent definitions with validation scripts.

Updated Aug 27, 2026
Search Tags:#automation#migration#subagents#conversion#claude-code#opencode
One-click install
npx skills add https://github.com/scottwater/config --skill converting-claude-subagents
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: converting-claude-subagents
Source: https://github.com/scottwater/config/tree/main/skills/converting-claude-subagents
Command: npx skills add https://github.com/scottwater/config --skill converting-claude-subagents

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill helps you convert Claude Code Subagents to OpenCode Agent format, standardizing migrations and ensuring consistent permissions and structure across teams.

Core Features & Use Cases

  • Maps frontmatter fields from Claude Code to OpenCode, including tools → agent, model and mode
  • Creates OpenCode markdown agents in .opencode/agent/ or ~/.config/opencode/agent/
  • Enforces a subagent workflow with structured frontmatter (temperature, mode, permission)
  • Supports batch conversion for multiple subagents

Quick Start

Run the convert_subagent.sh script on a Claude Code subagent file, then review the generated OpenCode agent, adjust permissions and temperatures as needed, and test by invoking the agent.

Frequently Asked Questions about converting-claude-subagents

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert Claude Code subagents to OpenCode agent format?▼

Converting Claude Code subagents to OpenCode involves running the convert_subagent.sh script on your existing subagent file, which maps frontmatter fields, transforms tool formats from comma-separated strings to YAML booleans, and adds mode, temperature, and permission blocks to create a valid OpenCode agent in .opencode/agent/ or ~/.config/opencode/agent/.

What fields from Claude Code subagents map to OpenCode agents?▼

Claude Code frontmatter fields map to OpenCode as follows: tools become agent declarations with YAML boolean format, model is preserved, mode and temperature are inserted with OpenCode defaults, and permission scaffolding is added automatically during conversion to enforce structured access control.

Can I batch convert multiple Claude Code subagents at once?▼

Yes, the Skill supports batch conversion for multiple subagents. After running the conversion workflow on each file, use the validation scripts to verify that all agents conform to OpenCode structure before deployment across your team.

What permissions and temperature settings should I use after conversion?▼

The conversion process inserts default permission blocks and temperature values into the OpenCode agent. Review and adjust these settings based on your security requirements and model behavior needs, then test the agent to ensure it behaves as expected.

Do I need to modify my subagent files before conversion?▼

No modification is required; the converter extracts frontmatter directly from your existing Claude Code subagent files in .claude/agents or ~/.claude/agents and automatically handles field mapping and format transformation to create compliant OpenCode agents.

Related Skills

Explore More Software Engineering Skills→
dceoydceoy
2

claude-agent-converter

Convert Claude Code subagents into portable Agent Skills format.

Community
Intermediate
pantheon-orgpantheon-org
9

opencode-configure

Configure OpenCode runtime settings in opencode.json and AGENTS.md.

Official
Intermediate
IgorWarzochaIgorWarzocha
3

opencode-agent-generator

Generate OpenCode agent files with YAML frontmatter and permission controls.

Community
Basic
arpa73arpa73
2

skill-creator

Converts docs/ guides into VS Code Agent Skills SKILL.md files.

Community
Basic