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

  1. Write the questions to a JSON file in the scratchpad (format below). Give every question your suggestion, and a short reason in summary. Leave suggested out 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).
  2. Build the page. It runs with bun or node and has no dependencies:
    bun ${CLAUDE_SKILL_DIR}/scripts/build.mjs questions.json   # writes questions.html
    
    It checks the file and lists every problem with its path, such as groups[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.
  3. Publish the HTML file with the Artifact tool: icon: "checklist" and a one-sentence description. 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.
  4. Send the link and stop. Tell the user to paste the copied reply into the chat.
  5. Apply the reply (format below). Then update the record of the decisions, for example the report or plan the questions came from.
Installs
1
Repository
svallory/tutor
GitHub Stars
1
First Seen
Oct 13, 2026