Communitygithub.com

Hownameee/short-videos

承認済みのショート動画を制作するか、既存の動画の背景音、感情、キャプション、ミックス、エクスポートを修正します。変更されたナレーションのみを生成し、現在のプレビューをレンダリング・確認し、技術・編集品質管理を実施した上でエクスポートします。脚本のみや一般的な音声アドバイスのリクエストは対象外です。

short-videos とは?

このスキルは、承認済みのショート動画を制作・修正するための包括的なワークフローを提供します。既存の動画に対して、背景音のゲイン調整、フェード、効果音、キャプションモードの変更、ナレーションの差し替え、シーンコンテンツの編集など、スコープを限定した改訂を安全に実施できます。変更範囲に応じて適切なツール(npm run video revise、Kokoro TTS、ビジュアルデザインスキルなど)を呼び出し、承認ハッシュや契約に基づくオーバーレイ編集を支援します。また、プリフライト検証、プレビューレンダリング、フレーム・音声の品質確認、最終エクスポートまでを自動化し、出力成果物の一貫性と品質を保証します。主にRemotionベースのレンダリングパイプライン上で動作し、Claude CodeやCursorなどのAIエージェント環境で使用されることを想定しています。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Hownameee/short-videos/tree/HEAD/.agent/skills/short-video-production

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

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

ドキュメント

ショート動画制作

対象の state.json、承認済みの video.json、script.md、および既存の制作ノートを確認します。デフォルト を一度読んでください。インストール済みのランタイムと既存のコマンド を使用します。

脚本の承認と明示的な制作リクエストが必要です。既存の動画を修正するリクエストは、スコープ内の改訂と置き換え成果物を許可します。調査を再開したり、すでに与えられた承認を再度求めたりしないでください。ドライランは、メディアを作成したり測定値を主張したりせずに、調査と計画のみを行います。

改訂

音楽、ゲイン、フェード、効果音、キャプションモードの場合は、以下を実行してください npm run video -- revise --project projects/NNN-topic その後、production.json を編集します。承認済みのナレーションとビジュアルは保持します。このオーバーレイは、従来の承認ハッシュを保持します。音声の意図は PRODUCTION.md またはオーバーレイに記録します。

ナレーションの変更、シーンコンテンツ、音声設定、デザインデータの場合は、スクリプト/設定を編集し、script --draft を実行し、承認を取得し(明示的にまだ与えられていない場合)、その後 script --approve を実行します。ドラフトは制作後も機能し、以前の成果物を保持します。オーバーレイが存在する場合は、再承認後に revise を実行します。承認ハッシュを手動で書き換えないでください。オーバーレイを記述したり構造化フィールドを変更する場合は、契約 を参照してください。ストーリーボードのオーバーライドは2つのトピックレンダラーでは実装されておらず、黙って無視されるのではなく拒否されます。

対象読書

必要な作業読むもの
音声選択、雰囲気、ミックス音声品質管理; 関連するバックグラウンドガイドのセクション
ナレーションの生成/変更Kokoro
アートディレクション、レイアウト、シーンモーション、キャプションUIの変更ビジュアルデザイン
Remotionコードの変更Remotionプラクティス、その後関連するAPI/ルールリファレンスのみ

ゲインのみの修正のために、音声設定、ビジュアルデザイン、設計図、またはすべてのRemotionパッケージをロードしないでください。APIガイダンスが必要な場合は、インポートした対象パッケージを使用し、不確かなバージョン詳細は公式ドキュメントで確認してください。作業レポートで実際に使用したガイダンスをリストアップします。

制作とチェック

  1. 承認された約束、証拠の主張、ペイオフ、コンテキストに応じたCTAを保持します。新しいシーンにはビジュアルテーゼとアクション/キュー/セトルを記録します。新しいトピックには独自のレンダラーが必要です。Kubernetes図を汎用的な出力として偽装しないでください。
  2. ナレーションを更新する必要がある場合は、共有音声ジェネレーターを使用します。これにより、変更されていないWAVとタイミングが検証・再利用され、変更により影響を受けるシーンが再生成されます。長さを測定し、プロバイダーが予測した単語タイムスタンプを保持し、発音を確認します。
  3. アセットを解決し、ソース/ライセンスを記録します。目的のあるサウンドアークを実装します:フック → 説明 → 暴露 → エンディング。最初に音声、次に可聴音楽、最後に選択的効果音をミックスします。音声品質管理を適用します。可能であればレンダリング済みの聴取も含みます。
  4. レンダリング前に video preflight --project … を実行します。これにより、サポートされている設定、アセットパス/チェックサム、音声順序/タイミング、音楽信号と長さが検証されます。失敗は解決し、回避したり測定値を捏造したりしないでください。
  5. --preview をレンダリングします。コンタクトシート(開始、各シーン、終了)を検査し、焦点、読みやすいモバイルテキスト、セーフエリア、アセット品質、一貫したビジュアルスタイルを確認します。すべての主要なモーションビートを通して、連続フレームの再生を検査します。静止フレームでは意味のあるアニメーションを確立できません。
  6. 少なくとも3つの連続する単語ハイライトと、後続のシーン/チャンクをチェックします。フレーム時間とタイミングソースを記録します。欠落、繰り返し、誤った発音の単語、音声の明瞭性、音楽アーク、フェード、ループ、電話/モノラル再生をチェックします。編集証拠を output/qc.json に保存し、アセット/出力チェックサムに関連付けます。実証された欠陥を修正し、影響を受けた作業とプレビューを再生成します。
  7. 現在のプレビューから --final をレンダリングします。CLIはフィンガープリント、タイムライン時間、寸法/FPS、H.264/AAC、フルデコード、ラウドネス、トゥルーピークをチェックします。編集品質管理とは別に output/automated-qc.json を書き込みます。
  8. 実際の最終成果物、レポート、スナップショットを納品します。CLIはチェック後、最終/レポート/スナップショット/状態をアトミックに置き換え、正確な共有 renderer/src/ をアーカイブします。コピーを作成する場合は、要求された名前付きコピーが最終チェックサムと一致することを確認します。

出力に黒/欠落フレーム、隠されたペイオフ、機密情報、内部プロンプトを含めないでください。アセット権利記録を保持します。購入または公開は別途の承認が必要です。バックグラウンドアセットの存在や最終ラウドネスだけでは、可聴的な感情適合性を証明できません。聴取が利用できない場合は、承認された測定済みエクスポートを完了し、not-performed とマークし、その制限を開示します。合格をでっち上げないでください。

ドライラン応答:1つのプリフライトテーブル、順序付き計画、品質管理リスト、アーティファクトリスト。まだ取得していない測定値には <measured> プレースホルダーを使用します。

Individual skills in this repo

This repo contains 11 individual skills — each has its own dedicated page.

Hownameee/short-videos

Generate, revise or troubleshoot local Kokoro narration, pronunciation and scene word timing. Reuse verified unchanged clips; inspect the Python environment before setup changes. Exclude research, visuals, music composition and publishing.

Hownameee/short-videos

Router for all Remotion skills

Hownameee/short-videos

Transcribing, displaying and animating captions

Hownameee/short-videos

Structure Remotion markup for interactivity

Hownameee/short-videos

Remotion Map animation knowledge

Hownameee/short-videos

Content, animation and effects best practices

Hownameee/short-videos

Upgrade Remotion, and related packages

Hownameee/short-videos

>- Run Phase 1 of the shared short-video workflow: turn a raw topic or prompt into a sourced research pack and 2–4 distinct video directions, each with a defensible tension hook, promise, payoff, beats, visual approach, duration range, and risks. Use whenever the user asks for video ideas, angles, research, facts, hooks, topic analysis, or choices before scriptwriting. Stop for the user's direction choice and do not silently continue into script or production.

Hownameee/short-videos

>- Run Phase 2 of the shared short-video workflow: convert an explicitly selected direction and its research into a reviewable beat sheet, narration, flexible scene timing, on-screen text, visual plan, captions, music and SFX cues, pronunciation notes, payoff, takeaway, and contextual CTA. Use whenever a user asks to write, revise, preview, or approve a short-video script. Stop for script approval and do not generate TTS or render video yet.

Hownameee/short-videos

>- Design and review a coherent visual system for short-form video before and during Remotion implementation. Use for video art direction, scene UI, typography, layout, color, diagrams, captions, motion, transitions, platform safe areas, or visual-quality review. Use Remotion skills separately for API, timeline, media, Studio, and rendering behavior; do not use this skill for narration-only or research-only work.

Hownameee/short-videos

Coordinate prompt-to-short-video discovery, scripting and production. Resume existing projects and route soundtrack or mix corrections directly to production. Preserve direction choice and script approval; exclude general audio advice.

関連スキル