converting-claude-subagents

Convert Claude Code subagents to OpenCode agents with Markdown or JSON output.

134|8|Updated Mar 13, 2018
One-click install
npx skills add https://github.com/edheltzel/dotfiles --skill converting-claude-subagents-edheltzel
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: converting-claude-subagents
Source: https://github.com/edheltzel/dotfiles/tree/main/ai/.claude/skills/converting-claude-subagents
Command: npx skills add https://github.com/edheltzel/dotfiles --skill converting-claude-subagents-edheltzel

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill helps teams migrate Claude Code subagents to OpenCode agents, covering field mappings, tool format changes, and safe defaults.

Core Features & Use Cases

  • Automated conversion guidance: maps frontmatter fields, converts tool lists to object format, and adds explicit mode/temperature.
  • Risk reduction: preserves prompts and content while updating structure for OpenCode, enabling safer rollouts.
  • Use Case: Port a set of subagents to OpenCode with minimal manual editing.

Quick Start

Use the conversion script to translate a sample Claude Code subagent into an OpenCode agent and verify the generated file.

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 agents?

Converting Claude Code subagents to OpenCode agents involves mapping frontmatter fields, transforming tool lists from comma-separated format to boolean object format, and adding explicit mode, temperature, and permission settings. The conversion script automates this process while preserving your system prompt and validating required fields for OpenCode compatibility.

What happens to my Claude Code subagent's system prompt during conversion?

Your system prompt is fully preserved during conversion to OpenCode. The Skill maintains your original prompt content while updating the surrounding structure—field mappings, tool format, and metadata—to meet OpenCode requirements without altering your agent's core logic or behavior.

Can I convert multiple subagents from .claude/agents at once?

Yes, the conversion script handles subagents located in .claude/agents or ~/.claude/agents directories. You can apply the conversion across multiple subagents used for code review, debugging, test automation, and documentation writing, producing OpenCode-compatible Markdown or JSON files ready for deployment.

What tool format changes occur when converting to OpenCode?

Tools convert from comma-separated lists to a boolean object format, with each tool receiving explicit permission settings. Model aliases are simultaneously mapped to full provider/model strings, ensuring consistent frontmatter and compliance with OpenCode's stricter field validation.

Do I need to manually edit converted files before deploying them?

The conversion produces OpenCode-compatible files with all required fields and validation complete. While the generated Markdown or JSON is ready for immediate deployment, you may review and adjust mode, temperature, or permission settings to match your deployment context.

What subagent use cases does this conversion support?

Conversion supports subagents across code review, debugging, test automation, and documentation writing workflows. The Skill maintains functional compatibility across these use cases while updating the agent structure and tool permissions to OpenCode standards.