Complete guide for using Superpowers with OpenCode.ai.

Add superpowers to the plugin array in your opencode.json (global or project-level):

{
  "plugin": ["superpowers@git+https://github.com/obra/superpowers.git"]
}

Restart OpenCode. The plugin auto-installs via Bun and registers all skills automatically.

Verify by asking: "Tell me about your superpowers"

If you previously installed superpowers using git clone and symlinks, remove the old setup:

# 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

# Remove skills.paths from opencode.json if you added one for superpowers

Then follow the installation steps above.

Use OpenCode's native skill tool to list all available skills:

use skill tool to list skills

use skill tool to load superpowers/brainstorming

Create your own skills in ~/.config/opencode/skills/:

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]

Create project-specific skills in .opencode/skills/ within your project.

Skill Priority: Project skills > Personal skills > Superpowers skills

Superpowers updates automatically when you restart OpenCode. The plugin is re-installed from the git repository on each launch.

To pin a specific version, use a branch or tag:

{
  "plugin": ["superpowers@git+https://github.com/obra/superpowers.git#v5.0.3"]
}

The plugin does two things:

1. Injects assessment context via the experimental.chat.messages.transform hook, adding a lightweight complexity assessment framework to each conversation's first message.
2. Registers the skills directory via the config hook, so OpenCode discovers all superpowers skills without symlinks or manual config.

When you ask a question, the agent assesses task complexity:

• Simple tasks — answered directly, no workflow proposed

• Non-simple tasks — agent proposes a three-tier workflow:

  • Lightweight — minimal steps, quick delivery
  • Recommended — balanced approach
  • Full — comprehensive with TDD, subagents, and code review

You pick a tier or customize the steps. The agent executes your choice.

Skills written for Claude Code are automatically adapted for OpenCode:

• TodoWrite → todowrite
• Task with subagents → OpenCode's @mention system
• Skill tool → OpenCode's native skill tool
• File operations → Native OpenCode tools

1. Check OpenCode 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 OpenCode's skill tool to list available skills
2. Check that the plugin is loading (see above)
3. Each skill needs a SKILL.md file with valid YAML frontmatter

1. Check OpenCode version supports experimental.chat.system.transform hook
2. Restart OpenCode after config changes

• Report issues: https://github.com/obra/superpowers/issues
• Main documentation: https://github.com/obra/superpowers
• OpenCode docs: https://opencode.ai/docs/