survey-design — скилл для Claude Code: что делает и как установить
Помогает составлять нейтральные анкеты, подбирать шкалы оценок и рассчитывать выборку. Пригодится, когда нужно измерить мнения пользователей в цифрах.
npx skills add Owl-Listener/designer-skills --skill survey-design -a claude-codeЧто делает survey-design
Скилл превращает ИИ-агента в исследователя, который помогает формулировать вопросы для количественных опросов без наводящих формулировок и двойных смыслов. Он выстраивает анкету по правилам исследовательской методологии: сначала отсев и демография, затем факты о поведении, после них шкалы удовлетворённости и только в конце — открытые текстовые поля.
Внутри заложены стандарты для шкал Лайкерта на 5 и 7 пунктов, расчёт индекса NPS и правила для опросника юзабилити SUS из 10 вопросов со шкалой от 0 до 100. Для выборки приводится ориентир: около 385 ответов при 95% уровне надёжности и 5% погрешности. Для поведенческих экспериментов этот инструмент не подходит — инструкция прямо направляет к a-b-test-design.
Ограничение опросника — до 5 минут или 10–15 вопросов, иначе падает качество ответов из-за усталости респондентов. Перед запуском навык рекомендует провести пилотное тестирование на 3–5 участниках, чтобы выявить непонятные фразы.
Какие задачи решает
- составить нейтральные вопросы без наводящих формулировок
- выстроить последовательность блоков от демографии к открытым полям
- рассчитать размер выборки под заданную погрешность
- внедрить валидированную шкалу SUS или индекс NPS
Примеры запросов агенту
- Помоги составить опросник на 5 минут для оценки удовлетворённости новым интерфейсом
- Проверь черновик вопросов на двойные формулировки и наводящие слова
- Подготовь стандартную шкалу SUS из 10 пунктов для оценки юзабилити сервиса
Как установить survey-design
1Через Skills CLI (Vercel)
npx skills add Owl-Listener/designer-skills --skill survey-design -a claude-code2Вручную: положить файлы
~/.claude/skills/survey-design/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/survey-design/
1Через Skills CLI (Vercel)
npx skills add Owl-Listener/designer-skills --skill survey-design -a codex2Вручную: положить файлы
.agents/skills/survey-design/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add Owl-Listener/designer-skills --skill survey-design -a cursor2Вручную: положить файлы
.cursor/skills/survey-design/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install Owl-Listener/designer-skills survey-design2Вручную: положить файлы
.github/skills/survey-design/SKILL.md1Через Skills CLI (Vercel)
npx skills add Owl-Listener/designer-skills --skill survey-design -a gemini-cli2Командой платформы
gemini skills install https://github.com/Owl-Listener/designer-skills --path design-research/skills/survey-designВручную: положить файлы
.devin/skills/survey-design/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add Owl-Listener/designer-skills --skill survey-design -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о survey-design
Как установить survey-design в Claude Code?
Выполните в терминале команду npx skills add Owl-Listener/designer-skills --skill survey-design -a claude-code.
Что делает survey-design?
Скилл задаёт методологию составления анкет: помогает выбирать шкалы оценок, убирать предвзятость из формулировок и структурировать порядок вопросов.
Чем survey-design отличается от a-b-test-design?
Этот навык предназначен для измерения мнений и оценок аудитории через анкеты, а для проверки поведения в экспериментах автор рекомендует использовать a-b-test-design.
Исходный текст
SKILL.md · MIT
--- 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 | Type | Use for | Caution | |---|---|---| | Single-choice (radio) | Mutually exclusive options | Ensure options are exhaustive; include "Other" when needed | | Multi-select (checkbox) | Multiple applicable answers | Don't use when you need to rank or when options are mutually exclusive | | Likert scale | Attitudes, agreement, satisfaction | Use consistent scale direction (1=low, 5=high); always use labelled endpoints | | Rating scale (1–10, NPS) | Single-dimension measurement | Specify what each end means | | Ranking | Relative importance between items | Limit to 5–7 items; ranking is cognitively taxing | | Open text | Explanation, unexpected answers | Use 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 ### 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 · Owl-Listener/designer-skills