feat(installer): improve cursor and opencode skill handling

docs/CURSOR.md

@@ -23,7 +23,21 @@ mkdir -p ~/.cursor/skills/create-plan
 cp -R skills/create-plan/cursor/* ~/.cursor/skills/create-plan/
 ```
 
-Cursor variants exist for `atlassian`, `create-plan`, `do-task`, and `implement-plan`. `web-automation` currently has no Cursor variant.
+Cursor variants exist for `atlassian`, `create-plan`, `do-task`, `implement-plan`, and `web-automation`.
+
+Web automation repo-local install:
+
+```bash
+mkdir -p .cursor/skills/web-automation
+cp -R skills/web-automation/cursor/* .cursor/skills/web-automation/
+cd .cursor/skills/web-automation/scripts
+pnpm install
+npx cloakbrowser install
+pnpm approve-builds
+pnpm rebuild better-sqlite3 esbuild
+```
+
+Global web automation installs use `~/.cursor/skills/web-automation/` instead.
 
 ## Reviewer Runtime
 
@@ -40,14 +54,19 @@ Global uses `~/.cursor/skills/reviewer-runtime/` instead.
 
 ## Superpowers
 
-Cursor variants expect the nested Superpowers layout:
+Cursor can discover Superpowers from the Cursor plugin cache or from manual
+repo-local/global skill roots. Prefer the plugin install when it is present;
+do not also install a manual Superpowers copy, or Cursor may show each
+Superpowers skill twice.
 
 ```bash
+.cursor/plugins/cache/cursor-public/superpowers/<revision>/skills/<superpower>/SKILL.md
+~/.cursor/plugins/cache/cursor-public/superpowers/<revision>/skills/<superpower>/SKILL.md
 .cursor/skills/superpowers/skills/<superpower>/SKILL.md
 ~/.cursor/skills/superpowers/skills/<superpower>/SKILL.md
 ```
 
-Recommended symlink:
+Manual symlink, only when the Cursor plugin is not installed:
 
 ```bash
 mkdir -p .cursor/skills/superpowers
@@ -72,7 +91,7 @@ Repo-local scope:
 ```bash
 cursor-agent --version
 test -f .cursor/skills/create-plan/SKILL.md
-test -f .cursor/skills/superpowers/skills/brainstorming/SKILL.md
+test -f .cursor/skills/superpowers/skills/brainstorming/SKILL.md || find ~/.cursor/plugins/cache/cursor-public/superpowers -path '*/skills/brainstorming/SKILL.md' -print -quit 2>/dev/null | grep -q .
 ```
 
 Global scope:
@@ -80,5 +99,5 @@ Global scope:
 ```bash
 cursor-agent --version
 test -f ~/.cursor/skills/create-plan/SKILL.md
-test -f ~/.cursor/skills/superpowers/skills/brainstorming/SKILL.md
+test -f ~/.cursor/skills/superpowers/skills/brainstorming/SKILL.md || find ~/.cursor/plugins/cache/cursor-public/superpowers -path '*/skills/brainstorming/SKILL.md' -print -quit 2>/dev/null | grep -q .
 ```

docs/INSTALLER.md

@@ -50,7 +50,7 @@ The current skill matrix is:
 | `create-plan` | yes | yes | yes | yes | yes |
 | `do-task` | yes | yes | yes | yes | yes |
 | `implement-plan` | yes | yes | yes | yes | yes |
-| `web-automation` | yes | yes | no | yes | yes |
+| `web-automation` | yes | yes | yes | yes | yes |
 
 ## Superpowers Handling
 

docs/OPENCODE.md

@@ -28,13 +28,21 @@ chmod +x ~/.config/opencode/skills/reviewer-runtime/*.sh
 
 ## Superpowers
 
-OpenCode variants expect Superpowers at:
+OpenCode can discover Superpowers from the shared agents skill root or the
+OpenCode-specific skills root:
 
 ```bash
+~/.agents/skills/superpowers
 ~/.config/opencode/skills/superpowers
 ```
 
-Example:
+OpenCode's native setup commonly exposes the shared agents root:
+
+```bash
+ln -s /absolute/path/to/obra/superpowers/skills ~/.agents/skills/superpowers
+```
+
+OpenCode-specific setup is also supported:
 
 ```bash
 ln -s /absolute/path/to/obra/superpowers/skills ~/.config/opencode/skills/superpowers
@@ -43,9 +51,8 @@ ln -s /absolute/path/to/obra/superpowers/skills ~/.config/opencode/skills/superp
 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
+test -f ~/.agents/skills/superpowers/brainstorming/SKILL.md || test -f ~/.config/opencode/skills/superpowers/brainstorming/SKILL.md
+test -f ~/.agents/skills/superpowers/verification-before-completion/SKILL.md || test -f ~/.config/opencode/skills/superpowers/verification-before-completion/SKILL.md
 ```
 
 ## OpenCode Reviewer Notes

docs/WEB-AUTOMATION.md

@@ -48,6 +48,22 @@ pnpm approve-builds
 pnpm rebuild better-sqlite3 esbuild
 ```
 
+### Cursor
+
+Repo-local install:
+
+```bash
+mkdir -p .cursor/skills/web-automation
+cp -R skills/web-automation/cursor/* .cursor/skills/web-automation/
+cd .cursor/skills/web-automation/scripts
+pnpm install
+npx cloakbrowser install
+pnpm approve-builds
+pnpm rebuild better-sqlite3 esbuild
+```
+
+Global installs use `~/.cursor/skills/web-automation/` instead.
+
 ### OpenCode
 
 ```bash