AgentStack
SKILL verified Apache-2.0 Self-run

Designing Surveys

skill-liqiongyu-lenny-skills-plus-designing-surveys · by liqiongyu

Design and launch a product survey: brief, questionnaire, analysis plan, launch checklist. See also: conducting-user-interviews (qualitative).

No reviews yet
0 installs
9 views
0.0% view→install

Install

$ agentstack add skill-liqiongyu-lenny-skills-plus-designing-surveys

✓ scanned · ✓ verified — works with Claude Code, Cursor, and more.

Security review

✓ Passed

No 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.

Are you the author of Designing Surveys? Claim this listing to set pricing, connect Stripe payouts, and keep 70% of every sale.
Sign up to claim

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-fit for 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)

  1. 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.
  2. 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.
  3. Scale inconsistency — Mixing 5-point and 7-point scales, or switching anchor labels mid-survey. Pick one scale family and use it consistently throughout.
  4. 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.
  5. 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.

Install and usage instructions live in the source repository linked above.

Reviews

No reviews yet — be the first.

Versions

  • v0.1.0 Imported from the upstream source.