docs: cross-LLM install layer — README matrix, host INSTALL.md sections, CI check

.codex/INSTALL.md

@@ -10,7 +10,7 @@ Enable superpowers skills in Codex via native skill discovery. Just clone and sy
 
 1. **Clone the superpowers repository:**
    ```bash
-   git clone https://github.com/obra/superpowers.git ~/.codex/superpowers
+   git clone https://github.com/GoCodeAlone/claude-superpowers.git ~/.codex/superpowers
    ```
 
 2. **Create the skills symlink:**
@@ -65,3 +65,16 @@ rm ~/.agents/skills/superpowers
 ```
 
 Optionally delete the clone: `rm -rf ~/.codex/superpowers`.
+
+## Cross-LLM Behavior
+
+Superpowers skills use `<host: claude-code>` blocks to gate Claude Code-only content. Codex skips those blocks automatically; no configuration needed.
+
+To enable host-conditional logic inside skills (so skills can adapt behavior per host), declare your host in `~/.codex/AGENTS.md`:
+
+```markdown
+# Superpowers host declaration
+Host: codex
+```
+
+Add this block once. Skills that inspect the host context will use it to pick the right execution path.

.github/workflows/skill-content-check.yml

@@ -0,0 +1,27 @@
+name: Skill Content Check
+
+on:
+  push:
+    paths:
+      - 'skills/**'
+      - 'agents/**'
+      - 'tests/skill-content-grep.sh'
+      - '.github/workflows/skill-content-check.yml'
+  pull_request:
+    paths:
+      - 'skills/**'
+      - 'agents/**'
+      - 'tests/skill-content-grep.sh'
+      - '.github/workflows/skill-content-check.yml'
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  skill-content-check:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Check skill content for host-specific tokens
+        run: bash tests/skill-content-grep.sh

.opencode/INSTALL.md

@@ -10,7 +10,7 @@
 ### 1. Clone Superpowers
 
 ```bash
-git clone https://github.com/obra/superpowers.git ~/.config/opencode/superpowers
+git clone https://github.com/GoCodeAlone/claude-superpowers.git ~/.config/opencode/superpowers
 ```
 
 ### 2. Register the Plugin
@@ -113,7 +113,20 @@ When skills reference Claude Code tools:
 - `Skill` tool → OpenCode's native `skill` tool
 - File operations → your native tools
 
+## Cross-LLM Behavior
+
+Superpowers skills use `<host: claude-code>` blocks to gate Claude Code-only content. OpenCode skips those blocks automatically; no configuration needed.
+
+To enable host-conditional logic inside skills (so skills can adapt behavior per host), declare your host in `~/.config/opencode/AGENTS.md`:
+
+```markdown
+# Superpowers host declaration
+Host: opencode
+```
+
+Add this block once. Skills that inspect the host context will use it to pick the right execution path.
+
 ## Getting Help
 
-- Report issues: https://github.com/obra/superpowers/issues
-- Full documentation: https://github.com/obra/superpowers/blob/main/docs/README.opencode.md
+- Report issues: https://github.com/GoCodeAlone/claude-superpowers/issues
+- Full documentation: https://github.com/GoCodeAlone/claude-superpowers/blob/main/docs/README.opencode.md

README.md

@@ -85,6 +85,17 @@ Fetch and follow instructions from https://raw.githubusercontent.com/GoCodeAlone
 
 Start a new session in your chosen platform and ask for something that should trigger a skill (for example, "help me plan this feature" or "let's debug this issue"). The agent should automatically invoke the relevant superpowers skill.
 
+## Cross-LLM Compatibility
+
+Superpowers skills run on any host that supports the SKILL.md format. Host-specific tools (like Agent Teams) are conditioned with `<host: claude-code>` blocks so other hosts skip them gracefully.
+
+| Host | Install path | Native skill discovery | Notes |
+|---|---|---|---|
+| Claude Code | `~/.claude/plugins/marketplace/superpowers/` | yes | Full Agent Teams support (experimental flag) |
+| Codex | `~/.agents/skills/superpowers/` | yes | Sequential sub-agent dispatch; `/plan` slash; `/agent` switching |
+| OpenCode | `~/.config/opencode/skills/superpowers/` | yes | Tool mapping documented in `.opencode/INSTALL.md` |
+| Cursor | manual reference | partial | Plugin manifest stub; install path TBD |
+
 ## The Basic Workflow
 
 1. **brainstorming** - Activates before writing code. Refines rough ideas through questions, explores alternatives, presents design in sections for validation. Saves design document.

agents/team-conventions.md

@@ -47,6 +47,13 @@ them.
   (or REVERT-AND-REWRITE after max rounds).
 - Reflexive approval is forbidden.
 
+## Modes
+
+Team conventions apply identically in both execution modes:
+
+- **Sequential Mode** (all hosts): orchestrator dispatches one sub-agent at a time; reviewers run between tasks.
+- **Agent Teams Mode** (Claude Code only, opt-in): persistent named teammates in a shared chat surface; reviewers run in parallel after each task.
+
 ## All agents
 
 - DRY: when re-stating a convention, prefer "per `<skill>`" over

docs/README.codex.md

@@ -7,7 +7,7 @@ Guide for using Superpowers with OpenAI Codex via native skill discovery.
 Tell Codex:
 
 ```
-Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.codex/INSTALL.md
+Fetch and follow instructions from https://raw.githubusercontent.com/GoCodeAlone/claude-superpowers/refs/heads/main/.codex/INSTALL.md
 ```
 
 ## Manual Installation
@@ -21,7 +21,7 @@ Fetch and follow instructions from https://raw.githubusercontent.com/obra/superp
 
 1. Clone the repo:
    ```bash
-   git clone https://github.com/obra/superpowers.git ~/.codex/superpowers
+   git clone https://github.com/GoCodeAlone/claude-superpowers.git ~/.codex/superpowers
    ```
 
 2. Create the skills symlink:
@@ -114,7 +114,19 @@ Optionally delete the clone: `rm -rf ~/.codex/superpowers` (Windows: `Remove-Ite
 
 Junctions normally work without special permissions. If creation fails, try running PowerShell as administrator.
 
+## Cross-LLM Behavior
+
+Superpowers skills use `<host: claude-code>` blocks to gate content that only applies to Claude Code (Agent Teams, specific tool names, etc.). On Codex, those blocks are skipped — the rest of the skill runs as-is.
+
+To let skills detect that they are running on Codex, add a host declaration to your `~/.codex/AGENTS.md`:
+
+```markdown
+Host: codex
+```
+
+This single line enables host-conditional skill logic. See `.codex/INSTALL.md` for the full declaration snippet.
+
 ## Getting Help
 
-- Report issues: https://github.com/obra/superpowers/issues
-- Main documentation: https://github.com/obra/superpowers
+- Report issues: https://github.com/GoCodeAlone/claude-superpowers/issues
+- Main documentation: https://github.com/GoCodeAlone/claude-superpowers

docs/README.opencode.md

@@ -7,7 +7,7 @@ Complete guide for using Superpowers with [OpenCode.ai](https://opencode.ai).
 Tell OpenCode:
 
 ```
-Clone https://github.com/obra/superpowers to ~/.config/opencode/superpowers, then create directory ~/.config/opencode/plugins, then symlink ~/.config/opencode/superpowers/.opencode/plugins/superpowers.js to ~/.config/opencode/plugins/superpowers.js, then symlink ~/.config/opencode/superpowers/skills to ~/.config/opencode/skills/superpowers, then restart opencode.
+Clone https://github.com/GoCodeAlone/claude-superpowers to ~/.config/opencode/superpowers, then create directory ~/.config/opencode/plugins, then symlink ~/.config/opencode/superpowers/.opencode/plugins/superpowers.js to ~/.config/opencode/plugins/superpowers.js, then symlink ~/.config/opencode/superpowers/skills to ~/.config/opencode/skills/superpowers, then restart opencode.
 ```
 
 ## Manual Installation
@@ -24,7 +24,7 @@ Clone https://github.com/obra/superpowers to ~/.config/opencode/superpowers, the
 if [ -d ~/.config/opencode/superpowers ]; then
   cd ~/.config/opencode/superpowers && git pull
 else
-  git clone https://github.com/obra/superpowers.git ~/.config/opencode/superpowers
+  git clone https://github.com/GoCodeAlone/claude-superpowers.git ~/.config/opencode/superpowers
 fi
 
 # 2. Create directories
@@ -66,7 +66,7 @@ Run as Administrator, or with Developer Mode enabled:
 
 ```cmd
 :: 1. Install Superpowers
-git clone https://github.com/obra/superpowers.git "%USERPROFILE%\.config\opencode\superpowers"
+git clone https://github.com/GoCodeAlone/claude-superpowers.git "%USERPROFILE%\.config\opencode\superpowers"
 
 :: 2. Create directories
 mkdir "%USERPROFILE%\.config\opencode\plugins" 2>nul
@@ -91,7 +91,7 @@ Run as Administrator, or with Developer Mode enabled:
 
 ```powershell
 # 1. Install Superpowers
-git clone https://github.com/obra/superpowers.git "$env:USERPROFILE\.config\opencode\superpowers"
+git clone https://github.com/GoCodeAlone/claude-superpowers.git "$env:USERPROFILE\.config\opencode\superpowers"
 
 # 2. Create directories
 New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.config\opencode\plugins"
@@ -116,7 +116,7 @@ Note: Git Bash's native `ln` command copies files instead of creating symlinks.
 
 ```bash
 # 1. Install Superpowers
-git clone https://github.com/obra/superpowers.git ~/.config/opencode/superpowers
+git clone https://github.com/GoCodeAlone/claude-superpowers.git ~/.config/opencode/superpowers
 
 # 2. Create directories
 mkdir -p ~/.config/opencode/plugins ~/.config/opencode/skills
@@ -306,10 +306,22 @@ If you see `Cannot find module` errors on Windows:
 2. Check OpenCode version supports `experimental.chat.system.transform` hook
 3. Restart OpenCode after plugin changes
 
+## Cross-LLM Behavior
+
+Superpowers skills use `<host: claude-code>` blocks to gate content that only applies to Claude Code (Agent Teams, specific tool names, etc.). On OpenCode, those blocks are skipped — the rest of the skill runs as-is.
+
+To let skills detect that they are running on OpenCode, add a host declaration to your `~/.config/opencode/AGENTS.md`:
+
+```markdown
+Host: opencode
+```
+
+This single line enables host-conditional skill logic. See `.opencode/INSTALL.md` for the full declaration snippet.
+
 ## Getting Help
 
-- Report issues: https://github.com/obra/superpowers/issues
-- Main documentation: https://github.com/obra/superpowers
+- Report issues: https://github.com/GoCodeAlone/claude-superpowers/issues
+- Main documentation: https://github.com/GoCodeAlone/claude-superpowers
 - OpenCode docs: https://opencode.ai/docs/
 
 ## Testing