edit-insert — Claude Code command: what it does, how to install
edit-insert modifies stored text content and trigger conditions for skill-bus inserts. Useful when you need to update prompt context across all connected subscriptions.
no license ★ 2,003 updated 2026-07-26
.claude/commands/edit-insert.mdWhat edit-insert does
The edit-insert command guides you through modifying existing prompt fragments within the skill-bus setup. It first asks whether you want to work on global settings in ~/.claude/skill-bus.json or local project values in .claude/skill-bus.json. If no items exist, execution halts.
The tool fetches active inserts by invoking a helper script via python3. You can modify raw text or tweak condition rules such as file checks. The command fails if python3 or the underlying skill-bus plugin files are missing from your disk.
Once finished, the command writes changes to the target JSON configuration and scans both scopes to report affected subscriptions. Altered conditions apply everywhere automatically, except on subscriptions that explicitly opt out through inheritConditions: false.
What it helps with
- modify shared prompt insert text across multiple agent subscriptions
- adjust trigger conditions for inserts at project or user level
- inspect which subscriptions inherit specific insert changes
- clear outdated activation rules from an existing insert
Example prompts for the agent
- /edit-insert
- Update the text of our compound-knowledge insert in project scope
- Modify conditions for the global skill-bus insert
How to install edit-insert
Manually: put the files in place
.claude/commands/edit-insert.mdCall it with /edit-insert. For all projects use ~/.claude/commands/
Manually: put the files in place
~/.codex/prompts/edit-insert.mdCall it with /prompts:edit-insert. Codex marks this format deprecated in favour of skills
Manually: put the files in place
.github/prompts/edit-insert.prompt.mdManually: put the files in place
.gemini/commands/edit-insert.tomlGemini stores commands as TOML: the prompt text goes into the prompt field
Questions about edit-insert
How to install edit-insert in Claude Code?
Place the command definition file at .claude/commands/edit-insert.md inside your workspace.
What does edit-insert do?
It provides an interactive prompt to modify the body text and activation filters of existing skill-bus inserts.
How do condition edits affect existing subscriptions?
Edits apply across all subscriptions referencing that insert in both scopes. The only exceptions are subscriptions configured with inheritConditions: false.