survey-thematic-analyzer
The qualitative-analysis skill. Closed-form survey data is easy to analyze; open-text responses are where the real signal lives but the analysis cost has historically been prohibitive.
When to use
- Developer experience survey (annual / pulse).
- Copilot rollout retro responses.
- Post-incident "what would have helped" survey.
- Conference attendee feedback.
When NOT to use
- Closed-form (yes/no, Likert) responses → standard quantitative tools.
- Interviews → different methodology; use a transcript-specific tool.
Workflow
- Read responses: structured list of
{respondent_id, role, response_text}. - Cluster by theme using NLP grouping or LLM-driven cluster identification.
- For each theme: label, count, 2-3 verbatim representative quotes (with respondent context).
- Surface outliers: responses that don't cluster — sometimes the most informative.
- Cross-reference vault: do any themes connect to known objections, decisions, or open questions?
- Persist the analysis — after presenting it in chat, write the full analysis via
vault-writer.write_insighttovault/insights/YYYY-MM-DD-survey-analysis-{slug}.mdso themes stay queryable across survey cycles.
Output structure
# Survey Analysis — {survey name}
## Sample
- N responses
- Roles distribution: ...
## Themes
### Theme 1: {label} (N responses, X%)
- Representative quotes:
- "{quote}" — {role}
- Vault connection: [[wikilink if applicable]]
### Outliers worth surfacing
- {quote} — {why it's worth noting}
Lands at vault/insights/YYYY-MM-DD-survey-analysis-{slug}.md, written via vault-writer.write_insight (workflow step 6).
Acceptance test
SKILL.md describes the workflow. Live exercise deferred to first actual survey input.