docs: add skill manager documentation

2026-04-23 21:27:52 -05:00
parent f01721a45b
commit 494e29f797
7 changed files with 423 additions and 1 deletions
@@ -0,0 +1,65 @@
+# OpenCode Manual Install
+
+## Skill Root
+
+OpenCode skills are installed under:
+
+```bash
+~/.config/opencode/skills/<skill-name>/
+```
+
+Manual install example:
+
+```bash
+mkdir -p ~/.config/opencode/skills/implement-plan
+cp -R skills/implement-plan/opencode/* ~/.config/opencode/skills/implement-plan/
+```
+
+Use `skills/<skill>/opencode/*` for each supported skill.
+
+## Reviewer Runtime
+
+```bash
+mkdir -p ~/.config/opencode/skills/reviewer-runtime
+cp skills/reviewer-runtime/run-review.sh ~/.config/opencode/skills/reviewer-runtime/
+cp skills/reviewer-runtime/notify-telegram.sh ~/.config/opencode/skills/reviewer-runtime/
+chmod +x ~/.config/opencode/skills/reviewer-runtime/*.sh
+```
+
+## Superpowers
+
+OpenCode variants expect Superpowers at:
+
+```bash
+~/.config/opencode/skills/superpowers
+```
+
+Example:
+
+```bash
+ln -s /absolute/path/to/obra/superpowers/skills ~/.config/opencode/skills/superpowers
+```
+
+Verify:
+
+```bash
+ls -l ~/.config/opencode/skills/superpowers
+test -f ~/.config/opencode/skills/superpowers/brainstorming/SKILL.md
+test -f ~/.config/opencode/skills/superpowers/verification-before-completion/SKILL.md
+```
+
+## OpenCode Reviewer Notes
+
+OpenCode reviewer calls use the built-in read-oriented plan agent:
+
+```bash
+opencode run -m <provider>/<model> --agent plan --format json "review prompt"
+```
+
+## Verify
+
+```bash
+opencode --version
+test -f ~/.config/opencode/skills/implement-plan/SKILL.md
+test -x ~/.config/opencode/skills/reviewer-runtime/run-review.sh
+```