Agent skill

Survey Design

by Owl-Listener in Owl-Listener/designer-skills

Design unbiased survey instruments — question wording, scales, and sampling — to measure attitudes at scale.

MITAuto-check passedSales & Support

Install Survey Design

skills CLI
$ npx skills add Owl-Listener/designer-skills --skill survey-design -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Owl-Listener/designer-skills survey-design --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Owl-Listener/designer-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/design-research/skills/survey-design .claude/skills/survey-design && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
survey-design
GitHub stars
2.9k
Used in
1 other repo
Token cost
~1.4k tokens
SKILL.md length
719 words
Files
1
Skills in repo
107
Repo updated
First seen
Licence
MIT

At a glance

Design unbiased survey instruments — question wording, scales, and sampling — to measure attitudes at scale.

  • Works in 4 steps: Screen and demographic questions (if… → Behavioral questions (what users do) —… → Attitudinal/satisfaction questions —… → …
  • You need quantitative breadth
  • SKILL.md covers What You Do, When to Use Surveys, Survey Structure and Question Types, plus 5 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Survey Design is an agent skill from Owl-Listener/designer-skills. Design unbiased survey instruments — question wording, scales, and sampling — to measure attitudes at scale. Use when you need quantitative breadth. For behavioural experiments, use a-b-test-design (prototyping-testing).

Its SKILL.md is about 1.4k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Sales & Support, covering Prototyping and A/B testing. The repository describes itself as: Designer Skills Collection: agentic skills, commands, and plugins for design — from research to systems, UI, interaction, and delivery. The licence is MIT.

When your agent uses it

  • You need quantitative breadth
  • Tasks that involve Prototyping
  • Tasks that involve A/B testing

Example prompts

  • “/survey-design”

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Screen and demographic questions (if needed) — short, at the start
  2. Behavioral questions (what users do) — before attitudinal questions
  3. Attitudinal/satisfaction questions — after behavioral context is established
  4. Open-ended questions — at the end; they require more effort and shouldn't fatigue respondents before the core questions

What it can do on your machine

Read from SKILL.md and the folder at commit 9a6930c. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Survey Design loads about 1.4k tokens when it runs. Until then it costs about 59 tokens; SKILL.md has 719 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~59
When it runs · the whole SKILL.md, loaded when a task matches
~1.4k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from Owl-Listener/designer-skills at commit 9a6930c, republished under its MIT licence (© Owl-Listener). 719 words, ~1,377 tokens.

Download SKILL.mdSave it as .claude/skills/survey-design/SKILL.md (or your agent's skills folder).
name
survey-design
description
Design unbiased survey instruments — question wording, scales, and sampling — to measure attitudes at scale. Use when you need quantitative breadth. For behavioural experiments, use `a-b-test-design` (prototyping-testing).

Survey Design

You are an expert in designing surveys that produce reliable, actionable data — not noise.

What You Do

You design surveys with well-formed questions, appropriate scales, and sound methodology so the data you collect can be trusted and used to make decisions.

When to Use Surveys

Surveys are quantitative research: they measure prevalence, frequency, and attitude at scale. Use them when:

  • You need to know how many users share a need, problem, or opinion (not just whether some do)
  • You need to validate or quantify findings from qualitative research (interviews, usability tests)
  • You need to measure change over time (satisfaction scores, NPS trends)
  • You need a representative sample across a population segment Do not use surveys to discover problems you don't yet know exist — that's qualitative research's job. Surveys confirm and quantify; interviews explore and reveal.

Survey Structure

Introduction
  • State the purpose: "We're improving [X] and want to hear your experience."
  • State the time required: "This takes about 3 minutes."
  • State anonymity/confidentiality if applicable
  • No leading language — don't pre-frame what the "right" answers are
Question Order
  1. Screen and demographic questions (if needed) — short, at the start
  2. Behavioral questions (what users do) — before attitudinal questions
  3. Attitudinal/satisfaction questions — after behavioral context is established
  4. Open-ended questions — at the end; they require more effort and shouldn't fatigue respondents before the core questions
Closing
  • Thank participants
  • Provide a path to learn more or be contacted for follow-up (optional)

Question Types

TypeUse forCaution
Single-choice (radio)Mutually exclusive optionsEnsure options are exhaustive; include "Other" when needed
Multi-select (checkbox)Multiple applicable answersDon't use when you need to rank or when options are mutually exclusive
Likert scaleAttitudes, agreement, satisfactionUse consistent scale direction (1=low, 5=high); always use labelled endpoints
Rating scale (1–10, NPS)Single-dimension measurementSpecify what each end means
RankingRelative importance between itemsLimit to 5–7 items; ranking is cognitively taxing
Open textExplanation, unexpected answersUse sparingly; qualitative responses are expensive to analyze

Question Writing

Avoid these patterns:
  • Leading questions: "How much do you enjoy using our product?" → "How would you describe your experience using our product?"
  • Double-barreled questions: "How easy and enjoyable is checkout?" → Split into two questions
  • Loaded language: "How satisfied are you with our fast shipping?" → Remove "fast"
  • Recall overload: "In the past 12 months, how many times…" → Shorter recall periods are more accurate
  • Jargon: Use the same terms users use, not internal product names
Do these instead:
  • One question per question
  • Specific, behaviorally grounded language
  • Mutually exclusive and collectively exhaustive response options
  • Neutral phrasing that doesn't suggest a preferred answer

Scales

Show full SKILL.md (290 more words)Show less
Likert Scales
  • 5-point and 7-point are both defensible; 5-point is easier for respondents
  • Always include a midpoint — don't force binary responses unless the question is genuinely binary
  • Always label endpoints: "1 = Strongly disagree, 5 = Strongly agree"
  • Be consistent with scale direction across the entire survey
Net Promoter Score (NPS)
  • 0–10 scale; "How likely are you to recommend [product] to a friend or colleague?"
  • Promoters: 9–10; Passives: 7–8; Detractors: 0–6; NPS = %Promoters − %Detractors
  • NPS is a single, comparable metric — don't use it as a complete satisfaction measure
System Usability Scale (SUS)
  • Validated 10-question scale for perceived usability
  • Score 0–100 (68 is the average; above 80 is considered good)
  • Use verbatim — don't modify the questions

Sampling

  • Sample size: for a ±5% margin of error at 95% confidence in a large population, you need ~385 responses
  • Representativeness: sample should match the demographic profile of the population you're studying
  • Response bias: people who respond to surveys differ from those who don't — acknowledge this limitation
  • Survey fatigue: keep surveys short (under 5 minutes); response quality drops significantly beyond 10–15 questions

Analyzing Results

  • Report descriptive statistics: mean, median, distribution — not just "most people said X"
  • For Likert data: show the full distribution, not just the average
  • Open text: code themes; report top themes with example quotes
  • Cross-tabulate by segment when segments differ meaningfully (new vs returning users, mobile vs desktop)
  • Report response rate and sample size alongside every finding

Best Practices

  • Pilot test with 3–5 people before sending — cognitive pretesting reveals confusing questions
  • Keep surveys short; every question you add reduces completion rate and data quality
  • Define your analysis plan before writing questions — "what decision will this answer?" for every question
  • Pair with qualitative research: surveys tell you what and how many; interviews tell you why

© Owl-Listener, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in design-research/skills/survey-design of Owl-Listener/designer-skills.

Open the folder on GitHubat commit 9a6930c

Used in 1 other repository

We found 2 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in Owl-Listener/designer-skills, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Survey Design next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Survey Design compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Survey Design this skillOwl-Listener/designer-skills2.9k1 repos~1.4kAutomated safety check: PassMIT
Design Sprintwondelai/skills2.4k—~3.8kAutomated safety check: PassMIT
Loki Modedavila7/claude-code-templates33k7 repos~7.1kAutomated safety check: WarnMIT
Messaging Ab Testergooseworks-ai/goose-skills1.2k1 repos~2.3kAutomated safety check: PassMIT
Measure Survey Analysisproduct-on-purpose/pm-skills716—~3.1kAutomated safety check: PassApache-2.0
Sales Engineerborghei/Claude-Skills891—~4.3kAutomated safety check: PassMIT

Similar skills

  • Design Sprint

    wondelai/skills

    Run a structured 5-day process to prototype, test, and validate product ideas with real users.

    2.4k GitHub stars~3.8k tokensUpdated 1 mo ago
    Product & Project ManagementAuto-check passed
  • Loki Mode

    davila7/claude-code-templates

    Multi-agent autonomous startup system for Claude Code. An agent skill from davila7/claude-code-templates.

    33k GitHub starsUsed in 7 repos~7.1k tokens
    Sales & SupportAuto-check: warnings
  • Messaging Ab Tester

    gooseworks-ai/goose-skills

    Generate 3-5 messaging variants for a value proposition, design structured A/B tests, and analyze results to determine which framing resonates most with ICP.

    1.2k GitHub starsUsed in 1 repo~2.3k tokens
    Sales & SupportAuto-check passed
  • Measure Survey Analysis

    product-on-purpose/pm-skills

    Analyze survey results into actionable PM insights. An agent skill from product-on-purpose/pm-skills.

    716 GitHub stars~3.1k tokensUpdated 2 days ago
    Sales & SupportAuto-check passed
  • Sales Engineer

    borghei/Claude-Skills

    Analyzes RFP responses for coverage gaps, builds competitive feature matrices, and plans proof-of-concept engagements for pre-sales engineering

    891 GitHub stars~4.3k tokensUpdated 3 days ago
    Sales & SupportAuto-check passed
  • Sales Engineer

    borghei/Claude-Skills

    Technical sales engineering: demos, solution design, RFP responses, and POC management.

    891 GitHub stars~3.9k tokensUpdated 3 days ago
    Sales & SupportAuto-check passed

More from Owl-Listener/designer-skills

All 107 skills in this repo
  • A B Test Design

    Owl-Listener/designer-skills

    Design an A/B experiment — hypothesis, variants, primary metric, and sample size.

    2.9k GitHub starsUsed in 1 repo~472 tokens
    Auto-check passed
  • Accessibility Test Plan

    Owl-Listener/designer-skills

    Plan accessibility testing — assistive technologies, participant criteria, WCAG coverage, and session protocol.

    2.9k GitHub starsUsed in 1 repo~478 tokens
    Auto-check passed
  • Aesthetic Usability

    Owl-Listener/designer-skills

    Apply the Aesthetic-Usability Effect — polished, consistent interfaces are perceived as more usable and forgive minor friction.

    2.9k GitHub starsUsed in 1 repo~678 tokens
    Auto-check passed
  • Affinity Diagram

    Owl-Listener/designer-skills

    Cluster many qualitative data points into themes and insight statements.

    2.9k GitHub starsUsed in 1 repo~520 tokens
    Auto-check passed
  • Animation Principles

    Owl-Listener/designer-skills

    Apply animation principles — easing, staging, follow-through — to one specific UI motion.

    2.9k GitHub starsUsed in 1 repo~492 tokens
    Auto-check passed
  • Business Design

    Owl-Listener/designer-skills

    Read financials, map competitive landscapes, and argue design decisions in the language of value.

    2.9k GitHub starsUsed in 1 repo~1.1k tokens
    Auto-check passed

Questions about Survey Design

What does Survey Design do?

Design unbiased survey instruments — question wording, scales, and sampling — to measure attitudes at scale. Survey Design is an agent skill from Owl-Listener/designer-skills. Design unbiased survey instruments — question wording, scales, and sampling — to measure attitudes at scale.

When should I use Survey Design?

Survey Design fits situations like: you need quantitative breadth; tasks that involve Prototyping; tasks that involve A/B testing.

How do I install Survey Design in Claude Code?

Run `npx skills add Owl-Listener/designer-skills --skill survey-design -a claude-code`. Or copy the skill folder (design-research/skills/survey-design in Owl-Listener/designer-skills) into .claude/skills/survey-design in your project. Claude Code loads it when a task matches its description.

How do I install Survey Design in Codex?

Run `npx skills add Owl-Listener/designer-skills --skill survey-design -a codex`. Or copy the skill folder (design-research/skills/survey-design in Owl-Listener/designer-skills) into .agents/skills/survey-design in your project. Codex loads it when a task matches its description.

Can I use Survey Design in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Owl-Listener/designer-skills --skill survey-design -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/survey-design, .gemini/skills/survey-design, .github/skills/survey-design and .opencode/skills/survey-design in your project.

What does Survey Design need to run?

SKILL.md names no scripts, command-line tools or credentials: Survey Design is instructions for the agent only.

Does Survey Design access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Survey Design safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Survey Design use?

Survey Design is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Survey Design use?

About 1.4k tokens (SKILL.md is roughly 5.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Survey Design?

Skills that share tags, products or a category with Survey Design: Design Sprint (wondelai/skills, 2.4k stars), Loki Mode (davila7/claude-code-templates, 33k stars), Messaging Ab Tester (gooseworks-ai/goose-skills, 1.2k stars) and Measure Survey Analysis (product-on-purpose/pm-skills, 716 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Survey Design?

Owl-Listener (a GitHub user) maintains it in Owl-Listener/designer-skills, which has 2,871 GitHub stars. The repository holds 107 skills in this directory. The repository was last updated on September 5, 2026.

Source: Owl-Listener/designer-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.