| name | operate-plugin |
| description | Install, repair, package, or verify the SpecPowers plugin and its generated payloads. |
Operate Plugin
Use this mode for plugin installation, repair, packaging, and runtime
verification. It owns platform details so the workflow skills stay platform
neutral.
Rules
- Treat
.codex-plugin/plugin.json, .claude-plugin/plugin.json,
.agents/plugins/marketplace.json, manifests/, and skills/ as the source
of truth.
- Codex reads authored skills from
skills/.
- Claude Code reads the managed
.claude/skills/ payload generated by
scripts/install.js.
- Do not copy or symlink skills manually unless the platform install contract
explicitly requires it.
- Verify the installed runtime, not only the repository files.
Common Checks
- Manifest JSON parses.
- Every manifest path exists.
- Claude Code payload generation succeeds in a temporary checkout or explicit
install target.
- Codex plugin metadata points at
./skills/.
- The session hook loads
using-specpowers.
Failure Handling
If an install is stale or broken, prefer clean reinstall over compatibility
patches. Report old paths removed and the exact verification performed.