list-subs — Claude Code skill: what it does, how to install
list-subs inspects active skill-bus subscriptions across global and project settings. Use it to trace conditions and predict which skills would run.
no license ★ 2,003 updated 2026-07-26
npx skills add composio-community/awesome-claude-plugins --skill list-subs -a claude-codeWhat list-subs does
The skill reads ~/.claude/skill-bus.json and the project-level .claude/skill-bus.json when that file exists. It then presents the merged subscription state, including merge status, conditions attached to an insert, subscription-specific conditions, and the resulting condition stack for each skill.
When asked what would fire for a case such as X, it performs a condition-by-condition simulation at both levels. The project configuration is used only when present, so the merged view changes with the files available.
What it helps with
- inspect active skill-bus subscriptions
- compare global and project configuration
- trace the conditions attached to a subscription
- simulate which skills would fire for an event
Example prompts for the agent
- Run
/skill-bus:list-subsand show every active skill-bus subscription. - For X, simulate the matching process and report each condition result.
- Compare the global and project subscription settings.
How to install list-subs
1Skills CLI (Vercel)
npx skills add composio-community/awesome-claude-plugins --skill list-subs -a claude-code2Manually: put the files in place
~/.claude/skills/list-subs/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/list-subs/
1Skills CLI (Vercel)
npx skills add composio-community/awesome-claude-plugins --skill list-subs -a codex2Manually: put the files in place
.agents/skills/list-subs/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add composio-community/awesome-claude-plugins --skill list-subs -a cursor2Manually: put the files in place
.cursor/skills/list-subs/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install composio-community/awesome-claude-plugins skill-bus/skills/list-subs2Manually: put the files in place
.github/skills/list-subs/SKILL.md1Skills CLI (Vercel)
npx skills add composio-community/awesome-claude-plugins --skill list-subs -a gemini-cli2Platform CLI
gemini skills install https://github.com/composio-community/awesome-claude-plugins --path skill-bus/skills/list-subsManually: put the files in place
.devin/skills/list-subs/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about list-subs
How do I install list-subs in Claude Code?
Run npx skills add composio-community/awesome-claude-plugins --skill list-subs -a claude-code, then open ~/.claude/skills/list-subs/SKILL.md.
What does list-subs do?
It combines the global and project skill-bus settings, then displays active subscriptions and their effective conditions. It can also simulate a requested firing scenario.
Which configuration files does list-subs inspect?
It reads ~/.claude/skill-bus.json and .claude/skill-bus.json when the project file exists.