Install
$ agentstack add skill-liqiongyu-lenny-skills-plus-designing-surveys ✓ scanned · ✓ verified — works with Claude Code, Cursor, and more.
Security review
✓ PassedNo issues found. Passed automated security review. · v0.1.0 How review works →
- ✓ Prompt-injection patterns
- ✓ Secret / credential exfiltration
- ✓ Dangerous shell & filesystem operations
- ✓ Untrusted network calls
- ✓ Known-malicious package signatures
What it can access
- ✓ Network access No
- ✓ Filesystem access No
- ✓ Shell / process execution No
- ✓ Environment & secrets No
- ✓ Dynamic code execution No
From automated source analysis of v0.1.0. “Used” means the capability is present in the source — more access means more to trust, not that it’s unsafe.
About
Designing Surveys
Scope
Covers
- Designing product surveys that answer a specific decision (not “general feedback”)
- Choosing the right audience, sampling, and timing (including “best customers” cohorts)
- Writing clear, unbiased questions and using good scales (CSAT vs NPS guidance)
- Building an instrument that works on mobile (logic, required fields, option visibility)
- Planning analysis and turning results into decisions and follow-ups
When to use
- “Design a customer survey for…”
- “Create an onboarding survey to profile users / separate buyer vs user.”
- “We need a CSAT/NPS/PMF survey.”
- “Draft a cancellation / churn survey.”
- “Help me write survey questions and an analysis plan.”
When NOT to use
- You need deep “why” stories and behavioral context (use
conducting-user-interviews); surveys capture what/how-much, not rich narratives - You already have feedback data to analyze (use
analyzing-user-feedback); this skill designs new collection instruments, not synthesis - You need to measure causal impact of a change (use an experiment/A/B test, not a survey)
- You need task-based usability evaluation of a flow or prototype (use
usability-testing) - You need a holistic PMF assessment beyond the survey instrument itself (use
measuring-product-market-fitfor the full framework) - Your reachable sample is extremely small (n ”).
2) Define the audience + sampling plan (who, when, how many)
- Inputs: Context snapshot.
- Actions: Choose primary segment(s) and a sampling frame. Prefer behavior/recency-based cohorts (e.g., “signed up 3–6 months ago and active”) when you need accurate recall.
- Outputs: Sampling plan (in brief) + segment cuts.
- Checks: You can explain why each segment is included and what decision it informs.
3) Choose the measurement design (metrics, scales, prioritization)
- Inputs: Survey goal + audience.
- Actions: Pick the core metric(s) (often CSAT); add 1–2 diagnostic questions that force prioritization (e.g., “pick top 3 barriers”) and frequency/impact weighting.
- Outputs: Measurement plan (metric + diagnostics) + draft question list.
- Checks: Every question maps to a decision, hypothesis, or segment cut; no “nice-to-have” questions.
4) Draft the questionnaire (sections, wording, and logic)
- Inputs: Measurement plan; templates.
- Actions: Write questions using neutral wording, single concepts per question, and consistent scales. Add segmentation/profile questions only if you will use them in analysis.
- Outputs: Questionnaire with question IDs, response types, options, and skip logic notes.
- Checks: No double-barreled or leading questions; completion time target ≤ 3–6 minutes for most surveys.
5) Build the instrument table + QA it (mobile + bias)
- Inputs: Questionnaire draft.
- Actions: Convert to an instrument table for implementation (IDs, types, options, required, logic). Check mobile rendering (all scale points visible) and option order/randomization.
- Outputs: Survey instrument table + QA checklist items.
- Checks: Scale labels are unambiguous; required questions are minimal; “Other (free text)” exists when appropriate.
6) Plan the launch (pilot, comms, monitoring, follow-ups)
- Inputs: Instrument + sampling plan.
- Actions: Define pilot (small n), launch dates, reminders, incentives, and a monitoring plan. If the goal is message validation, consider a behavioral “survey” via ad/landing tests instead of asking opinions.
- Outputs: Launch plan + monitoring metrics (response rate, drop-off, segment mix).
- Checks: You have a plan for low response rate and for closing the loop with respondents.
7) Analysis + report plan + quality gate
- Inputs: Final instrument + goals.
- Actions: Define how you’ll analyze (segments, cuts, coding of open-ended), the decision thresholds, and how results will be communicated. Run [references/CHECKLISTS.md](references/CHECKLISTS.md) and score [references/RUBRIC.md](references/RUBRIC.md). Add Risks/Open questions/Next steps.
- Outputs: Final Survey Pack.
- Checks: A stakeholder can review async and decide “ship / adjust / investigate” without another meeting.
Quality gate (required)
- Use [references/CHECKLISTS.md](references/CHECKLISTS.md) and [references/RUBRIC.md](references/RUBRIC.md).
- Always include: Risks, Open questions, Next steps.
Anti-patterns (common failure modes)
- Kitchen-sink questionnaire — Adding “nice-to-have” questions until the survey takes 15+ minutes. Every question must map to a decision or segment cut; if you can't name the action it drives, cut it.
- Double-barreled questions — “How satisfied are you with our pricing and support?” asks two things at once. Split into separate items or the response is uninterpretable.
- Scale inconsistency — Mixing 5-point and 7-point scales, or switching anchor labels mid-survey. Pick one scale family and use it consistently throughout.
- Survivorship-biased sampling — Sending a satisfaction survey only to active users and concluding “users love us.” Include churned/inactive segments or explicitly note the bias in the analysis plan.
- No analysis plan before launch — Designing questions without knowing how you'll cut and interpret the data. Define segment cuts, decision thresholds, and coding rules for open-ends before finalizing the instrument.
Examples
Example 1 (Onboarding): “Design an onboarding survey to identify the buyer vs user and route leads appropriately.” Expected: short profiling questions (3-4 screens), clear segmentation fields, and a follow-up plan to avoid irrelevant outreach.
Example 2 (Product friction): “Design a CSAT survey to find the top 3 productivity blockers for active users and how often they occur.” Expected: CSAT + forced-ranking diagnostics + frequency weighting, plus an analysis plan that yields a ranked backlog of issues.
Boundary example (redirect to conducting-user-interviews): “We want to understand why enterprise buyers chose us over competitors — deep stories.” Response: redirect to conducting-user-interviews for rich narrative elicitation; a survey can quantify the themes afterward but won't surface the stories.
Boundary example (redirect to analyzing-user-feedback): “We already ran a CSAT survey last quarter. Help us make sense of the open-ended responses.” Response: redirect to analyzing-user-feedback; this skill designs new instruments, not analyzes existing data.
Boundary example (causality): “We want to know if feature X caused retention to improve — send a survey.” Response: push back; recommend experiment/instrumentation for causality, and use a survey only for qualitative context (or run interviews).
Source & license
This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.
- Author: liqiongyu
- Source: liqiongyu/lennyskills_plus
- License: Apache-2.0
Install and usage instructions live in the source repository linked above.
Reviews
No reviews yet — be the first.
Write a review
Versions
- v0.1.0 Imported from the upstream source.