capture — Claude Code command: what it does, how to install
capture synthesizes the active conversation into a flow-next spec at .flow/specs/<spec-id>.md with review checks and overwrite protection.
MIT ★ 730 updated 2026-10-29
/plugin marketplace add gmickel/flow-next
/plugin install flow-next@flow-nextWhat capture does
This command acts as a trigger for the flow-next-capture skill. It disables direct model invocation and forwards all passed arguments straight to the underlying skill.
The skill performs pre-flight verification: it checks for duplicates, inspects evidence completeness after context compaction, and verifies idempotency. It extracts discussion points, marks sources, triggers a review loop for the generated spec, and writes the output through flowctl spec create --plan-file.
Without flowctl and the flow-next-capture skill available in your environment, spec generation will fail at the write step. Accepted parameters include mode:autofix, spec updates via --rewrite <spec-id>, --from-compacted-ok, and --yes.
What it helps with
- convert current chat context into
.flow/specs/<spec-id>.mdspecification files - overwrite an existing specification using
--rewrite <spec-id> - extract structured evidence from conversation history without manual copy-paste
- review generated specifications before saving them via flowctl
Example prompts for the agent
- /capture
- /capture --rewrite auth-refactor --yes
- /capture mode:autofix --from-compacted-ok
How to install capture
1Plugin marketplace
/plugin marketplace add gmickel/flow-next/plugin install flow-next@flow-next2Manually: put the files in place
.claude/commands/capture.mdCall it with /capture. For all projects use ~/.claude/commands/
Manually: put the files in place
~/.codex/prompts/capture.mdCall it with /prompts:capture. Codex marks this format deprecated in favour of skills
Manually: put the files in place
.github/prompts/capture.prompt.mdManually: put the files in place
.gemini/commands/capture.tomlGemini stores commands as TOML: the prompt text goes into the prompt field
Questions about capture
How to install capture in Claude Code?
Run /plugin marketplace add gmickel/flow-next followed by /plugin install flow-next@flow-next. Alternatively, save the command file directly to .claude/commands/capture.md.
What does the capture command do?
It delegates execution to flow-next-capture, turning conversation details into a source-tagged spec file through flowctl.
Which flags can be passed to capture?
You can supply mode:autofix, specify target replacement via --rewrite <spec-id>, bypass compaction warnings with --from-compacted-ok, or auto-confirm with --yes.
Source text
capture.md · MIT
--- name: capture description: Synthesize the current conversation into a flow-next spec at `.flow/specs/<spec-id>.md` — source-tagged, saved-spec review, no silent overwrite argument-hint: "[mode:autofix] [--rewrite <spec-id>] [--from-compacted-ok] [--yes]" disable-model-invocation: true --- # IMPORTANT: This command MUST invoke the skill `flow-next-capture` The ONLY purpose of this command is to call the `flow-next-capture` skill. You MUST use that skill now. **Arguments:** $ARGUMENTS Pass the arguments to the skill verbatim. The skill handles mode detection (`mode:autofix` token + `--rewrite <id>` + `--from-compacted-ok` + `--yes`), pre-flight checks (duplicate / relevant evidence completeness after compaction / idempotency), conversation evidence extraction, source-tagged synthesis, must-ask cases, saved-spec review loop, and the flowctl `spec create --plan-file` write.
© Gordon Mickel · MIT · gmickel/flow-next