An agentic skills framework & software development methodology that works.
docs: add opencode installation guide
Jesse Vincenta131267d7cf0
diff --git a/.opencode/INSTALL.md b/.opencode/INSTALL.mdnew file mode 100644index 000000000..54e78fe9f--- /dev/null+++ b/.opencode/INSTALL.md@@ -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