CommunitySchreiben & Editierengithub.com

Skript-Review

Startet eine lokale Browserseite, auf der ein Prüfer ein Videoskript Zeile für Zeile durchgeht, kommentiert oder bearbeitt und die Notizen an den Agenten sendet, der die Markdown-Datei überarbeitet.

Was ist Skript-Review?

Dieses Skill ermöglicht einen interaktiven Skript-Review-Prozess direkt im Browser. Ein Prüfer liest jedes Skript (als Markdown-Datei) auf einer lokalen Seite, kann einzelne Zeilen oder ausgewählte Wörter kommentieren, direkt bearbeiten und seine Notizen an den KI-Agenten senden. Der Agent wendet die Änderungen an und aktualisiert die Seite live. Der Workflow umfasst das Erstellen eines Skripts, das Starten der Seite, das Warten auf Notizen und das iterative Anwenden von Änderungen, bis der Prüfer „Sieht gut aus“ signalisiert. Es wird über Python 3.9+ ohne zusätzliche Pakete gesteuert; alle Befehle lauten `python3 scripts/script_review.py <command>`. Unterstützt werden auch Funktionen wie das Anzeigen aller ungelesenen Notizen, das Ändern des Status (z. B. von „entworfen“ auf „fertig“) sowie Tailscale-Integration für den Zugriff vom Telefon aus. Der Agent muss dabei die strengen Regeln zur Bewahrung der Prüfer-Änderungen und minimaler Eingriffe beachten.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/kjmagnan1s/reviewing-scripts/tree/main/skills/reviewing-scripts

Installed? Explore more Schreiben & Editieren skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Skripte prüfen

Jedes Skript ist eine Markdown-Datei. Der Prüfer liest es auf einer lokalen Seite, und seine Notizen kommen als Markdown zu Ihnen zurück. Alle Befehle lauten python3 scripts/script_review.py <befehl>, mit dem Pfad relativ zu diesem Skill-Ordner. Python 3.9 oder höher, keine Pakete müssen installiert werden.

Der Prüfzyklus

  1. Skript speichern. Schreiben Sie den Inhalt in eine temporäre Datei und führen Sie script_review.py new --titel "<titel>" --datei-pfad <datei> --status entworfen aus. Es gibt die ID des Skripts, den Dateipfad und die Seitenadresse aus. Setzen Sie einen Satz oder einen Takt pro Zeile, damit jede Zeile einen eigenen Kommentar erhalten kann.
  2. Seite starten. Führen Sie script_review.py hoch und dann script_review.py öffnen <id> aus. Geben Sie dem Prüfer die Adresse.
  3. Auf Notizen warten. Führen Sie script_review.py warten <id> im Hintergrund aus. Es gibt die Notizen aus, wenn der Prüfer auf Notizen senden klickt, und beendet sich nach zwei Stunden ohne Sendung mit Code 2.
  4. Notizen anwenden. Bearbeiten Sie die Skriptdatei mit der kleinstmöglichen Änderung, die jede Notiz beantwortet. Die offene Seite lädt sich selbst neu und markiert die geänderten Zeilen.
  5. Wiederholen Sie Schritt 3, bis die Notizen „Sieht gut aus“ sagen. Dieses Senden versetzt ein Skript außerdem vom Status „entworfen“ in „fertig“.

Wenn Sie nicht gewartet haben, als Notizen gesendet wurden, gibt script_review.py posteingang alle ungelesenen Sets aus.

Regeln für die Überarbeitung

  • Behalten Sie die Änderungen des Prüfers wortwörtlich bei. Zeilen, die unter „Änderungen (bereits in Datei gespeichert)“ aufgeführt sind, stammen vom Prüfer und sind bereits in der Datei, bevor Sie die Notizen sehen. Ändern Sie sie nur, wenn eine Notiz Sie dazu auffordert.
  • Ändern Sie nur das, was eine Notiz abdeckt. Schreiben Sie keine Zeilen um, die keinen Kommentar haben.
  • Wenden Sie „Änderungen, die nicht landeten“ manuell an. Die Zeile wurde vor dem Senden verschoben, sodass die Datei nicht geändert wurde.
  • Lassen Sie Frontmatter-Schlüssel, die Sie nicht gesetzt haben, unverändert. Ändern Sie den Status mit script_review.py status <id> <status>, nicht durch Bearbeiten der Datei.
  • Löschen Sie keine Skriptdatei, es sei denn, der Prüfer bittet darum.

Das Dateiformat

---
type: script
id: 2026-01-15-drei-eingabe-gewohnheiten
titel: Drei Eingabegewohnheiten
status: entworfen
---

## Gesprochenes Skript

Ihre erste Zeile, ein Satz pro Zeile.
Die zweite Zeile.

## Alternative Einstiege

Einstieg 2 (Frage): Eine zweite Eröffnungszeile zum Filmen.

## Untertitel

Alles andere, was Sie zum Skript behalten.

Vorlesekopie auf der Seite kopiert den Abschnitt „Gesprochenes Skript“ als einen Absatz, dann jeden alternativen Einstieg ab Einstieg 2 als „Zwei. “. Eine Datei ohne Abschnitt „Gesprochenes Skript“ wird komplett vorgelesen. script_review.py lesen <id> gibt denselben Text aus.

Weitere Befehle

  • liste [--status <status>] [--json]: jedes Skript mit seinem Status und der Wortanzahl.
  • status <id> <status>: einen Status setzen (standardmäßig idee, entworfen, bereit, gefilmt, veröffentlicht).
  • konfig: die verwendeten Einstellungen und der Pfad der Konfigurationsdatei.
  • runter: den Seitenserver anhalten.

Einstellungen (Ordner, Port, Abschnittsnamen, Stati, Name des Prüfers) und Telefonzugriff über Tailscale sind in der README im Repository-Stammverzeichnis beschrieben.

Verwandte Skills