|
|
@@ -0,0 +1,115 @@
|
|
|
+# Installing Superpowers for OpenCode
|
|
|
+
|
|
|
+## Prerequisites
|
|
|
+
|
|
|
+- [OpenCode.ai](https://opencode.ai) installed
|
|
|
+- Node.js installed
|
|
|
+- Git installed
|
|
|
+
|
|
|
+## Installation Steps
|
|
|
+
|
|
|
+### 1. Install Superpowers Skills
|
|
|
+
|
|
|
+```bash
|
|
|
+# Clone superpowers skills to OpenCode config directory
|
|
|
+mkdir -p ~/.config/opencode/superpowers
|
|
|
+git clone https://github.com/obra/superpowers.git ~/.config/opencode/superpowers
|
|
|
+```
|
|
|
+
|
|
|
+### 2. Install the Plugin
|
|
|
+
|
|
|
+The plugin is included in the superpowers repository you just cloned.
|
|
|
+
|
|
|
+OpenCode will automatically discover it from:
|
|
|
+- `~/.config/opencode/superpowers/.opencode/plugin/superpowers.js`
|
|
|
+
|
|
|
+Or you can link it to the project-local plugin directory:
|
|
|
+
|
|
|
+```bash
|
|
|
+# In your OpenCode project
|
|
|
+mkdir -p .opencode/plugin
|
|
|
+ln -s ~/.config/opencode/superpowers/.opencode/plugin/superpowers.js .opencode/plugin/superpowers.js
|
|
|
+```
|
|
|
+
|
|
|
+### 3. Restart OpenCode
|
|
|
+
|
|
|
+Restart OpenCode to load the plugin. On the next session, you should see:
|
|
|
+
|
|
|
+```
|
|
|
+You have superpowers.
|
|
|
+```
|
|
|
+
|
|
|
+## Usage
|
|
|
+
|
|
|
+### Finding Skills
|
|
|
+
|
|
|
+Use the `find_skills` tool to list all available skills:
|
|
|
+
|
|
|
+```
|
|
|
+use find_skills tool
|
|
|
+```
|
|
|
+
|
|
|
+### Loading a Skill
|
|
|
+
|
|
|
+Use the `use_skill` tool to load a specific skill:
|
|
|
+
|
|
|
+```
|
|
|
+use use_skill tool with skill_name: "superpowers:brainstorming"
|
|
|
+```
|
|
|
+
|
|
|
+### Personal Skills
|
|
|
+
|
|
|
+Create your own skills in `~/.config/opencode/skills/`:
|
|
|
+
|
|
|
+```bash
|
|
|
+mkdir -p ~/.config/opencode/skills/my-skill
|
|
|
+```
|
|
|
+
|
|
|
+Create `~/.config/opencode/skills/my-skill/SKILL.md`:
|
|
|
+
|
|
|
+```markdown
|
|
|
+---
|
|
|
+name: my-skill
|
|
|
+description: Use when [condition] - [what it does]
|
|
|
+---
|
|
|
+
|
|
|
+# My Skill
|
|
|
+
|
|
|
+[Your skill content here]
|
|
|
+```
|
|
|
+
|
|
|
+Personal skills override superpowers skills with the same name.
|
|
|
+
|
|
|
+## Updating
|
|
|
+
|
|
|
+```bash
|
|
|
+cd ~/.config/opencode/superpowers
|
|
|
+git pull
|
|
|
+```
|
|
|
+
|
|
|
+## Troubleshooting
|
|
|
+
|
|
|
+### Plugin not loading
|
|
|
+
|
|
|
+1. Check plugin file exists: `ls ~/.config/opencode/superpowers/.opencode/plugin/superpowers.js`
|
|
|
+2. Check OpenCode logs for errors
|
|
|
+3. Verify Node.js is installed: `node --version`
|
|
|
+
|
|
|
+### Skills not found
|
|
|
+
|
|
|
+1. Verify skills directory exists: `ls ~/.config/opencode/superpowers/skills`
|
|
|
+2. Use `find_skills` tool to see what's discovered
|
|
|
+3. Check file structure: each skill should have a `SKILL.md` file
|
|
|
+
|
|
|
+### Tool mapping issues
|
|
|
+
|
|
|
+When a skill references a Claude Code tool you don't have:
|
|
|
+- `TodoWrite` → use `update_plan`
|
|
|
+- `Task` with subagents → use `@mention` syntax to invoke OpenCode subagents
|
|
|
+- `Skill` → use `use_skill` tool
|
|
|
+- File operations → use your native tools
|
|
|
+
|
|
|
+## Getting Help
|
|
|
+
|
|
|
+- Report issues: https://github.com/obra/superpowers/issues
|
|
|
+- Documentation: https://github.com/obra/superpowers
|