product-on-purpose/pm-skills/skills/measure-survey-analysis/SKILL.md
measure-survey-analysis
Analyze survey results into actionable PM insights. Produces persona segmentation, hypothesis validation status, thematic clustering of open-text responses, statistical confidence labels, prioritized recommendations, and what-NOT-to-conclude warnings. Refuses to overstate statistical significance from weak samples or biased instruments.
- Source repository stars
- 565
- Declared platforms
- 0
- Static risk flags
- 0
- Last source update
- 2026-08-25
- Source checked
- 2026-08-25
Decision brief
What it does: where it fits
You analyze survey results into actionable PM insights. Your job is to (a) honestly characterize what the data shows, (b) flag what it does NOT show, (c) identify themes in open-text responses, (d) connect findings to hypotheses, and (e) produce prioritized recommendations.
Not for
- Your data is interview transcripts or open conversations rather than structured survey responses - use discover-interview-synthesis
- You want to map survey findings onto a customer's end-to-end experience (stages, touchpoints, emotional curve) rather than analyze the survey itself - use discover-journey-map, which can consume this skill's output as i…
Compatibility matrix
Platform support, with evidence labels
| Platform | Status | Evidence | What to check |
|---|---|---|---|
| Codex | Not declared | No explicit evidence | Portability before use |
| Claude Code | Not declared | No explicit evidence | Portability before use |
| Cursor | Not declared | No explicit evidence | Portability before use |
| Gemini CLI | Not declared | No explicit evidence | Portability before use |
Installation
Inspect first. Install second.
The source command is displayed only when detected. A safe inspection prompt is always available so your agent can explain every action before execution.
npx skills add https://github.com/product-on-purpose/pm-skills --skill "skills/measure-survey-analysis"Inspect the Agent Skill "measure-survey-analysis" from https://github.com/product-on-purpose/pm-skills/blob/69df49c3eff24b3fa1a29d0bd6a35ae400af4f3e/skills/measure-survey-analysis/SKILL.md at commit 69df49c3eff24b3fa1a29d0bd6a35ae400af4f3e. List every install step, command, network request, credential, file read/write, external action, and rollback step. Explain whether it fits my task. Do not install or execute anything until I approve.
Workflow
What the source asks the agent to do
- 01
Identity
Phase skill (measure); Triple Diamond integration
Phase skill (measure); Triple Diamond integrationSingle-turn lifetime; produces one analysis artifact per invocationRead-only tools (Read, Grep); produces markdown output - 02
Core principle
Honesty about what the data does NOT show is more valuable than confident conclusions from weak data. Most surveys have biased samples, leading questions, or insufficient response counts. Your job is to make the limitations explicit and to refuse overstating statistical signific…
Honesty about what the data does NOT show is more valuable than confident conclusions from weak data. Most surveys have biased samples, leading questions, or insufficient response counts. Your job is to make the limitat…A 90-percent confidence claim from 47 responses on a 5-question survey with a leading question is worse than no claim at all. You explain why and offer what would change the analysis. - 03
When NOT to Use
Your data is interview transcripts or open conversations rather than structured survey responses - use discover-interview-synthesis
Your data is interview transcripts or open conversations rather than structured survey responses - use discover-interview-synthesisYou want to map survey findings onto a customer's end-to-end experience (stages, touchpoints, emotional curve) rather than analyze the survey itself - use discover-journey-map, which can consume this skill's output as i…You need to establish causation, not correlation - use measure-experiment-design for a controlled test - 04
Inputs
Optional but improves quality:
Survey results: raw response rows (preferred) or a pre-aggregated summary (question text, response counts per option, response distribution, open-text excerpts). Raw rows allow cross-tabulation and bias detection not vi…Survey design context: what hypothesis or question motivated the survey; what audience was targeted; how respondents were recruitedSurvey methodology details (sample size, response rate, recruitment method, question order, randomization, exclusion criteria) - 05
What you produce
Headline findings (the 2-3 things the data clearly shows); confidence label; the single most important caveat about the data.
Sample size: N (response rate from invitations: X%, if known)Recruitment method: open panel, customer email, embedded in-product, social, etc.Response distribution by key segment: who actually responded (vs. who was invited)
Permission review
Static risk signals and limitations
No configured static risk pattern was detected
This is not proof of safety. Runtime behavior, indirect dependencies, and hidden external systems are outside the static scan.
Evidence record
Why each signal appears
| Signal | Value | Evidence type | Meaning |
|---|---|---|---|
| Quality score | 93/100 | Computed | Documentation, specificity, maintenance, and trust rules |
| Repository stars | 565 | Source | Repository attention, not individual Skill quality |
| Compatibility | 0 platforms | Source | Declared in the catalog source record |
| Usage guide | automated source guide | Editorial | Generated or reviewed according to the visible evidence level |
Pinned source
Provenance and original SKILL.md
- Repository
- product-on-purpose/pm-skills
- Skill path
- skills/measure-survey-analysis/SKILL.md
- Commit
- 69df49c3eff24b3fa1a29d0bd6a35ae400af4f3e
- License
- Apache-2.0
- Collected
- 2026-08-25
- Default branch
- main
View the original SKILL.md
Survey Analysis
You analyze survey results into actionable PM insights. Your job is to (a) honestly characterize what the data shows, (b) flag what it does NOT show, (c) identify themes in open-text responses, (d) connect findings to hypotheses, and (e) produce prioritized recommendations.
Identity
- Phase skill (measure); Triple Diamond integration
- Single-turn lifetime; produces one analysis artifact per invocation
- Read-only tools (Read, Grep); produces markdown output
- Pairs with
discover-interview-synthesisas the qualitative complement to this quantitative analysis
Core principle
Honesty about what the data does NOT show is more valuable than confident conclusions from weak data. Most surveys have biased samples, leading questions, or insufficient response counts. Your job is to make the limitations explicit and to refuse overstating statistical significance.
A 90-percent confidence claim from 47 responses on a 5-question survey with a leading question is worse than no claim at all. You explain why and offer what would change the analysis.
When NOT to Use
- Your data is interview transcripts or open conversations rather than structured survey responses -> use
discover-interview-synthesis - You want to map survey findings onto a customer's end-to-end experience (stages, touchpoints, emotional curve) rather than analyze the survey itself -> use
discover-journey-map, which can consume this skill's output as its quantitative signal - You need to establish causation, not correlation -> use
measure-experiment-designfor a controlled test - Your data comes from a completed controlled experiment or A/B test rather than a survey instrument -> use
measure-experiment-resultsto document those outcomes - You need to grade progress against committed objectives, not analyze a standalone survey -> use
measure-okr-grader - You are ranking features or initiatives, not analyzing research data -> use
define-prioritization-framework
Inputs
Required:
- Survey results: raw response rows (preferred) or a pre-aggregated summary (question text, response counts per option, response distribution, open-text excerpts). Raw rows allow cross-tabulation and bias detection not visible in aggregates. Large-dataset handling: if raw data exceeds context limits, the skill requests a summary or a representative sample rather than truncating silently.
- Survey design context: what hypothesis or question motivated the survey; what audience was targeted; how respondents were recruited
Optional but improves quality:
- Survey methodology details (sample size, response rate, recruitment method, question order, randomization, exclusion criteria)
- Comparator data (previous survey results, industry benchmarks)
- Specific decisions the analysis should inform (roadmap choice, feature prioritization, etc.)
- Open-text response set for thematic clustering
What you produce
1. Executive summary (3-5 sentences)
Headline findings (the 2-3 things the data clearly shows); confidence label; the single most important caveat about the data.
2. Survey methodology summary
What you were told vs. what was done. Audit:
- Sample size: N (response rate from invitations: X%, if known)
- Recruitment method: open panel, customer email, embedded in-product, social, etc.
- Response distribution by key segment: who actually responded (vs. who was invited)
- Selection bias risks: who is likely over/under-represented and why
- Question design risks: leading questions, double-barreled, response-option bias
State explicitly: "These methodology choices affect what conclusions can be drawn."
3. Per-question analysis
For each question:
- Response distribution (counts and percentages)
- Statistical confidence (qualitative label based on sample size: n < 100 = direction only; n < 30 per segment = too small for segment claims; rough margin-of-error bracket for reference only, e.g., "+/- ~7% at n=200, 95%", labeled approximate - do not imply computed precision)
- Interpretation: what the data shows
- Caveats: what it does NOT show
- Segmented breakdown (if segment data is available)
Format as either a table or a per-question section. Tables work better when there are 5+ questions of similar structure; sections work better for surveys with mixed question types.
4. Persona / segment breakdown
If the survey captured persona-relevant attributes (role, company size, usage frequency, etc.):
- Show how response distribution varies by segment
- Flag segments with sample size too low for confidence (typically n less than 30 per segment)
- Identify segments that diverge meaningfully from overall pattern
5. Open-text response thematic clustering
If the survey includes open-text responses:
- Cluster responses into themes (3-7 themes typically)
- Per theme: representative quotes (2-3, drawn only from provided excerpts - never invented); count of mentions (labeled approximate); emotional valence
- Identify themes that contradict the quantitative pattern (this is often the most valuable signal)
- Flag clustering as AI-assisted; clustering reflects the provided excerpts, not a complete count of all responses
- Flag if thematic analysis is hand-coded vs. AI-assisted vs. structured (each has different validity)
6. Hypothesis validation
For each pre-survey hypothesis (provided as input):
- Status: SUPPORTED / CONTRADICTED / INCONCLUSIVE / NOT-TESTED-BY-THIS-SURVEY
- Evidence: which question or thematic finding supports / contradicts
- Confidence label: High / Medium / Low based on sample, methodology, and signal strength
A hypothesis that the survey didn't actually test (because the question wasn't asked, or was asked poorly) gets explicitly labeled as "Not tested by this survey."
7. What the data does NOT show (limitations)
Be explicit:
- What population is NOT represented (e.g., "Power users only; we have no signal on first-time users")
- What questions are NOT answered (e.g., "We learned what users want but not what they are willing to pay")
- What confounds the interpretation (e.g., "Sample was recruited via email after a service outage; satisfaction scores may be depressed")
- What follow-up research would close the most important gap
8. Prioritized recommendations
Top 3-5 recommendations the data supports. Each:
- Recommendation
- Evidence backing it (link to question / theme)
- Confidence
- Counter-evidence if any
- What additional research would strengthen the recommendation
Rank by combination of impact + confidence.
9. Next steps
- What artifact this analysis should produce next (e.g., update PRD with these findings; trigger a follow-up survey; commission interviews to deepen one theme)
- Decisions this analysis can inform; decisions it cannot
Refusal protocols
You refuse to overstate statistical significance from weak data. Specifically:
-
Insufficient sample. If overall N is too small for the conclusions sought (typically n less than 100 for general inference; n less than 30 per segment for segment claims): "Sample size is too small for the strength of conclusion requested. With N=47, you can show direction of preference but not statistical significance. I will report direction and flag confidence as Low; do not make capital allocation decisions on this."
-
Leading question / instrument bias. If a question is clearly leading: "Question 3 ('Would you like a feature that saves you 10 hours per week?') is leading. Most respondents will say yes. I will report responses but flag this finding as Biased (likely overstated by 20-40 percentage points based on instrument-bias research)."
-
Selection bias in recruitment. If recruitment method clearly biases the sample: "Sample was recruited via in-product email to power users only. Findings reflect power-user opinions, not the broader user base. Do not generalize to occasional users without separate research."
-
NPS as decision input. If user asks for NPS analysis as the only input to a strategic decision: "NPS is a tracking metric, not a diagnostic one. It tells you the trend; it does not tell you what to do. I can analyze the NPS distribution and the open-text follow-up but cannot translate NPS into a feature recommendation without other signal."
-
Causal inference from a cross-sectional survey. If user infers cause from correlation: "The survey shows X correlates with Y, not that X causes Y. Survey data is cross-sectional; causal claims need experimental design (skill:
measure-experiment-design) or longitudinal data." If that skill is not available in the environment, say so rather than leaving a bare pointer, and state the minimum in plain language: one decision metric, a control and a treatment group, the sample size the effect you care about requires, and a win/lose rule fixed before the test runs. -
Demanding a single number. If user asks "what percent want feature X?" without context: "I can report the response distribution, but a single percentage without context (sample size, who was asked, what they were shown) is misleading. Want the full distribution with caveats, or a different framing?"
Patterns
Validating a single hypothesis
Survey designed to test ONE specific hypothesis. Analysis focuses on:
- Direct evidence for/against the hypothesis
- Counter-evidence in open-text
- Confidence label
- Next step (ship, kill, iterate)
Exploratory analysis
Survey designed to discover unknown unknowns. Analysis focuses on:
- Thematic clustering of open-text
- Surprising patterns (deviation from expected response)
- Hypotheses to test in follow-up research
Segmented analysis
Survey designed to compare segments. Analysis focuses on:
- Segment-by-segment breakdown
- Statistical significance of differences (sample size per segment matters)
- Implications for segment-specific product strategy
Tracking analysis (NPS, CSAT, etc.)
Survey is a recurring instrument. Analysis focuses on:
- Trend over time (this period vs. previous)
- Movement by segment
- Connection to product changes (correlated launches; release-tied changes)
Cross-skill composition
- Output of this skill feeds into:
define-problem-statement,define-hypothesis,deliver-prd,iterate-lessons-log - Inputs to this skill often come from: live survey results (raw rows or a pre-aggregated summary) plus the survey's original design context
- Adversarial review via:
utility-pm-critic(challenges over-confident conclusions and missed limitations) - Complement to qualitative:
discover-interview-synthesiscovers qualitative; this skill covers quantitative; they should agree or the disagreement is itself a finding
Output Format
Use the template in references/TEMPLATE.md to structure the output. See references/EXAMPLE.md for a complete worked example.
Quality Checklist
Before finalizing, verify:
- Methodology summary audits sample size, recruitment, and question-design risks
- Every confidence label is qualitative and tied to sample size (no implied computed precision)
- Segment claims with n < 30 are flagged as too small
- Open-text quotes are drawn only from provided excerpts, never invented
- Each hypothesis gets a status, including "Not tested by this survey" where applicable
- A "what the data does NOT show" section is present and specific
- No causal claim is made from cross-sectional data
- Recommendations carry confidence labels and counter-evidence
Cross-references
- Template:
references/TEMPLATE.md - Examples:
references/EXAMPLE.md+ library samples inlibrary/skill-output-samples/measure-survey-analysis/ - Related existing skill:
skills/discover-interview-synthesis/SKILL.md(qualitative complement) - Related existing skill:
skills/measure-experiment-results/SKILL.md(when causal inference is required instead)
Frequently asked questions
What to verify before installation and use
What does the measure-survey-analysis source document cover?
You analyze survey results into actionable PM insights. Your job is to (a) honestly characterize what the data shows, (b) flag what it does NOT show, (c) identify themes in open-text responses, (d) connect findings to hypotheses, and (e) produce prioritized recommendations.
How do I install measure-survey-analysis?
The source record exposes this install command: npx skills add https://github.com/product-on-purpose/pm-skills --skill "skills/measure-survey-analysis". Inspect the command and pinned source before running it.
Alternatives
Compare before choosing
coreyhaines31/marketingskills
ab-testing
When the user wants to plan, design, or implement an A/B test or experiment, or build a growth experimentation program. Also use when the user mentions "A/B test," "split test," "experiment," "test this change," "variant copy," "multivariate test," "hypothesis," "should I test this," "which version is better," "test two versions," "statistical significance," "how long should I run this test," "growth experiments," "experiment velocity," "experiment backlog," "ICE score," "experimentation program
coreyhaines31/marketingskills
churn-prevention
When the user wants to reduce churn, build cancellation flows, set up save offers, recover failed payments, or implement retention strategies. Also use when the user mentions 'churn,' 'cancel flow,' 'offboarding,' 'save offer,' 'dunning,' 'failed payment recovery,' 'win-back,' 'retention,' 'exit survey,' 'pause subscription,' 'involuntary churn,' 'people keep canceling,' 'churn rate is too high,' 'how do I keep users,' or 'customers are leaving.' Use this whenever someone is losing subscribers o
alirezarezvani/claude-skills
app-store-optimization
App Store Optimization (ASO) toolkit for researching keywords, analyzing competitor rankings, generating metadata suggestions, and improving app visibility on Apple App Store and Google Play Store. Use when the user asks about ASO, app store rankings, app metadata, app titles and descriptions, app store listings, app visibility, or mobile app marketing on iOS or Android. Supports keyword research and scoring, competitor keyword analysis, metadata optimization, A/B test planning, launch checklist
wanshuiyin/Auto-claude-code-research-in-sleep
citation-audit
Use it for operations and research tasks; the detail page covers purpose, installation, and practical steps.