complete — Claude Code command: what it does, how to install
A signal command: Claude runs it by itself once a skill with "when": "complete" subscriptions has finished, and a hook starts the next steps in the chain.
no license ★ 2,003 updated 2026-07-26
.claude/commands/complete.mdWhat complete does
complete is a signal, not something you type to start work. Claude fires it on its own after a skill carrying "when": "complete" subscriptions has wrapped up. A PreToolUse hook intercepts the call, wakes the downstream subscriptions and places their instructions above the command text. Nothing added by the hook means no subscription matched, or conditions filtered them out.
It takes one argument: the skill name with its namespace, such as superpowers:writing-plans. Add --depth N to mark how deep the chain runs. Call it bare and you get a note that no skill name arrived, so there is nothing to trigger.
The markdown file .claude/commands/complete.md carries only the signal; the payload comes from the hook. Install the command while skill-bus and its hook are missing and the call lands nowhere, leaving the next step of the chain empty-handed.
What it helps with
- fire downstream subscriptions after a skill finishes
- hand context to the next step of a chain through a hook
- mark chain depth with
--depth - tell a missing subscription apart from one filtered out by conditions
Example prompts for the agent
- Finish the
superpowers:writing-plansskill, then send/skill-bus:complete superpowers:writing-plans. - Send
/skill-bus:complete superpowers:writing-plans --depth 2to mark where we sit in the chain. - Check whether the skill has
"when": "complete"subscriptions, and if it does, run/skill-bus:complete superpowers:writing-plans.
How to install complete
Manually: put the files in place
.claude/commands/complete.mdCall it with /complete. For all projects use ~/.claude/commands/
Manually: put the files in place
~/.codex/prompts/complete.mdCall it with /prompts:complete. Codex marks this format deprecated in favour of skills
Manually: put the files in place
.github/prompts/complete.prompt.mdManually: put the files in place
.gemini/commands/complete.tomlGemini stores commands as TOML: the prompt text goes into the prompt field
Questions about complete
How to install complete in Claude Code?
Copy the command file into your project at .claude/commands/complete.md. From then on Claude invokes it itself when a skill with "when": "complete" subscriptions is done.
What does complete do?
It signals that a skill has finished. The PreToolUse hook catches the call and fires the subscriptions waiting on that skill, injecting their instructions into context.
What goes into the arguments?
The finished skill's name with its namespace, for example superpowers:writing-plans, plus --depth N if you want chain tracking. With no argument the command triggers nothing.