hermes

Write a survey questionnaire

Writes an unbiased questionnaire for a stated research aim, with construct mapping, appropriate response scales, skip logic and a pilot checklist. Use before fielding any survey.

context

Survey data is only as good as its questions. The usual failures are well documented in survey methodology: questions with no analysis behind them, double-barrelled or leading wording, unbalanced or unlabelled scales, overlapping answer options, sensitive questions too early, and surveys too long for the audience, which raises drop-out and straight-lining. A good questionnaire starts from the aim, maps every question to something it measures, and is piloted before launch.

task

Write a questionnaire for this aim:

aim

Respondents: . Target median completion time: minutes.

  1. Break the aim into the constructs to measure and, for each, the analysis it will feed. Drop anything that does not feed the aim.
  2. Where an established, validated scale fits a construct, name it and say to check its licence and use its exact wording; do not reproduce or paraphrase it. Otherwise write new items.
  3. Write each item in plain words for this audience: one idea per question, neutral wording, a clear time frame ("in the past 30 days"), and no jargon or double negatives.
  4. Choose the response format per item: single or multiple choice with mutually exclusive, exhaustive options (with "Other (please specify)" or "Not applicable" where they are real answers); fully labelled 5- or 7-point balanced scales; numeric entry with units; or open text, used sparingly.
  5. Order the survey: screening questions, then easy and engaging questions, then the core, then sensitive questions, then demographics (only those the analysis needs). Keep related items together and randomise option order where order could bias answers.
  6. Add skip logic so nobody sees a question that does not apply to them.
  7. Budget the length: roughly 3 to 4 simple closed items per minute and 1 to 2 minutes per open question. If the aim needs more, say which items to cut.
constraints
  • Every item maps to a construct in the construct map. No "nice to know" questions.
  • Avoid leading, loaded, double-barrelled and absolute ("always", "never") wording, and do not ask respondents to predict their own future behaviour unless intention is the construct.
  • Collect the minimum personal data. Flag any item that is sensitive or identifying and suggest a less intrusive version.
  • If the aim is too broad to answer with one survey, or a survey is the wrong method (for example the question is about actual behaviour that logs could measure), say so first and suggest the better method.
output format

Construct map

A table: construct | item IDs | analysis it feeds.

Introduction text

A short invitation stating purpose, time, anonymity or confidentiality, and that participation is voluntary.

Questionnaire

Numbered items (Q1, Q2…) grouped in sections. For each: the question text, the response type, the full list of options or scale labels, and any logic in brackets, for example "[Show if Q3 = Yes]".

Pilot checklist

Checkboxes covering cognitive interviews with 5 to 10 people from the audience, timing, logic testing on every path, item non-response, straight-lining, and open-text quality.

Analysis notes

Estimated completion time, and any item that needs special handling (reverse-scored, multi-select, open coding).

2 required values still a placeholder; the assistant will ask for them.

details

kind
Prompt: a task you run by name to get one finished thing back
domain
Research and science
category
Research methods
level
Intermediate
made for
Researcher / scientist, UX researcher, Product manager, Student
risk
read-only
version
v1.0.0 · experimental
reviewed
2026-10-02
works in
Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Antigravity, OpenCode, Windsurf, Zed, Continue, AGENTS.md, ChatGPT, claude.ai

Edit on GitHubReport a problem

use in

Hodios CLI
npx @hermes-hq/hodios install write-survey-questionnaire --target claude-code
Agent Skills
npx skills add hermes-hq/hodios-dist --skill write-survey-questionnaire -a claude-code
Add the Hodios marketplace (once)
claude plugin marketplace add hermes-hq/hodios-dist
Install the research-science plugin
claude plugin install hodios-research-science@hodios

The plugin brings every entry in this domain at once.

PromptResearch methods

Design a research study

Designs a study from a research question to hypotheses, design, variables, sampling and sample size, a pre-specified analysis plan and threats to validity. Use before collecting any data.

design-research-study
PersonaResearch methods

Research methodologist

Research methodologist who probes study designs for validity threats, matches methods to questions and asks what evidence would change the conclusion. Use as a sparring partner for any study.

research-methodologist
PromptResearch methods

Build a qualitative codebook

Builds a codebook and coding procedure for qualitative data, with definitions, inclusion and exclusion rules, verbatim examples and an inter-rater check. Use before coding interviews or open text.

build-qualitative-codebook
PromptResearch methods

Plan a PhD or long research project timeline

Builds a PhD or multi-year research project timeline with phases, milestones, a chapter and paper plan, buffers and a monthly check-in routine, working back from the end date. For doctoral students.

plan-phd-timeline
PromptResearch methods

Refine a vague topic into a research question

Refines a vague topic into researchable questions using FINER and PICO-style frameworks, with variants by scope, feasibility notes and the literature to check first. For students and researchers.

refine-research-question
PromptResearch methods

Run a reflexive thematic analysis

Runs reflexive thematic analysis on qualitative data through familiarisation, initial codes, candidate themes with quotes, review and definitions. For qualitative researchers.

run-thematic-analysis