Communitygithub.com

motion-qa

ペーパークラフト風リールの静止画をスタイルDNAとストーリーボードと照合します。いくつかのタイムスタンプでコンタクトシートを生成し、完全なチェックリストを実行して、納品サマリーを書き出します。「リールのQAをして」「シーンがペーパークラフトに見えるか確認して」「投稿準備はできている?」などの用途に使用します。

motion-qa とは?

このスキルは、ペーパークラフト風アニメーションリールの品質保証(QA)を自動化します。スタイルDNAとストーリーボードに基づいて、静止画のスタイル(内容ではなく)を検証し、コンタクトシートを生成し、詳細なチェックリストを実行して問題を特定します。対応プラットフォームはRemotionとKyframプロジェクトで、`motion-build`、`motion-voice`、`motion-strategy`などの他のmotion-explainerスキルと連携します。QAプロセスは、まず`qa.sh`を使用して指定されたシーンまたはリール全体の静止画をレンダリングし、次にペーパークラフトの美学、カメラワーク、バナー配置、キャプション、カット、ユーモアなどに関する包括的なチェックリストを実行します。最後に、配信サマリーを提供し、プレースホルダーを特定し、問題を関連スキルにエスカレーションします。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/boytegar/motion-skills/tree/HEAD/skills/motion-qa

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

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

ドキュメント

ペーパークラフト QA

静止画を、スタイルDNAとストーリーボードに対してスタイル(内容ではなく)で比較します。シーンごとに作成中に実行し、最終レンダリング前にリール全体に対しても一度実行します。

事前準備

  • インストール: Standard または Full。静止画には、Remotionを使用したスキャフォールディング済みプロジェクトと、Python(numpyおよびPillow、$MOTION_PY)が必要なコンタクトシートが必要です。不足している場合: ./install.sh --doctor を実行後、motion-setup を実行します。
  • kyfram プロジェクトにはRemotionは不要です。Kyframシーン出力を検査または修正する前に、kyfram スキルを呼び出してください。qa.sh は、キャッシュされたシーンごとのセグメント(core/tools/kyfram_qa.py)から静止画を取得するため、QAの前に core/tools/render.sh で一度レンダリングします。以下のすべては変更なく適用されます。
  • ライブラリ: $MOTION_LIB、または ~/.config/motion-explainer/config.env の MOTION_LIB= 行、または最初に一度尋ねます。
  • 最初に読むもの: $MOTION_LIB/style/$MOTION_STYLE/docs/style-guide.md のセクション2のスタイルDNA、および背景シート style/$MOTION_STYLE/remotion/public/bg/backdrops/_sheet.jpg。各画像は約0.7~1.5kトークンを消費するため、そのステップで必要なものだけ開いてください。
  • 密度について: $MOTION_LIB/style/$MOTION_STYLE/docs/frame-breakdown.md(末尾の「Pacing stats」):シーンの平均長は2.8秒、シーンあたり2~4の離散的な視覚イベント、強調された単語に合わせて0.4~0.8秒ごとに1つ、約0.6秒ごとに新しいキャプションページ。内容ではなく、密度をコピーします。

1. 静止画のレンダリング

プロジェクトの video/ フォルダから:

$MOTION_LIB/core/tools/qa.sh NAME FROM-TO NTH [SCALE=0.3] [COLS=9]
  • チェックごとに4~6のタイムスタンプを使用します。シーンの場合、NTH はそのフレーム数を4で割った値程度にします。リール全体の場合は FROM-TO を省略し、NTH を増やします。
  • 出力は out/qa/NAME_0.jpg(範囲が長い場合は _1、_2)で、シートあたり最大45フレームです。シートを読んでください。シートは小さく保ちます。
  • シーンごとに1つのQAコマンドを実行し、2つのレンダリングを同時に行わないでください。修正はシーンごとに2ラウンドまでに抑えます。
  • ストーリーボードと照合: シーンのフレーム0、キーイベントが該当する単語上にあること、クリップされていないこと、バナーやキャプション帯を覆っていないこと。

2. チェックリスト

  • すべてのオブジェクトが紙として読めること: 粒子、荒いエッジ、ドロップシャドウ、重ねた部品のシェーディング、輪郭線やグラデーションがないこと。
  • ワールドカメラが滑らかに動くこと。バナーとラベルのみがボイルする(ステップ状で、微妙に)。
  • バナーは固定位置にテープで留められており、3~7語、各1つの事実、VOを繰り返さないこと。バナーだけでも事実シートとして読めること。
  • すべてのセットが、そのVOライン内の具体的な単語を描き、数字は物理的な小道具であり、CTAの前に1つのコールバックセットがあること。
  • すべての数字とUIラベルが事実リストにトレースできること。スクリプトには少なくとも1つの正直な制限と、正確に3つの機能スタックがあること。
  • キャプション: 単語ごとに1つのタグ、傾けられ、開始時にポップし、1~3ページ、68~80%の帯域にあり、顔の上に決して配置しないこと。
  • 彩度はキャラクター、キャプション、シグナルのみ。
  • 強調されたすべての単語に視覚的イベントがあり、アンビエントモーションが常に実行されていること。
  • バナー変更でのカット(ツアーやニュースではセット1.5~3秒、メタファービートでは最大5秒)、下部20%はクリアであること。
  • HOOKブロック(SAY / WRITE / SHOW / ALIGN)は、書かれたとおりに正確に画面に表示されること: フレーム0は、WRITEタイトルが表示されたSHOWモーメントのアクション中の状態を示し、最初のVOラインはSAYであること。
  • すべてのシーンにカメラ移動があり、最大1回のページめくりまたは破り、テープ引きはがしまたはCTAへの鞭打ち動作があり、すべてのトランジションにSFXがあること。
  • ユーモアパスが画面で確認できること: 全体で1つのフォーマット、アイデアごとに1つのコスチューム小道具、1つの苦闘するビート、フレーム0の小道具がCTAセットで変化して戻ってくること、すべてのギャグが1秒未満で読め、バナー、キャプション、キーナンバーを決して覆わないこと。
  • VOとバナーの語彙が、SERIES.md のオーディエンスレベルと一致していること。
  • ナレーション、キャプション、イベントが同期していること(すべてのカットでStudioをスクラブ)。

失敗した項目については、シーンファイル(またはライブラリ内のキット。プロジェクト内の src/lib/ は不可)を修正し、該当するシーンのみを再実行します。motion-build でシーンを再構築します。

3. 納品

Studioプレビューを開き、タイミングとともにシーンをリストアップし、プレースホルダー(音声、音楽、SFX、アセット)を特定します。音声がプレースホルダーの場合は、再吹き替え方法(motion-voice)を説明します。投稿後、数値はオートプシー(事後分析)のために motion-strategy に送られます。

原則チェック

1つのシーンを5fpsでスクラブし、$MOTION_LIB/style/$MOTION_STYLE/docs/motion-principles.md と照合: 大きな動きの前のアンティシペーション(2)、すべてにイージング(6)、衝撃後の後続動作(5)、1つの焦点小道具(3)、1つの誇張されたビート(10)、重ねたシェーディングと一貫したシャドウ(11)。

引き継ぎ

修正は motion-build(シーンまたはサウンド)または motion-voice(同期)に戻されます。クリーンパスでリールは完了です: ユーザーが要求したら $MOTION_LIB/core/tools/render.sh でレンダリングします。

Individual skills in this repo

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

bang-motion

Render a reel in the Bang Motion style: high-end cinematic motion graphics with a multi-layer glowing-horizon background, floating colour-mesh blobs, living film grain, frosted-glass UI cards, editorial kinetic typography, a breathing camera, and anti-PPT pacing. Use when the user says cinematic motion graphic, promo opener, product launch reel, kinetic typography, SaaS product tour, glassmorphic UI, anti-slides, or asks for a video that moves like footage instead of a deck. Gunakan skill ini setiap kali user meminta "video promo", "opener", "intro animasi", "motion graphic", "bumper", "kinetic typography", "animasi teks sinematik", "explainer", "video penjelasan" (jurnalisme visual, kartun edukasi, kolase), atau menunjukkan referensi video promosi/explainer dan ingin dibuatkan versi web-nya — bahkan bila mereka tidak menyebut kata "motion graphic" secara eksplisit. Juga gunakan bila user mengeluh hasil animasi web "seperti PPT/presentasi" dan ingin lebih sinematik, atau ingin meren...

isometric

Render a reel in the Isometric style: calm precise product line art in 2:1 dimetric isometric on a white or dark ground, drawn only with constant 2px hairlines, white-filled faces so nearer objects hide farther lines, rounded slabs with visible thickness, stacked layers, repeated-part grids, and one tiny dark accent per frame. Use when the user says isometric, product line art, technical illustration, exploded hardware view, or asks for a clean documentation-grade diagram look.

motion-build

Build and render a papercut episode from a storyboard with the library. Scaffolds the project, builds scenes with parallel agents, assets and audio, renders the mp4, then harvests reusables. Use for "build the reel", "scaffold an episode", "rebuild scene 4", "render it".

motion-explainer

Make a papercut reel, video or explainer end to end. Short vertical (9:16) cut-paper explainers from a link (repo, product page, announcement), idea to mp4. Also routes partial asks to the stage skills and hands out the style prompt for other tools.

motion-script

Turn a link into a papercut reel script. Researches a sourced facts list, writes the 75-95 word script on the 10-beat spine, a banner fact track, a staging table with one set per banner, and the humour pass. Use for "write the script", "research this repo for a reel".

motion-storyboard

Storyboard a papercut script before any code. Writes the Camera / Cut table, one block per scene with frame-level events on each stressed word, the SFX plan and the proof beat. Use for "storyboard this script" or "plan the camera moves and cuts".

motion-voice

Voice a papercut reel and time it to the picture. Three paths, local Qwen3-TTS, your own recording or another TTS, or a placeholder voice. Covers delivery rules, voice.json, captions and scene timing. Use for "set up the voice", "re-voice this", "time the script".

papercut

Render a reel in the Papercut style: layered construction paper brought to life with paper grain, torn edges, stacked shade strips, drop shadows, rigid cut-out animation, a slow camera push, taped headline banners and word-by-word torn-tag captions. Use when the user says cut paper, papercraft, paper cutout, paper collage, construction paper, or asks for the default handcrafted explainer look.

関連スキル