docs: cross-LLM install layer — README matrix, host INSTALL.md sections, CI check#18
Merged
Conversation
- README.md: add Cross-LLM Compatibility section with 4-host install matrix - docs/README.codex.md: fix obra/superpowers → GoCodeAlone/claude-superpowers refs throughout; add Cross-LLM Behavior section with host declaration guidance - docs/README.opencode.md: same obra ref fix; add Cross-LLM Behavior section Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
- agents/team-conventions.md: insert Modes paragraph describing Sequential and Agent Teams execution modes - .codex/INSTALL.md: fix clone URL; append Cross-LLM Behavior section with AGENTS.md host declaration snippet - .opencode/INSTALL.md: fix clone URL; append Cross-LLM Behavior section with AGENTS.md host declaration snippet; fix help links Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Runs on push when skills/**, agents/**, or tests/skill-content-grep.sh change, and on workflow_dispatch. Enforces that no host-specific tokens (TodoWrite, Sonnet, etc.) appear in skill markdown outside <host: claude-code> blocks. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Contributor
Author
|
@copilot review |
Symlink target, update path, uninstall path, and troubleshooting path were changed to ~/.codex/claude-superpowers while the clone destination remained ~/.codex/superpowers. Restore consistency: all local paths now reference ~/.codex/superpowers to match the git clone command. Agent-Logs-Url: https://github.com/GoCodeAlone/claude-superpowers/sessions/7ff4116b-ea0a-4ea8-9e61-12175da23721 Co-authored-by: intel352 <77607+intel352@users.noreply.github.com>
Contributor
Reviewed the PR changes. Found and fixed one path inconsistency in Everything else looks correct:
|
Contributor
There was a problem hiding this comment.
Pull request overview
Documentation and CI updates to support “cross-LLM” portability: clarifies host-specific behavior gating via <host: claude-code> blocks, updates install/clone references to the new repo, and adds a CI guard to prevent Claude-specific tokens from leaking into host-neutral skill text.
Changes:
- Add Cross-LLM Compatibility/Behavior documentation across top-level README and host-specific READMEs/INSTALL docs.
- Update OpenCode/Codex docs to reference
GoCodeAlone/claude-superpowersinstead ofobra/superpowers. - Add a GitHub Actions workflow to run
tests/skill-content-grep.shon relevant changes.
Reviewed changes
Copilot reviewed 7 out of 7 changed files in this pull request and generated 5 comments.
Show a summary per file
| File | Description |
|---|---|
| docs/README.opencode.md | Updates clone URLs + adds Cross-LLM Behavior guidance for OpenCode. |
| docs/README.codex.md | Updates clone URLs + adds Cross-LLM Behavior guidance for Codex. |
| agents/team-conventions.md | Documents Sequential vs Agent Teams execution modes. |
| README.md | Adds Cross-LLM Compatibility section and host install matrix. |
| .opencode/INSTALL.md | Updates clone URL + adds Cross-LLM/host declaration snippet. |
| .github/workflows/skill-content-check.yml | Adds CI workflow to run the skill-content grep guard. |
| .codex/INSTALL.md | Updates clone URL + adds Cross-LLM/host declaration snippet. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
Comment on lines
107
to
111
| ### Skills not showing up | ||
|
|
||
| 1. Verify the symlink: `ls -la ~/.agents/skills/superpowers` | ||
| 2. Check skills exist: `ls ~/.codex/superpowers/skills` | ||
| 3. Restart Codex — skills are discovered at startup |
| paths: | ||
| - 'skills/**' | ||
| - 'agents/**' | ||
| - 'tests/skill-content-grep.sh' |
Comment on lines
+92
to
+97
| | 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 | |
Comment on lines
22
to
31
| 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: | ||
| ```bash | ||
| mkdir -p ~/.agents/skills | ||
| ln -s ~/.codex/superpowers/skills ~/.agents/skills/superpowers | ||
| ``` |
Comment on lines
86
to
88
| ```bash | ||
| cd ~/.codex/superpowers && git pull | ||
| ``` |
Contributor
Author
|
@copilot review |
…nt-check - Add pull_request trigger with same path filters so the check runs on PRs - Add .github/workflows/skill-content-check.yml to the paths list so changes to the guard/workflow itself are validated by the workflow Agent-Logs-Url: https://github.com/GoCodeAlone/claude-superpowers/sessions/8cf5ed69-edc1-4f84-b005-69dd59d4198c Co-authored-by: intel352 <77607+intel352@users.noreply.github.com>
Contributor
Addressed the remaining review feedback (commit a34213b):
The path inconsistencies in |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
obra/superpowers→GoCodeAlone/claude-superpowersrepo refs throughout; add Cross-LLM Behavior section with host declaration guidanceAGENTS.mdhost declaration snippettests/skill-content-grep.shon push toskills/**,agents/**,tests/skill-content-grep.sh, orworkflow_dispatchTest plan
tests/skill-content-grep.shpasses locally (no host-specific tokens outside<host: claude-code>blocks)🤖 Generated with Claude Code