# list-subs

list-subs inspects active skill-bus subscriptions across global or project scopes and simulates event matching for individual skills.

- command · `type=command` · Claude Code, Codex, GitHub Copilot, Gemini CLI · ★ 2003 repo stars
- Author: composio-community
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/composio-community/awesome-claude-plugins/tree/HEAD/skill-bus/commands/list-subs.md
- Updated: 2026-07-26
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/commands/list-subs

## What it 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.

## Install

### Claude Code (native platform)

**Manually: put the files in place**
- File: `.claude/commands/list-subs.md` — Call it with /list-subs. For all projects use ~/.claude/commands/

### Codex

**Manually: put the files in place**
- File: `~/.codex/prompts/list-subs.md` — Call it with /prompts:list-subs. Codex marks this format deprecated in favour of skills

### GitHub Copilot

**Manually: put the files in place**
- File: `.github/prompts/list-subs.prompt.md`

### Gemini CLI

**Manually: put the files in place**
- File: `.gemini/commands/list-subs.toml` — Gemini stores commands as TOML: the prompt text goes into the prompt field

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/composio-community/awesome-claude-plugins/tree/HEAD/skill-bus/commands/list-subs.md

## When to use it
- 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
- Show all active skill-bus subscriptions
- Simulate what triggers for `superpowers:writing-plans`
- Test skill-bus matches with post timing

## Similar
- [workflows-list](https://affpapa.org/en/nevibecode/skills/workflows-list.md) — skill · 500 installs
- [recipe-create-task-list](https://affpapa.org/en/nevibecode/skills/recipe-create-task-list.md) — skill · 31300 installs
- [list-connections](https://affpapa.org/en/nevibecode/skills/microsoft-list-connections.md) — skill · ★ 1167 repo stars
- [list-npm-package-content](https://affpapa.org/en/nevibecode/skills/list-npm-package-content.md) — skill · 22 installs
- [punch-list-manager](https://affpapa.org/en/nevibecode/skills/punch-list-manager.md) — skill · 125 installs
- [thread-list](https://affpapa.org/en/nevibecode/skills/thread-list.md) — skill · 6500 installs

From the same set: [composio-community/awesome-claude-plugins](https://affpapa.org/en/nevibecode/by/composio-community/awesome-claude-plugins.md) — 68 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
