Jaycheng1103/chatgpt-video-editing-skills

用 ChatGPT/Codex 安裝 AI 剪輯環境,並依八大步驟完成可驗證的短影音剪輯。

ChatGPT ショート動画編集 Skills — 概念説明

これは何?

これは「スキルパック」で、ローカルファイルとターミナルを操作できる AI Agent(例:ChatGPT)向けです。目的は:自分が提供した動画を、安全に「縦型ショート動画」(例:9:16 の Reels、60〜90秒)に制作することです。

プロジェクト全体は「保守的、信頼できる、根拠がある」を原則とします:元ファイルを勝手に変更しない、アップロードや支払い前に同意を求める、「計画/指示/未検証ファイル」を完成品と言わない。

プロジェクトは繁体中国語で書かれ、2つのスキルが含まれます。1つは環境管理、もう1つは編集です。

2つのスキルの役割分担

スキル 担当 明確に担当しない
chatgpt-video-editing-setup 編集に必要なツールの確認、インストール、修復、検証:video-use、FFmpeg、ffprobe、思源黑体 TW 字幕フォント、ElevenLabs 認証情報、オプションの HyperFrames 素材のアップロード、文字起こし、編集、動画出力はしない
chatgpt-short-video-editor ユーザー提供の動画に対して実行:逐字文字起こし、編集戦略、粗編集、字幕、プレビュー、QA、正式出力 ツールを静かにインストールしない、プレビュー承認前に正式版を出力しない

簡単に言うと:1つは「環境を整える」、もう1つは「実際に動画を編集する」です。

8ステップのワークフロー

  1. 素材チェック — ffprobe でソース動画の仕様とデコード可能性を確認、元動画は変更しない。
  2. 逐字文字起こし — まずアップロード同意を得て、ElevenLabs Scribe v2 で「逐字レベル」のタイムコードを取得(各文字が何秒に現れるか分かる)。
  3. 内容整理 — フック(Hook)、核心のメインライン、削除できる部分、確認が必要な情報を見つける。
  4. 編集決定 — まず4〜8文の平易な戦略を提案し、承認を得てからカットポイントとクリエイティブ要素を決定。
  5. セグメント粗編集 — 完全な単語境界に基づいて編集リストを作成、30〜200ms の境界スペースと約30ms のオーディオフェードを保持。
  6. カラー/カード/字幕 — 技術的に必要または承認された場合のみカラー調整;静的カードは Pillow、オプションアニメーションのみ HyperFrames、字幕は思源黑体 TW で最後に合成。
  7. ミキシングと完全プレビュー — まず完全な720p プレビューを出力して確認。
  8. QA と正式版 — プレビューが明確に承認された後、1080×1920 の正式ファイルを出力;正式ファイルも独立したチェックと完全デコードが必要で、合格後に納品。

インストール方法

npx skills コマンドでインストール:

  • 対話式(推奨):npx skills add Jaycheng1103/chatgpt-video-editing-skills --full-depth — インストール時にどのスキルを入れるか、どの Agent を検出するか選択可能。
  • 一括インストール:npx skills add Jaycheng1103/chatgpt-video-editing-skills --all --full-depth — すべてのスキルと検出されたすべての Agent を一度に選択。
  • 単一スキルのみ:--skill パラメータで指定、例:--skill chatgpt-video-editing-setup または --skill chatgpt-short-video-editor。
  • 手動 Clone 後にローカルからインストール:git clone 後に npx skills add . --full-depth を実行。手動コピー時は各スキルの references/ フォルダも一緒に保持する必要があります。

更新と削除にも対応コマンドがあります(npx skills update、npx skills remove)。

前提条件

  • ローカルファイルの読み書きとターミナルコマンド実行ができる互換 Agent
  • Git、Python と uv(Python パッケージマネージャー)
  • FFmpeg と ffprobe
  • video-use の完全な Repo(編集補助プログラムが含まれる)
  • 思源黑体 TW サブセット OTF(Regular と Bold)、繁体中国語字幕焼き込み用
  • ElevenLabs Scribe v2 の認証情報と利用可能なクレジット、逐字文字起こし用
  • Pillow、簡単な静的情報カード用
  • HyperFrames(オプション):承認された戦略が HTML / CSS / GSAP アニメーションを必要とする場合のみ、Node.js 22+ と Bun が必要

ツール不足時、編集スキルは安全な位置で停止し、不足を説明し、Setup スキルにチェックを任せます。自分で無理にインストールしません。

プライバシー、認証情報と費用

  • API キーをチャットウィンドウ、コマンドライン引数、公開ファイル、Git commit、shell history や log に貼り付けない。
  • ELEVENLABS_API_KEY はローカル環境変数または保護された ~/Developer/video-use/.env でのみ提供;使用前に Git がそのファイルを無視することを確認し、ファイル権限は 600 にする。
  • 初めてメディアを ElevenLabs に送信する前に、Agent は具体的なファイル名、用途(Scribe v2 文字起こし)、クレジット消費や費用発生の可能性を説明し、明確な同意を待つ。
  • クラウドにアップロードしたくない場合、「ローカル Whisper フォールバック」を明示的に選択できるが、タイムコードの信頼性が低く、追加の再生チェックが必要で、Scribe v2 と同等の精度とは言えない。

何が生成される?

すべての新規成果物は元動画の隣の edit/ フォルダに置かれ、元ファイルは上書き、移動、名前変更、削除されません。フォルダ構造:

edit/
├── project.md              # プロジェクト記録
├── transcripts/            # 文字起こし JSON
├── corrected-transcript.md # 修正済み文字起こし
├── edl.json                # 編集決定リスト
├── master.srt              # メイン字幕
├── clips/                  # 切り出したクリップ
├── animations/             # オプションアニメーション
├── qa/                     # QA 記録
├── preview.mp4             # 720p プレビュー
└── final.mp4               # 正式版

final.mp4 は「720p プレビュー承認 → 1080×1920 正式ファイルのレンダリング完了 → 正式ファイル自体がカットポイント、代表フレーム、完全デコードチェックに合格」した後にのみ、納品可能な完成品と見なされます。

よくある懸念への対応

  • ツールや認証情報が見つからない → Setup スキルに任せる。まずチェックし、変更をリストアップし、承認を待つ。既存 Repo に未コミットの変更がある場合、強制 pull や上書きは絶対にしない。
  • ElevenLabs のクレジットがない、またはアップロードしたくない → ローカル Whisper フォールバックを要求できるが、信頼性の低いタイムコードを受け入れる;Agent は黙って切り替えない。
  • 指示、文字起こし、プレビューを見たら完了? → 違う。指示 ≠ 実行済み、画面 ≠ 完全 QA、プレビュー ≠ 正式納品。正しい順序:完全プレビューチェック → 承認 → 正式ファイルレンダリング → 検証 → 納品。
  • アニメーション、B-roll、音楽、CTA を追加したい → 編集戦略段階で提案または承認。これらはオプションのクリエイティブ決定であり、デフォルトで自動追加されない。

ライセンスと声明

  • 本 Repo は MIT License で公開され、貢献を歓迎します(CONTRIBUTING.md と CODE_OF_CONDUCT.md があります)。
  • Repo にはサードパーティのアップストリームコードは含まれません;関連ツール、API、サービスはそれぞれの条項とライセンスに従います。
  • これはコミュニティ保守の非公式プロジェクトであり、OpenAI、ChatGPT、video-use、HyperFrames、ElevenLabs、FFmpeg、Pillow または Adobe の開発者および所属会社とは従属、ライセンス、推薦、協力関係はありません。

関連

  • プロジェクト
  • プロジェクト
  • プロジェクト
  • プロジェクト