survey-reportlisted

Answers a question about quantitative survey data from a CSV and writes a short, evidence-backed report as Markdown to reports/. Works with any survey CSV (column types are auto-detected). Invoke with your request as the argument, e.g. /survey-report <your question>. Use when the user wants an analysis, numbers, a count, a cross-tab, or a claim checked on survey data.
kayspiegel/survey-insight-skills · ★ 2 · Data & Documents · score 76

Install: claude install-skill kayspiegel/survey-insight-skills

# Survey Report Goal: Answer the **question** the user asked from a survey CSV with facts, and save a **short report as Markdown** to `reports/`. The user's question is the request they made when invoking this skill. If it contains a file path/name, use that CSV; otherwise use the CSV in the current folder. ## Tool All numbers come from the shared engine — **never estimate or count "in your head".** Standard library only, no pandas required. ``` python3 scripts/survey.py <cmd> [...] [--file CSV] ``` Run these from the project root. If `scripts/survey.py` is not there, check `.claude/scripts/survey.py` or locate `survey.py` in the project. - `profile` — overview: n, every column with **index**, detected type (META / SINGLE / MULTI / FREETEXT), fill rate. **Always run first.** - `freq COL [--by COL2] [--filter "COL=VALUE"] [--top N]` — frequency distribution; `--by` = cross-tab; `--filter` repeatable (subset). For MULTI columns the percentages sum to > 100% (correct — explain it in the report). - `text COL [--filter ...] [--sample N]` — free-text answers for qualitative themes. `COL` = column index (from `profile`) **or** an unambiguous part of the column name. Every command accepts `--json` for machine-readable output. ## Survey context If a context document sits next to the CSV (`<name>.context.md`, or `survey-context.md` when the folder holds exactly one CSV), read it before writing. It carries the subject, the glossary, the audience and the study design. Use