list-subs — Claude Code command: what it does, how to install
list-subs inspects active skill-bus subscriptions across global or project scopes and simulates event matching for individual skills.
no license ★ 2,003 updated 2026-07-26
.claude/commands/list-subs.mdWhat list-subs does
The command audits skill-bus subscriptions by checking global and local project definitions. It reports merge details and rules defined at subscription levels.
Under the hood, it locates cli.py in ~/.claude/plugins/cache/ or ~/.claude/plugins/repos/skill-bus/lib/ and runs it via python3. Without Python 3 and the local plugin files, the script fails immediately.
It also includes a simulation mode. Passing a target skill name tests which handlers run during execution. By default, it uses the pre phase.
What it helps with
- inspect active skill-bus subscriptions in current project
- verify condition stacking across global and project scopes
- simulate trigger events with pre, post, or complete timing
Example prompts for the agent
- Show all active skill-bus subscriptions
- Simulate what triggers for
superpowers:writing-plans - Test skill-bus matches with post timing
How to install list-subs
Manually: put the files in place
.claude/commands/list-subs.mdCall it with /list-subs. For all projects use ~/.claude/commands/
Manually: put the files in place
~/.codex/prompts/list-subs.mdCall it with /prompts:list-subs. Codex marks this format deprecated in favour of skills
Manually: put the files in place
.github/prompts/list-subs.prompt.mdManually: put the files in place
.gemini/commands/list-subs.tomlGemini stores commands as TOML: the prompt text goes into the prompt field
Questions about list-subs
How to install list-subs in Claude Code?
Save the definition file to .claude/commands/list-subs.md.
What does list-subs do?
It outputs active skill-bus listeners, condition hierarchies, and merge states for your current workspace.
What dependencies does list-subs require?
It needs a local python3 executable and the skill-bus plugin files in Claude cache or repository folders.