pause-subs — Claude Code command: pause the skill bus
pause-subs turns the skill bus off, everywhere or for one project. Subscriptions stay in place and stop firing until you switch them back.
no license ★ 2,003 updated 2026-07-26
.claude/commands/pause-subs.mdWhat pause-subs does
The command halts the skill bus. It asks which level you mean, then flips settings.enabled to false in the matching config: ~/.claude/skill-bus.json for global, .claude/skill-bus.json for the project.
No config file yet? It creates the directory and writes one holding a single settings block with enabled: false. The subscriptions themselves are left alone, so nothing has to be rebuilt later.
A global pause reaches every project you open, since that file sits in your home directory. Pick project scope when only one repository should go quiet. /skill-bus:unpause-subs from the skill-bus plugin turns things back on.
What it helps with
- Silence every skill-bus subscription while debugging
- Quiet the bus in one repo without touching the rest
- Keep the subscription config instead of deleting it
- Check whether the bus is what interferes, with no manual edits
Example prompts for the agent
- Pause the skill bus for this project only
- Turn off all skill-bus subscriptions globally, I'll re-enable them later
- Stop the subscriptions firing via
pause-subs, leave the files alone
How to install pause-subs
Manually: put the files in place
.claude/commands/pause-subs.mdCall it with /pause-subs. For all projects use ~/.claude/commands/
Manually: put the files in place
~/.codex/prompts/pause-subs.mdCall it with /prompts:pause-subs. Codex marks this format deprecated in favour of skills
Manually: put the files in place
.github/prompts/pause-subs.prompt.mdManually: put the files in place
.gemini/commands/pause-subs.tomlGemini stores commands as TOML: the prompt text goes into the prompt field
Questions about pause-subs
How to install pause-subs in Claude Code?
Copy the command file to .claude/commands/pause-subs.md in your project. Claude then lists it as a slash command.
What does pause-subs do?
It disables the skill bus at the level you choose by writing settings.enabled: false into the config. Subscriptions remain, they just do not fire.
How do I turn the bus back on?
Run /skill-bus:unpause-subs, which comes with the skill-bus plugin.