Skip to main content
Superpowers integrates with OpenCode as a plugin. It auto-installs via Bun and registers all skills automatically — no symlinks or manual configuration required.

​
Installation

Add Superpowers to the plugin array in your opencode.json (global or project-level):
opencode.json
{
  "plugin": ["superpowers@git+https://github.com/obra/superpowers.git"]
}
Restart OpenCode. The plugin installs automatically and all skills become available.

​
Verify installation

Ask OpenCode: 
Tell me about your superpowers
Or trigger a skill naturally: 
Help me plan this feature

​
Using skills

List available skills: 
use skill tool to list skills
Load a specific skill: 
use skill tool to load superpowers/brainstorming

​
Personal and project skills

You can add your own skills alongside Superpowers: Personal skills (available in all sessions): 
mkdir -p ~/.config/opencode/skills/my-skill
Create ~/.config/opencode/skills/my-skill/SKILL.md: 
---
name: my-skill
description: Use when [condition] — [what it does]
---

# My Skill

Your skill content here.
Project skills (only active in the current project): Place skills in .opencode/skills/ within your project directory. Priority order: Project skills → Personal skills → Superpowers skills

​
Updating

Superpowers updates automatically each time you restart OpenCode — it re-installs from the git repository on launch. To pin a specific version:
opencode.json
{
  "plugin": ["superpowers@git+https://github.com/obra/superpowers.git#v5.0.3"]
}

​
How it works

The plugin does two things:
  1. Injects bootstrap context via the experimental.chat.system.transform hook, adding Superpowers awareness to every conversation.
  2. Registers the skills directory via the config hook, so OpenCode discovers all skills automatically.
Tool mapping — skills written for Claude Code adapt automatically:
Claude CodeOpenCode
TodoWritetodowrite
Task (subagents)@mention system
Skill toolnative skill tool
File operationsnative OpenCode tools
If you previously installed Superpowers via git clone and symlinks: 
# Remove old symlinks
rm -f ~/.config/opencode/plugins/superpowers.js
rm -rf ~/.config/opencode/skills/superpowers

# Optionally remove the cloned repo
rm -rf ~/.config/opencode/superpowers
Also remove any skills.paths entry added for Superpowers from your opencode.json. Then follow the installation steps above.

​
Troubleshooting

  1. Check logs: opencode run --print-logs "hello" 2>&1 | grep -i superpowers
  2. Verify the plugin line in your opencode.json is correct
  3. Make sure you’re running a recent version of OpenCode
  1. Use the skill tool to list what’s discovered
  2. Confirm the plugin is loading (see above)
  3. Each skill needs a SKILL.md with valid YAML frontmatter
  1. Check that your OpenCode version supports experimental.chat.system.transform
  2. Restart OpenCode after any config changes

Build docs developers (and LLMs) love

Get started for freeTalk to us