hypothese-check
Skill2 starsChanged 3 months agoMITView on GitHub
Prüft eine formulierte Hypothese/These gegen quantitative Umfragedaten (CSV) und urteilt: bestätigt / teilweise bestätigt / widerlegt — inklusive Chi²-Signifikanztest, Effektstärke und Gegenprüfung. Ergebnis als Markdown nach reports/. Nutzen, wenn der Nutzer eine Annahme, These oder Vermutung verifizieren/falsifizieren will. Aufruf mit der Anfrage als Argument, z. B. /hypothese-check <Hypothese>.
In this repository17 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- data-checkSkill
- daten-checkSkill
- decision-briefSkill
- entscheidungsvorlageSkill
- executive-summarySkill
- freitext-themenSkill
- hypothesis-checkSkill
- management-summarySkill
- segment-profileSkill
- segment-profilSkill
- survey-contextSkill
- survey-reportSkill
- umfrage-kontextSkill
- umfrage-reportSkill
- verbatim-themesSkill
The file
Files
Hypothese-Check
Ziel: Eine in der Anfrage des Nutzers formulierte Hypothese wissenschaftlich
sauber gegen die Daten prüfen und ein belegtes, gerichtetes Urteil abgeben — nicht
nur beschreiben, sondern testen. Ergebnis als Markdown in reports/.
Werkzeug (gemeinsamer Analyse-Motor)
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— Spaltenüberblick (Index, Typ, Befüllung). Immer zuerst.freq COL [--by COL2] [--filter "COL=WERT"] [--top N] [--sig]— Verteilung/Kreuztabelle.--sig(nur Einfachauswahl × Einfachauswahl) liefert Chi², p-Wert, Cramérs V und eine Warnung bei zu kleinen erwarteten Zellhäufigkeiten.text COL [--filter ...] [--sample N]— Freitext für qualitative Belege.
COL = Index (aus profile) oder eindeutiger Namensteil. --json für maschinenlesbar.
Umfrage-Kontext
Liegt neben der CSV ein Kontextdokument (<name>.context.md, bei genau einer CSV im Ordner
auch survey-context.md), vor der Prüfung lesen. Darin stehen Gegenstand, Glossar und
Erhebungsdesign; für Einordnung und Begriffe nutzen, nie für Zahlen. Rekrutierungsweg und
der Abschnitt „Wer fehlt" gehören in die Einschränkungen dieses Reports — eine These
kann in der Stichprobe gelten und für genau die Gruppe scheitern, die die Stichprobe nicht
erreicht, und das ist einen Satz wert.
Der Abschnitt Erwartungen verlangt hier besondere Sorgfalt, weil dieser Skill ihm am stärksten ausgesetzt ist:
- Hat der Nutzer keine Hypothese genannt, darfst du eine aus der Erwartungsliste nehmen — dann sagen, welche du gewählt hast und dass sie aus dem Kontextdokument stammt.
- Deckt sich die Hypothese des Nutzers mit einer notierten Erwartung, ändert das nichts daran, wie hart du prüfst. Die Erwartung ist kein Vorab-Beleg, die Gegenprüfung wird nicht milder, und ein Grenzfall-Urteil kippt dadurch nicht.
- Eine widerlegte Erwartung ist ein Ergebnis, kein Misserfolg. Das klar sagen: „Das war so erwartet; die Daten zeigen es nicht." Das ist der wertvollste Report, den dieses Toolkit schreibt.
Gibt es kein solches Dokument, wie bisher prüfen und am Ende einmal auf umfrage-kontext
hinweisen.
Vorgehen
- Hypothese operationalisieren. Zerlege die These in prüfbare Aussagen: Welche Variable(n)? Erwartete Richtung? Welche Vergleichsgruppen? Formuliere sie als testbare Aussage (implizite Nullhypothese: „kein Unterschied / kein Zusammenhang").
- Profilieren und passende Spalten identifizieren.
- Testen — richtungsbewusst.
- Zusammenhang zweier Kategorien →
freq X --by Y --sig: Signifikanz (p) sagt „real oder Zufall?", Cramérs V sagt „wie stark?". Beides zusammen bewerten — ein signifikanter, aber vernachlässigbarer Effekt bestätigt die These praktisch nicht. - Verteilung/Anteil als These →
freqund die behauptete Größenordnung prüfen. - Qualitative These →
text, Themen zählen/belegen.
- Zusammenhang zweier Kategorien →
- Gegenprüfung (aktiv falsifizieren). Suche mindestens eine Auswertung, die der These widersprechen könnte (alternative Erklärung, Störgröße, Teilgruppe, in der es nicht gilt). Ein Researcher versucht, die eigene Hypothese zu widerlegen.
- Urteil fällen: BESTÄTIGT / TEILWEISE BESTÄTIGT / WIDERLEGT / NICHT ENTSCHEIDBAR (z. B. zu kleine Stichprobe, fehlende Variable).
- Report speichern nach
reports/(date +%F+ kebab-Titel, nicht überschreiben) und Kernurteil + Pfad in der Antwort nennen.
Report-Format
# Hypothese-Check: <These in einem Satz>
**Datenbasis:** <Datei> · n = <…> · <Datum>
## Urteil
**BESTÄTIGT / TEILWEISE / WIDERLEGT / NICHT ENTSCHEIDBAR** — 1–2 Sätze Begründung.
## Prüfung
- Operationalisierung: welche Variablen, welche erwartete Richtung.
- Belege mit Zahlen + Test: „Chi²(df)=…, p=…, Cramérs V=… (Effekt: …)".
- Statistische Einordnung in Klartext: ist der Unterschied real und relevant?
## Gegenprüfung
Was wurde getestet, um die These zu widerlegen? Ergebnis.
## Einschränkungen
Stichprobengröße/Teilgruppen, Zellhäufigkeits-Warnungen, Konfundierung, Kausalität
(Korrelation ≠ Kausalität!) sowie die Grenzen des Erhebungsdesigns laut Umfrage-Kontext
(wen die Rekrutierung nicht erreichen konnte).
## Methodik
Genutzte Spalten, Filter, Tests — reproduzierbar in einem Absatz.Regeln
- Signifikanz UND Effektstärke gemeinsam interpretieren; p allein genügt nie.
- Bei der Warnung „erwartete Häufigkeit < 5" das Ergebnis ausdrücklich relativieren.
- Chi² zeigt Zusammenhang, keine Kausalität — nie kausal formulieren ohne Vorbehalt.
- Nur behaupten, was die Ausgaben hergeben. Kleine Teilgruppen (n < ~30) kennzeichnen.
- Die These prüfen, nie für sie argumentieren — auch und gerade dann, wenn im Umfrage-Kontext steht, dass jemand sie erwartet hat.
- Sprache = Sprache der Hypothese (Standard Deutsch). Report knapp halten.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

