Cookbook Audit

Cookbook Audit ist ein offizieller Skill aus Anthropics öffentlichem Repository claude-cookbooks. Die direkte Primärquelle liegt unter https://github.com/anthropics/claude-cookbooks/tree/main/.claude/skills/cookbook-audit. Laut Anbieter prüft der Skill ein angefordertes Cookbook-Notebook anhand eines Rubrums und erstellt eine Bewertung mit konkreten Verbesserungsvorschlägen. Er ist damit eine textbasierte Arbeitsanweisung für einen kompatiblen Claude-Code-Arbeitsablauf, kein unabhängiger Notebook-Validator, kein Zertifikat und keine Garantie für fachlich korrekte Ergebnisse.

Zweck und Ergebnis

Der Skill richtet die Prüfung auf vier Dimensionen aus: narrative Qualität, Codequalität, technische Genauigkeit sowie Handlungsfähigkeit und Verständnis. Das Ergebnis soll eine Zusammenfassung mit einer Gesamtbewertung und zentralen Stärken und Problemen enthalten. Anschließend werden die einzelnen Dimensionen begründet und konkrete Empfehlungen mit Bezug zu Abschnitten oder Zeilen des Notebooks formuliert. Beispiele und Verbesserungsvorschläge machen aus einer allgemeinen Kritik eine überarbeitbare redaktionelle Rückmeldung. Die Bewertung ist ein Review-Artefakt, keine objektive Messung des wissenschaftlichen oder geschäftlichen Nutzens eines Notebooks.

Rubrum und Lernziele

Laut der offiziellen Anleitung soll eine gute Einführung das zu lösende Problem, seine Bedeutung und konkrete Terminal Learning Objectives sowie Enabling Learning Objectives erklären. Voraussetzungen sollen benötigte Kenntnisse, Werkzeuge und eine nachvollziehbare Einrichtung benennen. Im Hauptteil erwartet der Skill eine logische Gliederung, erklärenden Text vor jedem Codeblock und eine Auswertung danach. Eine Schlussfolgerung soll auf die Lernziele zurückführen und nächste Schritte oder weiterführende Ressourcen nennen. Diese Kriterien helfen Autorinnen und Autoren, die Perspektive der Lernenden einzunehmen, statt nur Funktionen oder Bibliotheken aufzuzählen.

Technische und redaktionelle Prüfung

Die Quelle empfiehlt automatisierte Prüfungen mit validate_notebook.py. Dieses Skript erzeugt eine Markdown-Darstellung im temporären Verzeichnis, damit der manuelle Review nicht durch rohe Notebook-Strukturen und Ausgaben erschwert wird. Laut Anbieter berücksichtigt die Prüfung auch die Suche nach hartcodierten Schlüsseln und Zugangsdaten über detect-secrets. Bei der manuellen Bewertung werden unter anderem verständliche Variablennamen, Kommentare mit Begründungen, eine zentrale MODEL-Konstante, aktuelle Modellnamen, reproduzierbare Abhängigkeiten, sinnvolle Ausgaben und der Umgang mit Installationsprotokollen betrachtet. Ein erfolgreiches Skript ersetzt dabei nicht die Sichtprüfung des Inhalts.

Praktischer Ablauf

Übergeben Sie den Pfad zu einem konkreten Notebook und lesen Sie zuerst style_guide.md, weil dort die maßgeblichen Vorlagen und guten oder schlechten Beispiele beschrieben sind. Führen Sie danach die automatisierte Validierung aus und prüfen Sie die erzeugte Markdown-Datei vollständig. Bewerten Sie jede Dimension mit nachvollziehbaren Belegen, kennzeichnen Sie fehlende Voraussetzungen und unterscheiden Sie zwischen einem funktionierenden Beispiel und produktionsreifem Code. Bei Modellaufrufen, externen Daten und persönlichen oder vertraulichen Inhalten müssen Berechtigungen, Datenschutz, Quellenlage und Aufbewahrung vorab geklärt werden. Eine lokale Skill-Datei bedeutet nicht automatisch lokale Verarbeitung, weil ein verbundener Claude-Client Eingaben an seinen Modellanbieter übertragen kann.

E-E-A-T und Grenzen

Dieser Eintrag stützt sich auf die von Anthropic veröffentlichte SKILL.md und die dort benannten Rubriken, Prüfwerkzeuge und Berichtsabschnitte. Das belegt die Herkunft und den dokumentierten Zweck, ersetzt aber keine fachliche Begutachtung eines Notebooks. Ein Sprachmodell kann technische Fehler übersehen, eine Bewertung zu selbstsicher formulieren oder unzuverlässige Notebook-Ausgaben als Beleg behandeln. Prüferinnen und Prüfer sollten Code ausführen, Quellen und Abhängigkeiten kontrollieren, Geheimnisse aus Testdaten entfernen und kritische Empfehlungen selbst nachvollziehen. Der Skill bewertet die Darstellung und die dokumentierten technischen Hinweise; er beweist weder Sicherheit noch wissenschaftliche Validität und übernimmt keine Verantwortung für Entscheidungen, die auf einem Auditbericht beruhen.

Einordnung und Kompatibilität

Cookbook Audit gehört zu Recherche und Datenanalyse, weil es Material systematisch untersucht, Kriterien anwendet und Befunde strukturiert. Die Claude-Code-Kompatibilität folgt aus seiner Veröffentlichung unter .claude/skills im offiziellen Anthropic-Repository. Die tatsächliche Verfügbarkeit hängt von Installation, Client-Version, Richtlinien, Modellzugang und den vorhandenen lokalen Dateien ab. Skill Road speichert keine Zugangsdaten, Tokens oder Notebook-Inhalte. Für eine belastbare Prüfung sollten Sie den Notebook-Pfad, den gewünschten Kontext, die erlaubten Ausführungen und die Grenzen menschlicher Freigabe ausdrücklich festlegen.