decision-sheet
Installation
SKILL.md
Decision sheet
Turns questions with your suggested answers into a page. The user changes only what they disagree with, adds notes where they want, and presses Copy reply. The copied text lists only the changes, the notes and the unanswered questions, so the reply stays short.
Use it instead of a long list in the chat or several rounds of AskUserQuestion. For 1 to 3 quick questions, AskUserQuestion is still better.
Steps
- Write the questions to a JSON file in the scratchpad (format below). Give every question your suggestion, and a short reason in
summary. Leavesuggestedout only when you have no sensible default: the page marks those "needs you". Write for a reader who was not in the conversation (see Writing the questions). - Build the page. It runs with
bunornodeand has no dependencies:
It checks the file and lists every problem with its path, such asbun ${CLAUDE_SKILL_DIR}/scripts/build.mjs questions.json # writes questions.htmlgroups[1].questions[3].suggested: "maybe" is not an option ("Keep", "Drop"). Fix them and run it again. It also warns about labels that are too long (see Options); fix those too, since a long label reads badly in the selector. - Publish the HTML file with the Artifact tool:
icon: "checklist"and a one-sentencedescription. The page is already designed, so publish it as built. If the Artifact tool isn't available, give the user the file's path to open in a browser instead. - Send the link and stop. Tell the user to paste the copied reply into the chat.
- Apply the reply (format below). Then update the record of the decisions, for example the report or plan the questions came from.