本文へ移動
cccskills
無料GitHub で公開

video-editor

TikTok/YouTube向け動画編集スキル。ffmpegでキャプション焼き込み、 Ken Burnsエフェクト、シーン結合、音声合成を行う。scenes.jsonから自動的に編集指示を読み取り最終動画を出力する。

Remotionコンポーネントも同梱(ローカル環境用)。「動画編集」「キャプション追加」「テロップ付き動画」等で発動。

インストール方法を見る

含まれるファイル(6)

  • SKILL.md4.5 KB
  • agents/openai.yaml152 B
  • references/tiktok-specs.md2.8 KB
  • scripts/compose_video.py22.2 KB
  • SKILL.en.md3.8 KB
  • SKILL.es.md4.1 KB

SKILL.md(原文)

インストールする前に、エージェントに与えられる指示の中身を確認できます。

Video Editor

scenes.json + フレーム画像/動画クリップから最終動画を生成する。

2つの実行モード

🟢 ffmpegモード(サンドボックス対応・推奨)

Chromium不要。サンドボックスでも動作する。

python skills/video-editor/scripts/compose_video.py \
  --storyboard-dir output/storyboard/YYYYMMDD_session \
  --captions \
  --output output/final_tiktok.mp4

🔵 Remotionモード(ローカル環境用)

Chromium + Node.js必要。より高度なアニメーション。

npx remotion render TikTokVideo --output=out/tiktok_video.mp4 --root=remotion-editor/src/Root.tsx

ffmpegパイプライン

1. 素材準備

scenes.json → 各フレームのmotion_type確認
  i2v        → video/{frame}_i2v.mp4 を使用
  ken_burns  → ffmpeg zoompan フィルターで画像→動画
  static     → ffmpeg loop で画像→動画
  motion_graphics → ffmpeg で画像→動画(将来テキストアニメ追加)

2. 正規化

全クリップを統一仕様に:

  • 解像度: 1080×1920 (9:16) or 1920×1080 (16:9)
  • FPS: 30
  • コーデック: h264 / yuv420p
  • 横向きi2V動画 → ぼかし背景付き縦型に変換

3. キャプション焼き込み(drawtext)

ffmpeg -i clip.mp4 -vf "drawtext=text='テキスト':fontfile=/path/to/NotoSansJP-Bold.otf:\
  fontsize=64:fontcolor=white:borderw=3:bordercolor=black:\
  x=(w-text_w)/2:y=h*0.58" output.mp4

キャプション仕様:

項目TikTok推奨
フォントサイズ54-76px (画面幅の5-7%)
文字数/行日本語5-8文字 / 英語2-3語
最大行数2行
フォントNoto Sans JP Bold
色白 + 黒ストローク(3px) + シャドウ
位置Y: 55-65% (TikTokセーフゾーン内)

4. 結合

ffmpeg -f concat -safe 0 -i concat.txt -c:v libx264 -pix_fmt yuv420p final.mp4

5. 音声合成(オプション)

ffmpeg -i video.mp4 -i narration.mp3 -c:v copy -c:a aac -shortest final_with_audio.mp4

TikTokセーフゾーン

┌─────────────────────┐
│  ⚠️ 上15% 避ける     │ ← ユーザー名/フォローボタン
├─────────────────────┤
│   メインコンテンツ    │
│  ┌───────────────┐  │
│  │ キャプション    │  │ ← Y: 55-65%
│  └───────────────┘  │
├─────────────────────┤
│  ⚠️ 下20% 避ける     │ ← いいね/コメント/シェア
└─────────────────────┘

scenes.json フォーマット

{
  "title": "動画タイトル",
  "scenes": [
    {
      "frame_number": 1,
      "timestamp": "0:00-0:02",
      "motion_type": "i2v | ken_burns | static | motion_graphics",
      "narration": "ナレーション台本",
      "text_overlay": {
        "main_text": "メインテロップ",
        "sub_text": "サブテロップ",
        "position": "top | center | bottom",
        "style": "bold | subtitle | minimal"
      }
    }
  ]
}

依存

  • ffmpeg (静的バイナリ: .bin/ffmpeg)
  • Python 3.11+ (compose_video.py)
  • Noto Sans JP フォント(キャプション用)

Remotionコンポーネント(ローカル用)

remotion-editor/src/
  components/
    Caption.tsx    # TikTok最適キャプション(日本語改行、pop-inアニメ)
    KenBurns.tsx   # Ken Burns zoom/pan エフェクト
  compositions/
    TikTokVideo.tsx # 9:16 メインコンポジション
  Root.tsx         # エントリポイント

関連スキル

  • storyboard-generator — 入力素材(frames + scenes.json)
  • content-creator — コンテンツ企画
  • post-publisher — 投稿・配信

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

同じリポジトリのスキル

概要と使いどころ

ab-test-setup

無料日本語概要

A/Bテストや実験の設計・実装を支援するスキル。 「A/Bテストを設計して」「スプリットテストしたい」「仮説を立ててテストしたい」「バリアントを比較」等のリクエストで発動。 トラッキング実装は analytics-tracking を参照。

minicoohei/ai-agent-camp3472026年10月7日 更新

agent-designer

無料日本語概要

マルチエージェントシステムのアーキテクチャ設計ツールキット。 「エージェントを設計して」「マルチエージェント構成」「エージェントのアーキテクチャ」「オーケストレーション設計」等のリクエストで発動。

minicoohei/ai-agent-camp3472026年10月7日 更新

aiagent-check-setup

無料日本語概要

ai-agent-campのローカル環境セットアップを確認するスキル。 「セットアップ確認」「環境チェック」「初期設定できてる?」「インストール確認」「依存関係チェック」等のリクエストで発動。

minicoohei/ai-agent-camp3472026年10月7日 更新

aiagent-command-router

無料日本語概要

ai-agent-campのスラッシュコマンドをCodexでルーティングするスキル。 「/start-0-1を実行」「スラッシュコマンドを使いたい」「コマンドルーティング」「Cursorのコマンドを使いたい」等のリクエストで発動。

minicoohei/ai-agent-camp3472026年10月7日 更新

aiagent-env-manager

無料日本語概要

ai-agent-campの環境変数・認証情報を安全に管理するスキル。 「APIキーを設定」「.envを管理」「環境変数の設定」「credential managerを使いたい」「秘密情報の管理」等のリクエストで発動。

minicoohei/ai-agent-camp3472026年10月7日 更新

aiagent-guide

無料日本語概要

ai-agent-campリポジトリの案内・オリエンテーションスキル。 「リポジトリ案内」「次のレッスンは?」「どこから始める」「ツールの違い」「aiagent概要」等のリクエストで発動。

minicoohei/ai-agent-camp3472026年10月7日 更新

minicoohei のスキルをすべて見る

このスキルの問題を報告する