survey-design-basics

Installation
SKILL.md

Survey Design Basics Skill

Surveys fail at design time, invisibly: the leading question ("How much do you love our new feature?"), the double-barrel ("Is the product fast and reliable?" — which one?), the scale with no honest exit (forced positivity), and the twenty-minute questionnaire that only the delighted and the furious complete. By the time results arrive, the damage is unfixable — the data measures the questionnaire, not the population. Design discipline is cheap and front-loaded: neutral wording, one question per question, scales with real options, brutal length editing, a pilot, and the analysis plan written before launch — because a question you don't know how you'll analyze is a question you shouldn't ask.

What This Skill Produces

  • The question set — each question bias-checked and single-barreled, mapped to the decision it informs
  • The scale choices — response options with the reasoning (and the don't-know/NA exits that keep answers honest)
  • The length edit — the cut list, with the completion-rate logic
  • The pilot + analysis plan — five test-takers before launch, and the how-each-question-gets-analyzed table written first

Required Inputs

Ask for these if not provided:

  • The decision the survey feeds — what will be done differently based on results; questions that inform no decision get cut first (kpi-tracker-design so-what logic)
  • The audience and reach method — who gets it, how, and the response-rate reality (the selection caveat gets written into the analysis plan now, not discovered later)
  • The draft questions, if any — existing drafts get the bias audit; the classic sins are findable and fixable
  • Prior interview themes — surveys size what interviews surfaced (interview-synthesis hands off here); a survey inventing its own hypotheses mid-questionnaire does both jobs badly
Installs
1
GitHub Stars
1.5K
First Seen
13 days ago