MKD (mkd) — Make Decision

MKD is a local decision-deck CLI the AI invokes mid-conversation. It renders a browser page where the user works through a deck of items one screen at a time (Slack Catch-Up style): decisions with justified options, questions with controls, report sections to react to, and answerable tables. The default flow is non-blocking copy-paste: the CLI opens the page and exits; the user answers whenever they want and pastes the Result JSON into the chat. That JSON is the execution contract — the AI executes exactly what it says.

This skill needs no install step: there is no compiled binary and nothing added to PATH. The AI runs the CLI from the skill directory with Bun. All output (rendered decks, results, images) lands under ~/.mkd/ — never the cwd — so running it inside any repo leaves zero footprint there.

Running it (no install)

bun "<skill-dir>/cli/index.ts" <specPath> [--wait] [--no-open] [--port <n>] [--timeout <min>]

<skill-dir> is this skill's install directory:

• project-level: <repo>/.claude/skills/mkd
• user-level: ~/.claude/skills/mkd

Bun runs TypeScript directly; cold start is negligible. If Bun is missing, tell the user to install it (curl -fsSL https://bun.sh/install | bash) — do not substitute Node.