Communityライティング&編集github.com

スクリプトレビュー

ローカルのブラウザページでレビュアーがスクリプトを一行ずつ確認し、行や選択した単語にコメントを付けたり、直接編集したりして、そのフィードバックをエージェントに送り返し、エージェントがマークダウンファイルを修正します。ユーザーがスクリプト草稿をブラウザでレビュー、コメント、承認したい場合、スクリプトページやスクリプト一覧を尋ねた場合、スクリプトをスマホや自動読み上げ機で確認したい場合、または草稿を作成後にレビューが必要な場合に使用します。

スクリプトレビュー とは?

このスキルは、ビデオスクリプトのレビュープロセスを効率化するために設計されています。レビュアーはローカルで起動するブラウザページ上でスクリプトを一行ずつ読み、各行や選択した単語にコメントを付けたり、直接編集を加えたりできます。レビュアーが「Send notes」をクリックすると、そのフィードバックがマークダウン形式でエージェントに送信され、エージェントは最小限の変更でスクリプトファイルを修正します。このスキルはClaude CodeなどのAIエージェントと連携し、Python 3.9以上で動作し、追加パッケージは不要です。レビューループは「スクリプトの保存」「ページの起動」「フィードバック待機」「フィードバックの適用」の繰り返しで構成され、「Looks good.」というフィードバックで承認ステータスに移行します。レビュアーの編集は一字一句保持し、コメントのない行は書き換えないなど、厳格なルールに従って修正が行われます。

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

Installed? Explore more ライティング&編集 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

スクリプトのレビュー

各スクリプトは1つのマークダウンファイルです。レビュアーはローカルページでスクリプトを読み、そのフィードバックはマークダウン形式でユーザーに返されます。すべてのコマンドは python3 scripts/script_review.py <コマンド> で実行し、パスはこのスキルのフォルダからの相対パスです。Python 3.9以降が必要で、インストールするパッケージはありません。

レビューループ

  1. スクリプトを保存します。 本文を一時ファイルに書き込み、script_review.py new --title "<タイトル>" --body-file <ファイル> --status drafted を実行します。スクリプトのID、ファイルパス、ページアドレスが表示されます。各行に1つの文またはビートを配置し、各行が個別にコメントを受け取れるようにします。
  2. ページを起動します。 script_review.py up を実行し、続けて script_review.py open <ID> を実行します。レビュアーにアドレスを伝えます。
  3. フィードバックを待ちます。 バックグラウンドで script_review.py wait <ID> を実行します。レビュアーが Send notes をクリックすると、フィードバックが表示されます。2時間経過しても送信がない場合はコード2で終了します。
  4. フィードバックを適用します。 各フィードバックに応える最小限の変更でスクリプトファイルを編集します。開いているページは自動的にリロードされ、変更された行にマークが付きます。
  5. フィードバックが「Looks good.」になるまでステップ3から繰り返します。 その送信により、ドラフトは承認ステータスに移行します。

フィードバック送信時に待機していなかった場合は、script_review.py inbox で未読のフィードバックセットがすべて表示されます。

修正ルール

  • レビュアーの編集は一字一句保持します。 「edits (already saved to the file)」の下にリストされた行はレビュアー自身の文言で、フィードバックを確認する前にファイルに反映されています。フィードバックで要求された場合のみ変更します。
  • フィードバックが対象とする部分だけを変更します。 コメントのない行は書き換えません。
  • 「Edits that didn't land」は手動で適用します。 送信前にその行が移動したため、ファイルは変更されていません。
  • 自分で設定していないフロントマターのキーはそのままにします。 ステータスは script_review.py status <ID> <ステータス> で変更し、ファイルを直接編集しないでください。
  • レビュアーが依頼しない限り、スクリプトファイルを削除しないでください。

ファイル形式

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

## Spoken Script

Your first line, one sentence per line.
The second line.

## Alternate hooks

Hook 2 (question): A second opening line to film.

## Caption

Anything else you keep with the script.

Copy read はページ上で Spoken Script セクションを1段落としてコピーし、次に各代替フックを「Two. <行>」としてフック2から順にコピーします。Spoken Script セクションがないファイルは全体が読み上げられます。script_review.py read <ID> は同じテキストを表示します。

その他のコマンド

  • list [--status <ステータス>] [--json]: すべてのスクリプトとそのステータス、単語数を表示します。
  • status <ID> <ステータス>: ステータスを設定します(デフォルト: idea、drafted、ready、filmed、posted)。
  • config: 使用中の設定と設定ファイルのパスを表示します。
  • down: ページサーバーを停止します。

設定(フォルダ、ポート、セクション名、ステータス、レビュアー名)およびTailscaleによるスマホアクセスについては、リポジトリルートのREADMEを参照してください。

関連スキル