CommunityRédaction et éditiongithub.com

reviewing-scripts

Lance une page navigateur locale pour relire un script vidéo ligne par ligne, commenter, éditer et renvoyer les notes à l'agent, qui met à jour le fichier Markdown.

Qu'est-ce que reviewing-scripts ?

Cette compétence permet à un agent IA de soumettre un script vidéo (fichier Markdown) à un relecteur humain via une page web locale. L'agent crée le script, lance la page, attend les commentaires, applique les modifications et répète le cycle jusqu'à approbation. Elle est conçue pour les outils d'IA comme Claude Code et fonctionne avec Python 3.9+ sans paquets supplémentaires. Les notes reviennent sous forme de Markdown, et l'agent doit respecter des règles strictes de révision (conserver les modifications textuelles du relecteur, ne modifier que ce qui est commenté). Des commandes d'inbox permettent de récupérer les notes non lues si l'agent n'était pas en attente.

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

Installed? Explore more Rédaction et édition skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Révision des scripts

Chaque script est un fichier Markdown. Le relecteur le lit sur une page locale et ses retours vous parviennent en Markdown. Toutes les commandes sont python3 scripts/script_review.py <commande>, avec le chemin relatif au dossier de cette compétence. Python 3.9 ou plus, aucun paquet à installer.

La boucle de révision

  1. Sauvegarder le script. Écrivez le corps dans un fichier temporaire et exécutez script_review.py new --title "<titre>" --body-file <fichier> --status drafted. Cela affiche l'identifiant du script, le chemin du fichier et l'adresse de la page. Mettez une phrase ou un temps (beat) sur chaque ligne de la lecture, afin que chaque ligne puisse avoir son propre commentaire.
  2. Lancer la page. Exécutez script_review.py up, puis script_review.py open <id>. Donnez l'adresse au relecteur.
  3. Attendre les notes. Exécutez script_review.py wait <id> en arrière-plan. Il affiche les notes lorsque le relecteur clique sur Envoyer les notes, et se termine avec le code 2 après deux heures sans envoi.
  4. Appliquer les notes. Modifiez le fichier du script avec le plus petit changement qui répond à chaque note. La page ouverte se recharge et marque les lignes modifiées.
  5. Répéter à partir de l'étape 3 jusqu'à ce que les notes disent "Looks good." Cet envoi fait également passer un brouillon au statut approuvé.

Si vous n'étiez pas en attente lorsque les notes ont été envoyées, script_review.py inbox affiche chaque ensemble non lu.

Règles de révision

  • Conservez les modifications du relecteur mot pour mot. Les lignes listées sous "edits (already saved to the file)" sont leur propre formulation et se trouvent dans le fichier avant que vous voyiez les notes. Ne modifiez une ligne que lorsqu'une note vous le demande.
  • Modifiez uniquement ce qu'une note couvre. Ne réécrivez pas les lignes qui n'ont aucun commentaire.
  • Appliquez "Edits that didn't land" manuellement. La ligne a été déplacée avant l'envoi, donc le fichier n'a pas été modifié.
  • Laissez les clés de frontmatter que vous n'avez pas définies. Changez le statut avec script_review.py status <id> <status>, pas en modifiant le fichier.
  • Ne supprimez pas un fichier de script sauf si le relecteur le demande.

Le format du fichier

---
type: script
id: 2026-01-15-three-prompt-habits
title: Three prompt habits
status: drafted
---

## Script parlé

Votre première ligne, une phrase par ligne.
La deuxième ligne.

## Accroches alternatives

Accroche 2 (question) : Une deuxième ligne d'ouverture à filmer.

## Légende

Tout ce que vous gardez avec le script.

Copie à lire sur la page copie la section Script parlé sous forme d'un paragraphe, puis chaque accroche alternative à partir de l'accroche 2 sous forme de "Deux. ". Un fichier sans section Script parlé est entièrement lu. script_review.py read <id> affiche le même texte.

Autres commandes

  • list [--status <status>] [--json] : chaque script avec son statut et son nombre de mots.
  • status <id> <status> : définit un statut (idea, drafted, ready, filmed, posted par défaut).
  • config : les paramètres utilisés et le chemin du fichier de configuration.
  • down : arrête le serveur de pages.

Les paramètres (dossiers, port, noms de sections, statuts, nom du relecteur) et l'accès téléphone via Tailscale sont décrits dans le README à la racine du dépôt.

Skills associés