ClaudeCode-to-OpenCode 🚀
This project helps you convert Claude Code skills into OpenCode skills.
It is made for people who already have a Claude Code SKILL.md file and want to use it inside OpenCode without rewriting everything from zero.
The main goal is simple:
Same skill. Same logic. Same content. Only OpenCode compatibility changes. ✅
What does this project do? 🛠️
This converter helps you change Claude Code skill files into OpenCode-friendly skill files.
It can help with:
- Claude Code SKILL.md files
- Skills from .claude/skills/...
- Claude Code path references
- Claude-only config names
- Claude-specific tool names
- Claude-only metadata
- CLAUDE.md references
- Global OpenCode skills
- Project-based OpenCode skills
The converter does not try to rewrite the whole skill.
It only changes the parts that are needed for OpenCode.
Installation 📦
You can install this converter skill in two ways.
You can install it globally, so it works in all OpenCode projects.
Or you can install it only inside one project.
Global installation 🌍
Use this if you want to use the converter in every OpenCode project.
Run this command:
mkdir -p ~/.config/opencode/skills git clone https://github.com/lutraat/ClaudeCode-to-OpenCode.git ~/.config/opencode/skills/skill-converter
After this, the folder should look like this:
~/.config/opencode/skills/skill-converter/ └── SKILL.md
Project installation 📁
Use this if you want to use the converter only inside one project.
Run this command inside your project folder:
mkdir -p .opencode/skills git clone https://github.com/lutraat/ClaudeCode-to-OpenCode.git .opencode/skills/skill-converter
After this, the folder should look like this:
.opencode/skills/skill-converter/ └── SKILL.md
How to use it in OpenCode 💬
Open OpenCode in your project.
Then type:
/skill
After that, select the skill-converter skill.
Now you can give it the Claude Code skill that you want to convert.
For example:
/skill-converter <SKILL.md>
You can also paste the full SKILL.md content directly into OpenCode.
Example prompt ✍️
Use this prompt when you want to convert a Claude Code skill:
Use skill-converter.
Convert the Claude Code SKILL.md below into an OpenCode skill.
Target: Global OpenCode skill
Target folder: ~/.config/opencode/skills//SKILL.md
Rules:
- Do not rewrite the main skill content.
- Do not change the main idea of the skill.
- Do not change the examples unless needed for OpenCode.
- Keep the same behavior.
- Only convert Claude Code-specific paths, tool names, config names, and metadata.
- If there are extra files like references, scripts, or assets, keep them in the correct OpenCode structure.
- If something is missing, do not invent it. Just write a note.
Here is the Claude Code skill:
Recommended workflow 🔄
-
Install this converter skill globally or inside your project.
-
Open OpenCode.
-
Type /skill.
-
Choose skill-converter.
-
Paste the Claude Code SKILL.md file.
-
Tell the agent where you want to install the converted skill.
-
For global usage, use:
~/.config/opencode/skills//SKILL.md
-
For project usage, use:
.opencode/skills//SKILL.md
-
The agent will convert the skill automatically.
-
Add the converted skill to your OpenCode skills folder.
-
Restart OpenCode or check the skill list again.
What should stay the same? ✅
The converter should keep these parts unchanged:
- Main instructions
- Skill logic
- User-facing behavior
- Examples
- Output format
- Domain knowledge
- Reference content
- Scripts
- Assets
The converter should only change what is needed for OpenCode.
What can be changed? 🔧
The converter can change things like:
- .claude/skills/... paths
- ~/.claude/skills/... paths
- Claude Code tool names
- Claude-only metadata
- Claude-only config references
- CLAUDE.md references when needed
- Install instructions
- Folder structure examples
For example:
Claude Code path:
~/.claude/skills/my-skill/SKILL.md
Can become:
~/.config/opencode/skills/my-skill/SKILL.md
Output format 📄
The converter should give an output like this:
Target folder: ~/.config/opencode/skills//
Files:
- SKILL.md
- references/... if available
- scripts/... if available
- assets/... if available
Compatibility changes made:
- Changed Claude Code paths to OpenCode paths.
- Changed global Claude skill folder to global OpenCode skill folder.
- Removed or converted Claude-only metadata.
- Updated tool names when needed.
- Kept the original skill logic unchanged.
Unchanged:
- Main instructions
- Examples
- Output style
- Domain logic
- Reference files
- User-facing behavior
Important notes
This project is not a skill rewriter.
It is a skill converter.
That means it should not make the skill more beautiful, shorter, longer, or smarter unless the user asks for it.
The converter should make the smallest possible changes.
If a target OpenCode skill folder already exists, the agent should ask before overwriting it.
If the original skill has extra folders like references, scripts, or assets, they should be kept.
If a file is missing, the converter should not create fake content.
It should only mention the missing file in a migration note.
Simple idea 🧠
The idea of this project is very simple:
Take a Claude Code skill. Keep the useful content. Remove Claude-only parts. Make it work in OpenCode.
That is all. 🚀
License 📜
This project is released under the Apache-2.0 License.