Edit

Open content in VS Code for the user to review and edit before proceeding.

Workflow

New content (stdin mode)

Draft the content for the user's request, then pipe it to the edit script:

bash

printf '%s' '<content>' | bun ${CLAUDE_SKILL_ROOT}/scripts/edit.ts --ext <ext>

The script opens VS Code with --wait, blocks until the tab is closed, then prints the edited content to stdout. Use the returned content for the next step (MCP call, file write, commit message, etc.).

Existing files

Pass the file path directly:

bash

bun ${CLAUDE_SKILL_ROOT}/scripts/edit.ts <file>

VS Code opens the file with --wait. The user edits and closes the tab. No stdout — the file is modified in place.

Content Formatting

For multi-field content (issues, PRs, specs), use YAML front matter for structured fields and the body for prose. Parse the front matter from stdout to extract fields for API requests.

Flags

Flag	Default	Purpose
`--ext <ext>`	`md`	File extension for temp files (determines VS Code syntax highlighting)
`--no-wait`	off	Open without blocking (fire-and-forget)