Communitygithub.com

yazzang-homelab/motion-studio

6つのセクションからなるXMLステート仕様を記述し、1つのシェイプだけを使ったUIモーフフィルム(入力、方向、構造、ビルド、注意点、開始)を作成します。ダウンビートごとのステート、カーソル駆動の変化、シームレスなループ、承認ゲートを備えています。「UIモーフ」「ステートリスト」に使用。

motion-studio とは?

このスキルは、1つのシェイプのみを使用して、カットなしで連続的に変化するUIモーフフィルムを作成するための包括的なワークフローを提供します。ユーザーはまず製品URLやステート数(8~12)、実際のデータ、ブランドカラー、トラック、フォーマット、ループ設定などの入力を要求します。次に、6セクション(inputs, direction, structure, build, gotchas, start)からなるXMLテンプレートをプロジェクト内の`docs/spec.xml`にコピーし、各プレースホルダーを埋めます。ステートはビートグリッド上に配置され、`statelist.mjs`スクリプトがダウンビートの正確なタイミングを計算し、ループチェックと警告を表示します。承認ゲートを通過した後、`morph-loop.film.js`テンプレートを基に実際のフィルムコードを生成します。このテンプレートは、状態時間、コンテナサイズ・半径・色の遷移、コンテンツのフェードイン/アウト、カーソル操作、サウンド、グレインなどのメカニクスを提供します。最後に、`motion-reel`による批評ループ(3ラウンド以上、全軸8以上、P0なし)でループシームの品質を検証し、各フォーマット(9x16、1x1、16x9)での納品を行います。対応プラットフォームはClaude Code(および同様のエージェント)です。

対応✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/yazzang-homelab/motion-studio/tree/HEAD/skills/ui-morph-spec

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

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

ドキュメント

UIモーフ仕様(コースステップ06、レベルL3)

雰囲気ではなく、ステートリストを書きなさい。Opus 5.5 ローンチウィークで最もブックマークされたプロンプトは、ワンライナーではありませんでした。@twoclipping の UI モーフループと @verbove の MakerMap フィルムはどちらも、入力を要求する XML 仕様、方向性、ビートごとのステートリスト、ビルドルール、注意点を使用していました。それらの背後にあるアイデアは、1つのシェイプで決してカットしないというものです。単一の要素がサイズ、半径、色をステートごとに変化させ(ボタン、ローダー、プレイヤー、チャート、コマンドパレット)、カーソルが実際のクリックで各変化を引き起こし、最後のフレームが最初のフレームと等しいためフィルムはループします。

リクエスト引数(空の場合あり)は、1回だけ表示されます。

クレジット:6セクションのレイアウトは @twoclipping の公開テンプレート(https://x.com/twoclipping/status/2103273003555402193;XMLはメインポストにあり、コースが言うスレッド返信ではありません)と @verbove の MakerMap 仕様(https://x.com/verbove/status/2103483957266268381)に従っています。このスキルのテンプレートは motion-studio 自身の言葉で書かれています:assets/spec-template.xml。

1. 入力を要求する

AskUserQuestion 1ラウンドで質問します(サブエージェントは質問できません。あなたが行います):

入力デフォルトルール
製品 + URL必須実際のUIをキャプチャし、URLがある場合は /motion-studio:product-reel ステージ3でコピーする
ストーリー順の8~12のステートロゴ、CTA、メールフィールド、ローダー、チェック、カード、チャート、コマンドパレットダウンビートごとに1つ
ステートごとの実データ質問する製品からのラベル、数値、名前。プレースホルダーなし
ブランドカラー、フォント、1つのアクセントキャプチャまたは studio.json からアクセントは1つ
トラックminimal を120 BPMで合成提供されたトラックはこの使用を許可し、ダウンビートで開始する必要がある
フォーマット9x16、1x1、16x9同じタイムライン、リフレーミング
ループはい最後のステートが最初のステートに戻る

2. 仕様を埋める

テンプレートをプロジェクトに docs/spec.xml としてコピーし、すべての [...] を回答で埋めてください。6つのセクションすべてを維持します:<inputs>、<direction>、<structure>、<build>、<gotchas>、<start>。モーションディレクターサブエージェント(motion-studio:motion-director)があなたのブリーフから下書きできます。これは docs/ の下にのみ書き込みます。

3. ステートをビートグリッドに配置する

  1. プロジェクト:必要に応じて --loop でスキャフォールドする (node "${CLAUDE_PLUGIN_ROOT}/skills/studio-init/scripts/init.mjs" <dir> --title "<Product> morph" --loop --duration <S> --install; スキルのみのインストールでは、同じフラグで node "${CLAUDE_SKILL_DIR}/../studio-init/scripts/init.mjs" ... を使用するか、studio-init スキルを呼び出します)。

  2. グリッド:node tools/score.mjs --style minimal --bpm 120 --dur <S>、または提供されたトラックを node tools/beats.mjs audio/<track> で測定します。

  3. 正確なダウンビート時刻、ループチェック、警告を含むステートリスト:

    node "${CLAUDE_SKILL_DIR}/scripts/statelist.mjs" --states "logo,CTA button,email field,loader,check,card,chart,palette" --out docs/statelist.md
    
    フラグ使用法
    --states "a,b:2,c" または --file list.txt順序どおりのステート; :2 はステートを2小節保持
    --beats audio/beats.json測定されたグリッド(ファイルが存在する場合のデフォルト); --beats none は無視
    --bpm N、--beats-per-bar Nグリッドをオーバーライド
    --no-loopループではなく終了するフィルム
    --json各ステートの開始、終了、コンテンツタイミングを含む1行のJSON

    ループ長が studio.json の duration と異なる場合、最初のステートが0秒にない場合(トラックのピックアップ)、またはステートの保持時間が1秒未満の場合に警告します。続行する前に、期間を修正するかトラックをトリミングしてください。

  4. docs/statelist.md のカーソルアクション、データ、サウンドの列を埋め、テーブルを docs/shotlist.md にコピーします。

4. ゲート

ビートグリッド上のステートリストを表示し、フィルムコードを書く前にユーザーのOKを待ちます(<start> セクションもコースもそう述べています)。拒否されたリストは書き直され、回避策は取られません。決定を docs/shotlist.md の Status: 行に記録します。

5. 検証済みの例からビルドする

assets/morph-loop.film.js を film/film.js にコピーして適応させます。これは、120 BPMで動作する16秒、8ステートのループであり、すべてのフォーマットでレンダリングされます。STATES(1080px単位のサイズ、フィルトークン)、COPY、および content ペインターを承認されたリストと実際のデータに置き換えます。メカニクスは維持します:

メカニクスAPIルール
ステート時刻grid.bar(i)秒数を直接入力しない
コンテナサイズ、半径、色チャンネル、カメラズームloopTrack(t, keys, dur, spring)キーは [0, duration] 内;シームの変更は1回、最初のダウンビートのキー(この例)または t = duration で
コンテンツのインとアウトswapAlpha(t, start, nextStart)モーフ開始後にイン、次のモーフ前にアウト
カーソルx と y に loopTrack、cursor(g, x, y, { pressed })ダウンビートで現在の要素をクリック
タブとリストのハイライトindicator(t, stops, { width })エッジは異なるスプリング上
サウンドgrid.bar と grid.beat からの cuesプレス時にクリック、モーフ中にスウッシュ
グレインおよびその他のフレームインデックス依存ノイズgrain(g, W, H, c.frame % LOOP_FRAMES, ...) ただし LOOP_FRAMES = Math.round(dur * fps)批評は hash(0) と hash(duration, { wrap: false }) を比較;生のフレームインデックスでシードされたノイズは終了をフレーム0と異ならせ、ループチェックに失敗する

すべてのパターンとその根拠:references/morph-recipes.md。 studio.json の "loop": true と duration をループ長に設定し、npm run lint を実行します。

6. 批評と納品

/motion-studio:motion-reel から批評ループを実行します(少なくとも3ラウンド、全軸 >= 8、未解決のP0なし。各ラウンドは最初に混合レンダリングと両方のエビデンスパスをビルドします。パイプラインランブックを参照)。 モーフループについては、out/review/<fmt>/loop.png(ライブパスのみ;video/ パスにはループペインなし)と「ループシーム」メトリックも確認します(hash(0) が hash(duration, { wrap: false }) と等しい、連続比 <= 1.5;|end - first| ペインは黒でなければならず、フレームインデックスがラップしない限りフレームインデックスノイズはこれを壊します)。strip.png の各スワップ中のラベル、contact.png の各ダウンビートでのカーソル位置も確認します。シームジャンプはP0です。その後 npm run build。

モーフフィルムのルール

  • 1つのコンテナ。決してカットしない。ステートはサイズ、半径、塗りつぶし、コンテンツのみが異なる。
  • カーソルがすべての変化を引き起こす。ステートが単独で変化することはない。
  • すべてのビートで何かが動く:プレス、タイピング、カウンター、線描画、ハイライトステップ。
  • 実際の製品データのみ。スプリングはオーバーシュートの兆候が最大1つまで。タイピングにはなし。
  • 禁止:弾むようなイージング、グロー、UIクローム上のグラデーション、パーティクルバースト、無音ビート。
  • カメラがスケーリングするものには will-change(またはラスタライズトリック)を使用しない。

次へ:/motion-studio:springs で感触を調整。/motion-studio:ship-formats でフォーマットごとのリフレーミングと納品。

Individual skills in this repo

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

yazzang-homelab/motion-studio

Make Claude watch its own frames: critique.mjs evidence, harsh 7-axis scores, timestamped P0/P1/P2 problems in docs/review_log.md, fix the 3 worst, re-check, pass the gate. Use for 'critique it', 'review the frames', 'is it good'.

yazzang-homelab/motion-studio

Plan long-form or overnight films: director's brief (PLAN FIRST or GO, budget, definition of done), ANIMATION_GUIDE + STORYBOARD, chapter subagents, gates, chunked render. Use for 'overnight film', 'music video', '2-minute film'.

yazzang-homelab/motion-studio

Make a launch video, app or product reel, explainer or motion ad from code, end to end: brand assets from a URL, beat-grid shot list, synced sound, critique loop, all formats. Default for new video requests; not footage edits.

yazzang-homelab/motion-studio

Brand-asset stage of a product film (motion-reel runs the whole film): capture real screenshots, logo, colors and fonts from a URL, never redraw UI; brand story beats; voice + mascot. Use to grab or fix a brand's assets.

yazzang-homelab/motion-studio

Turn a reference (a frame, a video or an image library) into docs/style_guide.md and a beat-grid shot list: measure cuts, palette and pace, take grammar not content, wait for OK. Use when the user supplies or names a look.

yazzang-homelab/motion-studio

Build, debug or speed up the seek(t) render engine: render contract, canvas vs page capture, workers/subframes/chunks, determinism fixes, Remotion or HyperFrames handoff. Use for 'render is slow', 'frames differ', 'use Remotion'.

yazzang-homelab/motion-studio

Ship every format from one timeline, then package it: layout() reframing (never crop), render all formats, per-format checks, deliver.mjs, a brand skill, a service offer. Use for 'export 9:16 and 16:9', 'deliver', 'make a skill'.

yazzang-homelab/motion-studio

The viral one-line 'showreel for a résumé' prompt: why it works (anatomy), the credited quote, and seeded variants that avoid look-alike reels; runs it as an engine test. Use for that prompt, its variations, or a showreel.

yazzang-homelab/motion-studio

Score a film to its beat grid: measure a track (beats.mjs) or synthesize one (score.mjs), cue SFX from the film, add voice, mix to -14 LUFS / -1 dBTP at exact length. Use for 'add music', 'sync to the beat', 'SFX', 'loudness'.

yazzang-homelab/motion-studio

Make motion feel physical with closed-form springs from lib/motion.js: presets, springFromFeel, track() for multi-target values, loopTrack loops, indicators, text swaps. Use for 'feels linear', 'add bounce', 'easing to springs'.

yazzang-homelab/motion-studio

Scaffold a motion-studio film project (seek(t) renderer, springs, beat grid, synthesized sound, critique tools), install it, set up the browser, run doctor. Use for 'set up the motion studio', 'new film project', 'init studio'.

関連スキル