Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add composio-community/awesome-claude-plugins --skill list-subs -a claude-code
Open on GitHub

What 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-subs and 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-code

2Manually: put the files in place

~/.claude/skills/list-subs/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/list-subs/

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.

Similar skills

All skills for Agent setup: memory, context, orchestration →

From the same set68

The whole set →
perf-theory-gatherer perf-theory-gatherer analyzes git history and metrics to generate performance bottleneck hypotheses. Useful when investigating speed regressions across multiple runtimes. CX Codex ★ 2,003repo stars unpause-subs unpause-subs restores skill bus subscription handling after a pause. Use it when subscriptions were disabled for the project, globally, or at both levels. CX Codex +1 ★ 2,003repo stars unpause-subs unpause-subs restarts the skill bus after it has been paused and reactivates subscription handling. Use it to quickly return to normal operation after stopping the bus. CX Codex +1 ★ 2,003repo stars code-review code-review inspects recent repository changes using git context. It spots security flaws, performance bottlenecks, and test gaps before you push code. CX Codex +1 ★ 2,003repo stars pause-subs pause-subs turns the skill bus off, everywhere or for one project. Subscriptions stay in place and stop firing until you switch them back. CX Codex +1 ★ 2,003repo stars perf-analyzer perf-analyzer — a Claude Code subagent that turns profiling results and benchmark experiments into evidence-backed recommendations structured by a strict template. CX Codex ★ 2,003repo stars documentation-generator The documentation-generator command turns code, APIs, and project details into structured developer documentation. Use it when setup notes, examples, or endpoint references need to be written. CX Codex +1 ★ 2,003repo stars perf-investigation-logger perf-investigation-logger — a subagent for structured documentation of performance investigations. Captures verbatim user statements, findings, and evidence in a single log. CX Codex ★ 2,003repo stars

Project sponsors

Companies that keep this analytics open