Research and Learning skill 08 of 13
Survey Design SKILL.md
The Survey Design skill makes Claude, Codex or another AI agent design surveys that produce trustworthy numbers. It sets objectives tied to decisions, defines the population and sample size, writes neutral single-idea questions, chooses formats and scales, pilots the survey and reports results with sample sizes and margins of error.
survey-design/SKILL.md, version 1.0.0, 1,501 words.
By Afeez Adebayo, Marketing, SEO & Growth Expert with 10+ years of experience.
Created 10 October 2026. Updated 10 October 2026. Free to use under CC BY 4.0.
Surveys answer "how many" and "how common" questions that interviews cannot: what share of customers want a feature, how satisfaction varies by segment, which problems are most frequent. They are easy to send and easy to get wrong. Leading or double-barrelled questions, unbalanced scales, self-selected samples, long questionnaires that people abandon and results reported without margins of error produce numbers that look precise but mislead.
This skill designs surveys that produce trustworthy data: defining objectives, choosing who to survey and how many, writing clear unbiased questions, choosing answer formats and scales, ordering and testing the questionnaire, maximising responses, analysing results with appropriate caution and reporting findings with sample sizes and limitations.
Operating principles
- Objectives decide every question. If a question does not inform a decision, cut it.
- Right people, enough of them. Who answers matters more than how many.
- Neutral, simple wording. One idea per question, no leading language.
- Short wins. Five to ten minutes keeps completion and quality high.
- Test before sending. Pilot with a few people to catch confusing questions.
- Report with limits. Sample size, who responded and margin of error.
Question writing rules
| Problem | Bad | Better |
|---|---|---|
| Leading | "How much do you love our new dashboard?" | "How satisfied are you with the new dashboard?" |
| Double-barrelled | "Is our product fast and easy to use?" | Two questions: speed, ease of use |
| Vague time | "Do you often use reports?" | "In the last 30 days, how many times did you use reports?" |
| Jargon | "How useful is our NRR dashboard?" | Use plain terms or explain |
| Hypothetical | "Would you pay for feature X?" | Ask about current spend and priority of problems |
| Missing options | Choices that do not cover all answers | Add "other" and "not applicable" |
Answer formats
| Format | Use for | Notes |
|---|---|---|
| Single choice | One answer from a list | Make options mutually exclusive |
| Multiple choice | Several answers | Limit options; randomise order where sensible |
| Rating scale (5 or 7 points) | Satisfaction, agreement, likelihood | Balanced, labelled endpoints |
| Ranking | Priorities | Keep to 5 to 7 items |
| Numeric | Counts, amounts | Give units and ranges |
| Open text | Reasons, ideas | Use sparingly; one or two per survey |
| Net Promoter Score | Likelihood to recommend, 0 to 10 | Add a follow-up "why" question |
Sample size rough guide
For a simple percentage from a random sample, the margin of error at 95% confidence is roughly 1 divided by the square root of the sample size: about ±10% with 100 responses, ±7% with 200, ±5% with 400 and ±3% with 1,000. Self-selected samples can be biased regardless of size, so who responds matters as much as how many.
When to use, and when not to
Use it for customer satisfaction, feature prioritisation, market sizing inputs, employee engagement, event feedback and validating patterns found in interviews.
Don't use surveys to understand why people behave in complex ways (interviews do that better) or when you cannot reach a representative group.
Inputs
- Objectives and decisions the survey informs.
- Target population and how to reach them.
- Hypotheses from interviews or data.
- Tool (Google Forms, Typeform, SurveyMonkey or similar).
- Timeline and incentive budget.
Raw SKILL.md file
This is the exact file agents read, including the credit header and licence notice. Save it as survey-design/SKILL.md.
--- name: survey-design description: "Design surveys that produce trustworthy data: objectives tied to decisions, population and sample size with margins of error, neutral single-idea questions, answer formats and scales, ordering and skip logic, pilots, invitations and reminders, cleaning, segment analysis and reports with limitations. Use whenever someone needs to create a survey or questionnaire, run customer or employee feedback surveys, prioritise features with survey data, calculate sample size or fix leading survey questions." license: CC-BY-4.0 metadata: author: Afeez Adebayo author_url: https://afeezadebayo.com author_linkedin: https://www.linkedin.com/in/afeez-adebayo/ author_x: https://x.com/za_icon source: https://afeezadebayo.com/skills-md/productivity/research-learning/survey-design/ category: productivity subcategory: research-learning version: "1.0.0" created: "2026-10-10" updated: "2026-10-14" --- # Survey Design Surveys answer "how many" and "how common" questions that interviews cannot: what share of customers want a feature, how satisfaction varies by segment, which problems are most frequent. They are easy to send and easy to get wrong. Leading or double-barrelled questions, unbalanced scales, self-selected samples, long questionnaires that people abandon and results reported without margins of error produce numbers that look precise but mislead. This skill designs surveys that produce trustworthy data: defining objectives, choosing who to survey and how many, writing clear unbiased questions, choosing answer formats and scales, ordering and testing the questionnaire, maximising responses, analysing results with appropriate caution and reporting findings with sample sizes and limitations. ## Operating principles 1. **Objectives decide every question.** If a question does not inform a decision, cut it. 2. **Right people, enough of them.** Who answers matters more than how many. 3. **Neutral, simple wording.** One idea per question, no leading language. 4. **Short wins.** Five to ten minutes keeps completion and quality high. 5. **Test before sending.** Pilot with a few people to catch confusing questions. 6. **Report with limits.** Sample size, who responded and margin of error. ## Question writing rules | Problem | Bad | Better | |---|---|---| | Leading | "How much do you love our new dashboard?" | "How satisfied are you with the new dashboard?" | | Double-barrelled | "Is our product fast and easy to use?" | Two questions: speed, ease of use | | Vague time | "Do you often use reports?" | "In the last 30 days, how many times did you use reports?" | | Jargon | "How useful is our NRR dashboard?" | Use plain terms or explain | | Hypothetical | "Would you pay for feature X?" | Ask about current spend and priority of problems | | Missing options | Choices that do not cover all answers | Add "other" and "not applicable" | ## Answer formats | Format | Use for | Notes | |---|---|---| | Single choice | One answer from a list | Make options mutually exclusive | | Multiple choice | Several answers | Limit options; randomise order where sensible | | Rating scale (5 or 7 points) | Satisfaction, agreement, likelihood | Balanced, labelled endpoints | | Ranking | Priorities | Keep to 5 to 7 items | | Numeric | Counts, amounts | Give units and ranges | | Open text | Reasons, ideas | Use sparingly; one or two per survey | | Net Promoter Score | Likelihood to recommend, 0 to 10 | Add a follow-up "why" question | ## Sample size rough guide For a simple percentage from a random sample, the margin of error at 95% confidence is roughly 1 divided by the square root of the sample size: about ±10% with 100 responses, ±7% with 200, ±5% with 400 and ±3% with 1,000. Self-selected samples can be biased regardless of size, so who responds matters as much as how many. ## When to use, and when not to Use it for customer satisfaction, feature prioritisation, market sizing inputs, employee engagement, event feedback and validating patterns found in interviews. Don't use surveys to understand why people behave in complex ways (interviews do that better) or when you cannot reach a representative group. ## Inputs - Objectives and decisions the survey informs. - Target population and how to reach them. - Hypotheses from interviews or data. - Tool (Google Forms, Typeform, SurveyMonkey or similar). - Timeline and incentive budget. ## Workflow ### Step 1. Write objectives Three to five objectives, each linked to a decision. ### Step 2. Define the population and sample Who exactly, how they will be reached, target number of responses, segments needed for comparison. ### Step 3. Draft questions per objective Use the writing rules; one idea per question; plain language. ### Step 4. Choose formats and scales Consistent scales throughout; include "not applicable" where needed. ### Step 5. Order the survey Easy, relevant questions first; sensitive and demographic questions last; group by topic; use logic to skip irrelevant questions. ### Step 6. Pilot Five to ten people complete it while thinking aloud; fix confusion, length and errors. ### Step 7. Send and remind Clear invitation with purpose, time required and privacy; one or two reminders; incentives if appropriate. ### Step 8. Clean and analyse Remove duplicates, speeders and test responses; analyse by segment; report sample sizes and margins. ### Step 9. Report Key findings with numbers, charts, comparisons, open-text themes and limitations. ## Survey invitation template ``` Subject: 5 minutes to help shape <product or service> We're asking <who> about <topic> so we can <decision or improvement>. It takes about 5 minutes and closes on <date>. <Incentive, if any>. Answers are <anonymous / confidential> and used only for <purpose>. <Link> ``` ## Analysis checklist - [ ] Response rate and who responded compared with the target population. - [ ] Results by key segments, with sample sizes shown. - [ ] Margins of error for main percentages. - [ ] Open-text responses coded into themes with counts. - [ ] Differences tested or described cautiously when samples are small. ## Scale design tips - Use the same direction for all scales (for example 1 = very dissatisfied, 5 = very satisfied). - Label every point or at least both ends and the midpoint. - Keep a neutral midpoint unless you deliberately want to force a choice. - Avoid mixing 5-point and 10-point scales in one survey. ## Coding open-text answers Read a sample of 50 to 100 answers, create a short list of themes, then tag every answer with one or more themes and count them. Keep a few verbatim quotes per theme. AI can draft themes and tags quickly; check a sample of its tagging by hand before reporting counts. ## Avoiding survey fatigue Survey each customer group no more than a few times a year, coordinate across teams so people are not asked the same questions twice and share what changed because of their answers, which raises future response rates. Report response rates every time. ## Edge cases and judgement calls | Situation | What to do | |---|---| | Low response rate | Check who answered; weight carefully or report as indicative | | Small segments | Combine or report as directional only | | Sensitive topics | Anonymous surveys; careful wording; data protection | | Customers already over-surveyed | Shorter surveys; fewer sends; use existing data | | Results conflict with interviews | Look for sampling or wording issues; investigate further | | International audiences | Translate and back-translate; adapt examples | ## Handoffs to related skills - Planning: `research-planning` - Interviews to explore first: `expert-user-interviews` - Synthesis: `research-synthesis` - Presenting results: the Communication and Presentations `data-storytelling` skill - Customer feedback programmes: the CRM and Lifecycle skills ## Worked example A product team planned a 40-question survey asking customers which of 15 features they wanted. The redesign set three objectives, cut the survey to 12 questions, replaced "would you use" questions with questions about how often customers faced each problem in the last month and how they solved it, added a ranking of five problems and piloted with eight customers, which removed two confusing questions. With 620 responses (about ±4% margin), the team found two problems far more frequent than the rest and prioritised them, confirming the result with follow-up interviews. ## Common mistakes - Long surveys with no clear objectives. - Leading or double-barrelled questions. - Asking about hypothetical behaviour. - Reporting percentages without sample sizes. - Treating self-selected responses as representative. ## Output format ``` 1. Objectives and decisions 2. Population, sample and margin of error 3. Questionnaire with formats and logic 4. Pilot findings and changes 5. Invitation and reminder plan 6. Analysis plan and report outline ``` ## Self-check before you answer - Does every question map to an objective? - Are questions neutral, single-idea and about real behaviour? - Is the sample appropriate, with margin of error stated? - Was the survey piloted before sending? --- Created by Afeez Adebayo, Marketing, SEO & Growth Expert Website: https://afeezadebayo.com LinkedIn: https://www.linkedin.com/in/afeez-adebayo/ X: https://x.com/za_icon Source: https://afeezadebayo.com/skills-md/productivity/research-learning/survey-design/ Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). You may copy, share and adapt this skill, including for commercial use, as long as you credit Afeez Adebayo and link to the source URL above. Keep this notice in any copy or adapted version.
Workflow
Step 1. Write objectives
Three to five objectives, each linked to a decision.
Step 2. Define the population and sample
Who exactly, how they will be reached, target number of responses, segments needed for comparison.
Step 3. Draft questions per objective
Use the writing rules; one idea per question; plain language.
Step 4. Choose formats and scales
Consistent scales throughout; include "not applicable" where needed.
Step 5. Order the survey
Easy, relevant questions first; sensitive and demographic questions last; group by topic; use logic to skip irrelevant questions.
Step 6. Pilot
Five to ten people complete it while thinking aloud; fix confusion, length and errors.
Step 7. Send and remind
Clear invitation with purpose, time required and privacy; one or two reminders; incentives if appropriate.
Step 8. Clean and analyse
Remove duplicates, speeders and test responses; analyse by segment; report sample sizes and margins.
Step 9. Report
Key findings with numbers, charts, comparisons, open-text themes and limitations.
Survey invitation template
Subject: 5 minutes to help shape <product or service>
We're asking <who> about <topic> so we can <decision or improvement>.
It takes about 5 minutes and closes on <date>.
<Incentive, if any>. Answers are <anonymous / confidential> and used only for <purpose>.
<Link>Analysis checklist
- [ ] Response rate and who responded compared with the target population.
- [ ] Results by key segments, with sample sizes shown.
- [ ] Margins of error for main percentages.
- [ ] Open-text responses coded into themes with counts.
- [ ] Differences tested or described cautiously when samples are small.
Scale design tips
- Use the same direction for all scales (for example 1 = very dissatisfied, 5 = very satisfied).
- Label every point or at least both ends and the midpoint.
- Keep a neutral midpoint unless you deliberately want to force a choice.
- Avoid mixing 5-point and 10-point scales in one survey.
Coding open-text answers
Read a sample of 50 to 100 answers, create a short list of themes, then tag every answer with one or more themes and count them. Keep a few verbatim quotes per theme. AI can draft themes and tags quickly; check a sample of its tagging by hand before reporting counts.
Avoiding survey fatigue
Survey each customer group no more than a few times a year, coordinate across teams so people are not asked the same questions twice and share what changed because of their answers, which raises future response rates.
Report response rates every time.
Edge cases and judgement calls
| Situation | What to do |
|---|---|
| Low response rate | Check who answered; weight carefully or report as indicative |
| Small segments | Combine or report as directional only |
| Sensitive topics | Anonymous surveys; careful wording; data protection |
| Customers already over-surveyed | Shorter surveys; fewer sends; use existing data |
| Results conflict with interviews | Look for sampling or wording issues; investigate further |
| International audiences | Translate and back-translate; adapt examples |
Handoffs to related skills
- Planning:
research-planning - Interviews to explore first:
expert-user-interviews - Synthesis:
research-synthesis - Presenting results: the Communication and Presentations
data-storytellingskill - Customer feedback programmes: the CRM and Lifecycle skills
Worked example
A product team planned a 40-question survey asking customers which of 15 features they wanted. The redesign set three objectives, cut the survey to 12 questions, replaced "would you use" questions with questions about how often customers faced each problem in the last month and how they solved it, added a ranking of five problems and piloted with eight customers, which removed two confusing questions. With 620 responses (about ±4% margin), the team found two problems far more frequent than the rest and prioritised them, confirming the result with follow-up interviews.
Common mistakes
- Long surveys with no clear objectives.
- Leading or double-barrelled questions.
- Asking about hypothetical behaviour.
- Reporting percentages without sample sizes.
- Treating self-selected responses as representative.
Output format
1. Objectives and decisions
2. Population, sample and margin of error
3. Questionnaire with formats and logic
4. Pilot findings and changes
5. Invitation and reminder plan
6. Analysis plan and report outlineSelf-check before you answer
- Does every question map to an objective?
- Are questions neutral, single-idea and about real behaviour?
- Is the sample appropriate, with margin of error stated?
- Was the survey piloted before sending?
On this page
- When to use this skill, and when not to
- Example prompts
- Example output
- What the agent needs from you
- How this skill hands off to related skills
- How to run Survey Design step by step
- Situations this skill handles
- What makes this skill different
- Practical tips from real projects
- Frequently asked questions
- Changelog
When to use this skill, and when not to
Use it for customer satisfaction, feature prioritisation, market inputs, employee engagement and validating interview findings.
Leading questions, long questionnaires and self-selected samples produce precise-looking numbers that mislead.
Example prompts
- “Create a customer survey to prioritise features.”
- “How many responses do I need?”
- “Fix the leading questions in this survey.”
Example output
The skill returns a fixed structure. A shortened example for an imaginary site:
Survey: 40 questions cut to 12 Questions: frequency of real problems, not would-you-use Pilot: 8 customers, 2 questions fixed Responses: 620 (about \u00b14%)
Every question maps to an objective, and results always show sample sizes and limitations.
What the agent needs from you
It needs objectives and decisions, the target population and how to reach them, hypotheses, the tool and timeline.
How this skill hands off to related skills
Survey Design connects to Research Planning, Expert and User Interviews and Research Synthesis in the Research and Learning skills.
How to run Survey Design step by step
- Install the skill as
survey-design/SKILL.md. - Write objectives.
- Define the population and sample.
- Draft questions per objective.
- Choose formats and scales.
- Order the survey.
Situations this skill handles
Survey Design handles these situations:
| Situation | What the skill does |
|---|---|
| Low response rate | Check who answered; weight carefully or report as indicative |
| Small segments | Combine or report as directional only |
| Sensitive topics | Anonymous surveys; careful wording; data protection |
| Customers already over-surveyed | Shorter surveys; fewer sends; use existing data |
| Results conflict with interviews | Look for sampling or wording issues; investigate further |
| International audiences | Translate and back-translate; adapt examples |
What makes this skill different
Most survey templates are question lists. This skill starts from decisions, writes unbiased questions and reports results with their limits.
Practical tips from real projects
- Objectives decide every question.
- Right people, enough of them.
- Neutral, simple wording.
- Short wins.
A worked example: A product team planned a 40-question survey asking customers which of 15 features they wanted. The redesign set three objectives, cut the survey to 12 questions, replaced "would you use" questions with questions about how often customers faced each problem in the last month and how they solved it, added a ranking of five problems and piloted with eight customers, which removed two confusing questions. With 620 responses (about ±4% margin), the team found two problems far more frequent than the rest and prioritised them, confirming the result with follow-up interviews.
Write objectives: Three to five objectives, each linked to a decision. Define the population and sample: Who exactly, how they will be reached, target number of responses, segments needed for comparison. Draft questions per objective: Use the writing rules; one idea per question; plain language.
Choose formats and scales: Consistent scales throughout; include "not applicable" where needed. Order the survey: Easy, relevant questions first; sensitive and demographic questions last; group by topic; use logic to skip irrelevant questions. Pilot: Five to ten people complete it while thinking aloud; fix confusion, length and errors.
Send and remind: Clear invitation with purpose, time required and privacy; one or two reminders; incentives if appropriate. Clean and analyse: Remove duplicates, speeders and test responses; analyse by segment; report sample sizes and margins. Report: Key findings with numbers, charts, comparisons, open-text themes and limitations.
Question writing rules. Leading: bad "How much do you love our new dashboard?"; better "How satisfied are you with the new dashboard?". Double-barrelled: bad "Is our product fast and easy to use?"; better Two questions: speed, ease of use. Vague time: bad "Do you often use reports?"; better "In the last 30 days, how many times did you use reports?". Jargon: bad "How useful is our NRR dashboard?"; better Use plain terms or explain. Hypothetical: bad "Would you pay for feature X?"; better Ask about current spend and priority of problems. Missing options: bad Choices that do not cover all answers; better Add "other" and "not applicable".
Answer formats. Single choice: use for One answer from a list; notes Make options mutually exclusive. Multiple choice: use for Several answers; notes Limit options; randomise order where sensible. Rating scale (5 or 7 points): use for Satisfaction, agreement, likelihood; notes Balanced, labelled endpoints. Ranking: use for Priorities; notes Keep to 5 to 7 items. Numeric: use for Counts, amounts; notes Give units and ranges. Open text: use for Reasons, ideas; notes Use sparingly; one or two per survey. Net Promoter Score: use for Likelihood to recommend, 0 to 10; notes Add a follow-up "why" question.
Sample size rough guide. For a simple percentage from a random sample, the margin of error at 95% confidence is roughly 1 divided by the square root of the sample size: about ±10% with 100 responses, ±7% with 200, ±5% with 400 and ±3% with 1,000. Self-selected samples can be biased regardless of size, so who responds matters as much as how many.
Analysis checklist. Response rate and who responded compared with the target population. Results by key segments, with sample sizes shown. Margins of error for main percentages. Open-text responses coded into themes with counts. Differences tested or described cautiously when samples are small.
Scale design tips. Use the same direction for all scales (for example 1 = very dissatisfied, 5 = very satisfied). Label every point or at least both ends and the midpoint. Keep a neutral midpoint unless you deliberately want to force a choice. Avoid mixing 5-point and 10-point scales in one survey.
Coding open-text answers. Read a sample of 50 to 100 answers, create a short list of themes, then tag every answer with one or more themes and count them. Keep a few verbatim quotes per theme. AI can draft themes and tags quickly; check a sample of its tagging by hand before reporting counts.
Avoiding survey fatigue. Survey each customer group no more than a few times a year, coordinate across teams so people are not asked the same questions twice and share what changed because of their answers, which raises future response rates. Report response rates every time.
Edge cases and judgement calls. Low response rate: what to do Check who answered; weight carefully or report as indicative. Small segments: what to do Combine or report as directional only. Sensitive topics: what to do Anonymous surveys; careful wording; data protection. Customers already over-surveyed: what to do Shorter surveys; fewer sends; use existing data. Results conflict with interviews: what to do Look for sampling or wording issues; investigate further. International audiences: what to do Translate and back-translate; adapt examples.
Frequently asked questions
How many survey responses do I need?
Roughly 100 gives about \u00b110% margin, 400 about \u00b15% and 1,000 about \u00b13% for random samples.
What is a double-barrelled question?
A question asking about two things at once, such as fast and easy to use.
How long should a survey be?
Usually five to ten minutes to keep completion and quality high.
Changelog
- 1.0.0, 10 October 2026: first release.
Use, adapt and share this skill under CC BY 4.0: credit Afeez Adebayo and link to this page.
