feat(installer): improve cursor and opencode skill handling

skills/do-task/opencode/SKILL.md

@@ -9,14 +9,14 @@ Execute an ad-hoc user prompt end-to-end: parse → clarify → plan (with revie
 
 This is a single-artifact sibling of `create-plan` + `implement-plan`. Unlike `implement-plan`, `do-task` operates on one persistent `task-plan.md` (not a full milestone plan) and defaults to the **current branch** (not a worktree).
 
-**Core principle:** OpenCode loads skills through its native skill tool from `~/.config/opencode/skills/`. Sub-skill invocations use OpenCode's native mechanism — not Claude's `Skill` tool, not Codex's native-discovery patterns, not Cursor's workspace discovery.
+**Core principle:** OpenCode loads skills through its native skill tool. Local skills live under `~/.config/opencode/skills/`, and OpenCode can also expose shared agent skills from `~/.agents/skills/`. Sub-skill invocations use OpenCode's native mechanism — not Claude's `Skill` tool, not Cursor's workspace discovery.
 
 ## Prerequisite Check (MANDATORY)
 
 Required:
 - OpenCode CLI: `opencode --version` (install via your package manager or `brew install opencode`).
 - Superpowers repo: `https://github.com/obra/superpowers`
-- OpenCode Superpowers skills symlink: `~/.config/opencode/skills/superpowers`
+- OpenCode Superpowers skills available at `~/.agents/skills/superpowers` or `~/.config/opencode/skills/superpowers`
 - `superpowers/brainstorming`
 - `superpowers/test-driven-development`
 - `superpowers/verification-before-completion`
@@ -29,11 +29,10 @@ Verify before proceeding:
 
 ```bash
 opencode --version
-ls -l ~/.config/opencode/skills/superpowers
-test -f ~/.config/opencode/skills/superpowers/brainstorming/SKILL.md
-test -f ~/.config/opencode/skills/superpowers/test-driven-development/SKILL.md
-test -f ~/.config/opencode/skills/superpowers/verification-before-completion/SKILL.md
-test -f ~/.config/opencode/skills/superpowers/finishing-a-development-branch/SKILL.md
+test -f ~/.agents/skills/superpowers/brainstorming/SKILL.md || test -f ~/.config/opencode/skills/superpowers/brainstorming/SKILL.md
+test -f ~/.agents/skills/superpowers/test-driven-development/SKILL.md || test -f ~/.config/opencode/skills/superpowers/test-driven-development/SKILL.md
+test -f ~/.agents/skills/superpowers/verification-before-completion/SKILL.md || test -f ~/.config/opencode/skills/superpowers/verification-before-completion/SKILL.md
+test -f ~/.agents/skills/superpowers/finishing-a-development-branch/SKILL.md || test -f ~/.config/opencode/skills/superpowers/finishing-a-development-branch/SKILL.md
 ```
 
 If any required dependency is missing, stop immediately and return:
@@ -46,7 +45,7 @@ If any required dependency is missing, stop immediately and return:
 - Announce skill usage explicitly:
   - `I've read the [Skill Name] skill and I'm using it to [purpose].`
 - For skills with checklists, track checklist items explicitly in conversation.
-- Do NOT use Claude's `Skill` tool syntax, Codex's `~/.agents/skills/` native-discovery paths, or Cursor's workspace discovery. OpenCode's skill system is independent.
+- Do NOT use Claude's `Skill` tool syntax or Cursor's workspace discovery. OpenCode's skill system may expose shared files from `~/.agents/skills/`, but invocation still goes through OpenCode's native skill mechanism.
 
 ## Trigger Phrase Detection
 
@@ -795,7 +794,7 @@ Review History is append-only.
 
 ## Variant Hardening Notes — OpenCode
 
-- Must use OpenCode's native skill tool for sub-skill invocation. Do NOT use Claude's `Skill` tool syntax or Codex's `~/.agents/skills/` paths.
+- Must use OpenCode's native skill tool for sub-skill invocation. Do NOT use Claude's `Skill` tool syntax. OpenCode may load shared skill files from `~/.agents/skills/`, but invocation is still OpenCode-native.
 - Phase 1 includes a Bootstrap Superpowers Context step that lists installed skills and confirms `superpowers/brainstorming`, `superpowers/test-driven-development`, `superpowers/verification-before-completion`, and `superpowers/finishing-a-development-branch` are discoverable before any other phase runs.
 - Helper paths are `~/.config/opencode/skills/reviewer-runtime/{run-review.sh,notify-telegram.sh}`.
 - OpenCode reviewer CLI branch (when `REVIEWER_CLI=opencode`):
@@ -809,7 +808,7 @@ Review History is append-only.
 ## Common Mistakes
 
 - Skipping the Bootstrap Superpowers Context step in Phase 1 (breaks native skill discovery).
-- Using Claude `Skill` tool syntax or Codex `~/.agents/skills/` paths.
+- Using Claude `Skill` tool syntax, or treating shared `~/.agents/skills/` files as anything other than OpenCode-native skill entries.
 - Forgetting to set `--agent plan` on opencode reviewer calls (would use the default `build` agent which can write files).
 - Asking multiple clarifying questions in a single message.
 - Skipping the per-payload secret scan because "the previous round was clean".