umfrage-reportlisted
Install: claude install-skill kayspiegel/survey-insight-skills
# Umfrage-Report
Ziel: Aus einer Umfrage-CSV die **gestellte Frage** faktenbasiert beantworten und
einen **kurzen Report als Markdown** in `reports/` speichern.
Die Frage des Nutzers ist die Anfrage, mit der dieser Skill aufgerufen wurde. Enthält sie einen
Datei-Pfad/Namen, ist das die zu nutzende CSV; sonst automatisch die CSV im Ordner.
## Werkzeug
Alle Zahlen kommen aus dem beigelegten Skript — **niemals Werte schätzen oder aus
Rohdaten „im Kopf" zählen**. Nur Standardbibliothek, kein pandas nötig.
```
python3 scripts/survey.py <cmd> [...] [--file CSV]
```
Aus dem Projekt-Root ausführen. Fehlt `scripts/survey.py`, unter `.claude/scripts/survey.py` nachsehen oder `survey.py` im Projekt suchen.
- `profile` — Überblick: n, alle Spalten mit **Index**, erkanntem Typ (META /
EINFACH / MEHRFACH / FREITEXT), Befüllungsgrad. **Immer zuerst ausführen.**
- `freq COL [--by COL2] [--filter "COL=WERT"] [--top N]` — Häufigkeitsverteilung;
`--by` = Kreuztabelle; `--filter` mehrfach möglich (Teilmenge). Bei MEHRFACH ist
die Summe der Prozente > 100 % (das ist korrekt und im Report so zu erklären).
- `text COL [--filter ...] [--sample N]` — Freitext-Antworten für qualitative Themen.
`COL` = Spaltenindex (aus `profile`) **oder** eindeutiger Teil des Spaltennamens.
Alle Kommandos akzeptieren `--json` für maschinenlesbare Ausgabe.
## Umfrage-Kontext
Liegt neben der CSV ein Kontextdokument (`<name>.context.md`, bei genau einer CSV im Ordner
auch `survey-context.md`), vor dem Sch