Agent skill · nousresearch
decision-questionnaire
Turn an unanswerable decision into a questionnaire doc.
What it needs
About 3k tokens when loaded.
What this skill does
Decision Questionnaire Turns something the user can't answer alone into a questionnaire: a Markdown document they hand to one person to fill in async, or fill out together in a meeting. The recipient holds knowledge the user lacks; the questionnaire pulls it out of them. Ported from mattpocock/skills' MIT-licensed to-questionnaire skill. When to Use A decision blocks on facts or judgment held by someone else (a domain expert, a stakeholder, a vendor contact, ops) The user says "I need to ask X about this" or keeps deferring a decision pending someone else's input Preparing for a meeting where specific answers must come back Do NOT use when the answer is discoverable from the environment (codebase, docs, web) — find it yourself first. Core Principle: Interview the Send, Not the Subject The user cannot answer the subject-matter questions (that's the point), but they can ALWAYS answer questions about the send. Interview them only about that, in two short exchanges: 1. Who is it going to? Role, expertise, relationship to the user. This fixes the questionnaire's tone and how much context it must carry. Done when you know who the recipient is and what they know that the user doesn't. 2. What do you need back? The specific decisions or facts the user can't resolve alone. Done when you have a concrete list of what the user must walk away able to do or decide. Then write the questionnaire: draft questions aimed at the gap between what the recipient knows and what the user needs, following the structure below. Write it to decision-questionnaire-<slug>.md in the current directory (slug from the topic) and report the absolute path. Done when the file exists and every item from step 2 is covered by a question. Document Structure Frame it as a discovery questionnaire: the user lacks context, the recipient holds it. Order questions most-important-first (async means you may only get one pass). Group under ## headings by theme once there are more than a handful. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills nousresearch/decision-questionnaire