モーション仕様の作成
After Effectsコンポジションからアニメーションプロパティをすべてドキュメント化したタイムラインバーと詳細テーブルを、Figma上に直接生成します。
コンポーネントマークダウン(
.md)コンシューマー契約の範囲外です。 他のcreate-*スキルはコンポーネント.md({{skill:create-component-md}}が生成)を必要とし、そのrender-metaからレンダリングします。create-motionは意図的に例外です。その入力はAfter Effectsのタイムラインエクスポート({{ref:motion/export-timeline.jsx}})であり、Figmaコンポーネントのウォークスルーではありません。_base.jsonもextract-motionも.md内のMotionセクションも存在しません。このスキルは.mdを必要とせず、require-.md/fail-fast/whitelisted-readsリファクタリングにも参加しません。
実行契約(最初にお読みください)。
- このファイルは実行のための指示であり、編集するためのドキュメントではありません。スキルを呼び出す = After EffectsのタイムラインJSONからFigmaにモーション仕様をレンダリングします。
- この
SKILL.mdや他のスキルファイルを、たとえエディタで開かれていたりフォーカスされていたとしても、応答として決して編集しないでください。ユーザーが明示的にスキル自体の変更を要求した場合にのみスキルを変更してください。 - 入力タイムラインJSONは読み取り専用の信頼できる情報源です。決して編集しないでください。 このスキルが生成する唯一のアーティファクトはFigmaの注釈です。ファイル編集としてではなく、Figmaへのレンダリングリクエストのみを実行してください。
AskQuestionを呼び出したり、確認を要求したり、入力のために一時停止したりしないでください(Figmaへの書き込み前を含む、期待される出力に対して)。曖昧な場合は、最も防御可能なオプションを選択して続行してください。- 合法的な停止は2つだけです:(a) AEタイムラインJSONが欠落しているか無効な場合(ステップ4/5の収集+検証ゲート); (b) Figma MCP接続が切れている場合の1行での中断。
MCPアダプター
uspecs.config.json → mcpProviderを読み取ります。このスキル内のすべてのMCP呼び出しに対して、一致する列に従ってください。
| 操作 | figma-console | figma-mcp |
|---|---|---|
| 接続の確認 | figma_get_status | スキップ — 暗黙的。最初のuse_figma呼び出しが失敗した場合、ユーザーにMCPセットアップを確認するよう案内します。 |
| ファイルに移動 | URLを指定してfigma_navigate | URLからfileKeyを抽出(figma.com/design/:fileKey/...)。移動は不要。 |
| スクリーンショットを撮る | figma_take_screenshot | fileKey + nodeIdを指定してget_screenshot |
| Plugin JSを実行 | codeを指定してfigma_execute | fileKey、code、descriptionを指定してuse_figma。JSコードは同一 — ラッパーの変更は不要。 |
| コンポーネントを検索 | figma_search_components | query + fileKey + includeComponents: trueを指定してsearch_design_system |
| ファイル/コンポーネントデータを取得 | figma_get_file_data / figma_get_component | fileKey + nodeIdを指定してget_metadataまたはget_design_context |
| 変数を取得(ファイル全体) | figma_get_variables | use_figmaスクリプト: return await figma.variables.getLocalVariableCollectionsAsync(); |
| トークン値を取得 | figma_get_token_values | モード/コレクションごとに変数値を読み取るuse_figmaスクリプト |
| スタイルを取得 | figma_get_styles | includeStyles: trueを指定してsearch_design_system、またはuse_figma: return figma.getLocalPaintStyles(); |
| 選択範囲を取得 | figma_get_selection | use_figmaスクリプト: return figma.currentPage.selection.map(n => ({id: n.id, name: n.name, type: n.type})); |
figma-mcpはすべての呼び出しでfileKeyを必要とします。 ワークフローの開始時にユーザーのFigma URLから一度抽出してください。ブランチURL(figma.com/design/:fileKey/branch/:branchKey/:fileName)の場合は、:branchKeyをfileKeyとして使用します。
figma-mcp ページコンテキスト: use_figmaは呼び出しのたびにfigma.currentPageを最初のページにリセットします。スクリプトが前のステップのノードにgetNodeByIdAsync(ID)を介してアクセスする場合、ページコンテンツが読み込まれていない可能性があります — findAll、findOne、charactersは、ページがアクティブになるまでTypeErrorで失敗します。getNodeByIdAsyncの直後にこのページ読み込みブロックを挿入します。
let _p = node; while (_p.parent && _p.parent.type !== 'DOCUMENT') _p = _p.parent;
if (_p.type === 'PAGE') await figma.setCurrentPageAsync(_p);
これにより、PAGEの祖先まで遡り、そのコンテンツを読み込みます。Console MCPではこれは不要です — figma_executeはDesktopのページコンテキストを継承します。
期待される入力
ユーザーは以下のパターンのいずれかでこのスキルをトリガーします:
- {{skill:create-motion}} + ペーストされたJSON(クリップボードから、
{{ref:motion/export-timeline.jsx}}でエクスポート) - {{skill:create-motion}} + ファイル参照(例:
@motion-ex.jsonまたは.jsonファイルへのパス) - {{skill:create-motion}} + Figmaリンク(注釈を配置する先のページ/ファイル)
必須: エクスポートされたJSONデータ — インラインでペーストされるか、ファイルとして参照されます。
オプション:
- 配置先のFigmaページへのリンク(提供されない場合は、現在のページのビューポート中央に配置)
- アニメーションのスクリーンショットまたは録画
- アニメーションの目的の説明
ワークフロー
以下のチェックリストをコピーして、進行状況を更新してください:
タスクの進行状況:
- [ ] ステップ 1: 指示ファイルを読む
- [ ] ステップ 2: MCP接続を確認する
- [ ] ステップ 3: uspecs.config.jsonからテンプレートキーを読み取る
- [ ] ステップ 4: コンテキストを収集する(ペースト、ファイル参照、またはユーザーへのプロンプトによるJSON)
- [ ] ステップ 5: JSONを解析して検証する(segments[]とhasAnimatedSegmentsを含む)
- [ ] ステップ 6: データを変換する(事前計算されたセグメントを読み取り、トラック幅、タイムライン位置を計算)
- [ ] ステップ 7: 指示ファイルを再読み取り(エラーとアンチパターン、検証チェックリスト)して監査する
- [ ] ステップ 8: モーションテンプレートをインポートしてデタッチする
- [ ] ステップ 9: ヘッダーフィールドを入力する
- [ ] ステップ 10: タイムルーラーを生成する
- [ ] ステップ 11: タイムラインレイヤーをレンダリングする(レイヤーごとに1回のfigma_execute)
- [ ] ステップ 12: テンプレートを非表示にする
- [ ] ステップ 13: テーブル行をレンダリングする
- [ ] ステップ 14: 視覚的検証
ステップ 1: 指示を読む
agent-motion-instruction.mdを読んでください。
ステップ 2: MCP接続を確認する
uspecs.config.jsonからmcpProviderを読み取り、使用するFigma MCPを特定します。
figma-consoleの場合:
figma_get_status— Desktop Bridgeプラグインがアクティブであることを確認します- 接続に失敗した場合: 「Figma Desktopを開き、Desktop Bridgeプラグインを実行してください。その後、もう一度お試しください。」
figma-mcpの場合:
- 接続は最初の
use_figma呼び出しで暗黙的に検証されます。明示的なチェックは不要です。 - 最初の呼び出しが失敗した場合: 「MCP設定でFIGMA_API_KEYが正しく設定されていることを確認してください。」
ステップ 3: テンプレートキーを読み取る
ファイルuspecs.config.jsonを読み取り、以下を抽出します:
templateKeysオブジェクトからのmotionSpec値 →MOTION_TEMPLATE_KEYとして保存します
テンプレートキーが空の場合、ユーザーに次のように伝えてください:
モーション仕様のテンプレートキーが設定されていません。最初にFigmaテンプレートライブラリリンクを使用して{{skill:firstrun}}を実行してください。
ステップ 4: コンテキストを収集する
ユーザーが提供したものを確認します:
- JSONがすでに提供されている場合(インラインでペーストされたか、
@motion-ex.jsonのようなファイル参照として)→ それを読み取り、直接ステップ5に進みます。再度要求しないでください。 - Figmaリンク(配置先)のみでJSONがない場合 → プロンプト:
エクスポートされたJSONをペーストするか、
.jsonファイルを参照してください(例:@motion-ex.json)。 - 何も提供されていない場合 → プロンプト:
export-timeline.jsxからエクスポートされたJSONをペーストするか、.jsonファイルを参照してください。
Figmaの配置先リンクが提供された場合は、レンダリング(ステップ8)の前にfigma_navigateを使用して開いてください。
また、ユーザーが追加のコンテキストとして提供する任意のスクリーンショット、録画、または説明も受け入れます。
ステップ 5: JSONを解析して検証する
指示ファイル(JSONスキーマとJSON検証ルールのセクション)のスキーマと検証ルールに対して、クリップボードのJSONを検証します。検証に失敗した場合、どのフィールドが欠落しているか、または不正な形式かをユーザーに正確に伝え、再エクスポートを依頼してください。
ステップ 6: データを変換する
エクスポートスクリプトは、セグメント、値のフォーマット、バーラベル、イージングラベル、および変更なしのフィルタリングを事前計算します。エージェントはこれらを直接読み取り、レイアウトに依存する値のみを計算します。
6a. アニメーションなしレイヤーをスキップ — layer.hasAnimatedSegmentsを確認します。falseの場合、そのレイヤーをタイムラインとテーブルから除外します。
6b. 事前計算されたセグメントを読み取る — 各プロパティにはsegments[]配列があり、startMs、endMs、durationMs、fromValue、toValue、barLabel、easing、easingTypeが含まれます。これらの値を直接使用します — 手動計算は不要です。
6c. トラック幅とpxPerMsを計算する — pxPerMsは固定レートです。trackWidthは動的で、右側にティックラベルのパディングが付きます:
compDurationMs = composition.durationMs // JSONから直接読み取り
pxPerMs = 0.64 // 固定レート — 500msティックあたり約320px
trackWidth = max(compDurationMs * pxPerMs + 50, 1600) // データ領域 + 50pxラベルパディング、最小1600
trackWidthとpxPerMsをFigmaレンダリングコードに渡します。pxPerMsは固定レート(0.64)であり、trackWidth / compDurationMsから導出されるものではありません。バーの位置(barX、barWidth)はレンダリング時にFigmaコード内で計算されます — エージェントはセグメントごとの位置を計算しません。
レンダリング時に、#track-areaと#ruler-trackの両方をこの計算されたtrackWidthにリサイズします。親コンテナはHUGサイジングを使用し、自動的に拡張します。
6d. コンポジションメタをフォーマットする — 指示ファイルのComposition Metaルールに従います。COMPOSITION_METAとして保存します。
ステップ 7: 監査
指示ファイルを再読み取りし、以下に焦点を当てます:
- エラーとアンチパターンセクション
- 出力前検証チェックリスト
各ルールに対して変換されたデータを確認します。違反を修正します。
ステップ 8: テンプレートをインポートしてデタッチする
figma_executeを介して実行します(__MOTION_TEMPLATE_KEY__と__COMPONENT_NAME__を置き換えます):
const TEMPLATE_KEY = '__MOTION_TEMPLATE_KEY__';
const templateComponent = await figma.importComponentByKeyAsync(TEMPLATE_KEY);
const instance = templateComponent.createInstance();
const { x, y } = figma.viewport.center;
instance.x = x - instance.width / 2;
instance.y = y - instance.height / 2;
const frame = instance.detachInstance();
frame.name = '__COMPONENT_NAME__ Motion';
figma.currentPage.selection = [frame];
figma.viewport.scrollAndZoomIntoView([frame]);
return { frameId: frame.id };
返されたframeIdを保存します — 後続のすべてのステップで必要になります。
ステップ 9: ヘッダーフィールドを入力する
figma_executeを介して実行します(__FRAME_ID__、__COMPONENT_NAME__、__COMPOSITION_META__を置き換えます):
const FRAME_ID = '__FRAME_ID__';
const frame = await figma.getNodeByIdAsync(FRAME_ID);
const textNodes = frame.findAll(n => n.type === 'TEXT');
const fontSet = new Set();
const fontsToLoad = [];
for (const tn of textNodes) {
try {
const fn = tn.fontName;
if (fn && fn !== figma.mixed && fn.family) {
const key = fn.family + '|' + fn.style;
if (!fontSet.has(key)) { fontSet.add(key); fontsToLoad.push(fn); }
}
} catch {}
}
await Promise.all(fontsToLoad.map(f => figma.loadFontAsync(f).catch(() => {})));
const compName = frame.findOne(n => n.name === '#component-name');
if (compName) {
const t = compName.type === 'TEXT' ? compName : compName.findOne(n => n.type === 'TEXT');
if (t) t.characters = '__COMPONENT_NAME__';
}
const compDesc = frame.findOne(n => n.name === '#component-description');
if (compDesc) {
const t = compDesc.type === 'TEXT' ? compDesc : compDesc.findOne(n => n.type === 'TEXT');
if (t) t.characters = 'Motion Specification';
}
const compMeta = frame.findOne(n => n.name === '#composition-meta');
if (compMeta) {
const t = compMeta.type === 'TEXT' ? compMeta : compMeta.findOne(n => n.type === 'TEXT');
if (t) t.characters = '__COMPOSITION_META__';
}
return { success: true };
ステップ 10: タイムルーラーを生成する
figma_executeを介して実行します。理想的なトラック幅を計算し、#ruler-trackとすべての#track-areaノードをリサイズしてから、各間隔ごとに#tickをクローンします。
__FRAME_ID__、__COMP_DURATION_MS__(composition.durationMsから読み取り)、__TRACK_WIDTH__(ステップ6cで計算)、__PX_PER_MS__(固定0.64)を置き換えます:
const FRAME_ID = '__FRAME_ID__';
const COMP_DURATION_MS = __COMP_DURATION_MS__;
const TRACK_WIDTH = __TRACK_WIDTH__;
const PX_PER_MS = __PX_PER_MS__;
const frame = await figma.getNodeByIdAsync(FRAME_ID);
const rulerTrack = frame.findOne(n => n.name === '#ruler-track');
if (!rulerTrack) return { error: '#ruler-track not found' };
// ルーラートラックを計算された幅にリサイズ
rulerTrack.resize(TRACK_WIDTH, rulerTrack.height);
// すべての#track-areaノードをリサイズ(レイヤーテンプレート内およびクローンされたレイヤー内)
const trackAreas = frame.findAll(n => n.name === '#track-area');
for (const ta of trackAreas) {
ta.resize(TRACK_WIDTH, ta.height);
}
// ルーラートラック内の#tickテンプレートを見つける
const tickTemplate = rulerTrack.findOne(n => n.name === '#tick');
if (!tickTemplate) return { error: '#tick template not found in #ruler-track' };
// ティックテンプレートのテキストノードからフォントを読み込む
const tickTextNodes = tickTemplate.findAll(n => n.type === 'TEXT');
for (const tn of tickTextNodes) {
if (tn.characters.length > 0) {
try { await figma.loadFontAsync(tn.fontName); } catch {}
}
}
// ティック間隔: 6~12ティックを目指す
const tickInterval = COMP_DURATION_MS <= 300 ? 50
: COMP_DURATION_MS <= 600 ? 100
: COMP_DURATION_MS <= 1500 ? 250
: COMP_DURATION_MS <= 4000 ? 500
: COMP_DURATION_MS <= 10000 ? 1000
: 2000;
for (let ms = 0; ms <= COMP_DURATION_MS; ms += tickInterval) {
const xPos = ms * PX_PER_MS;
const tick = tickTemplate.clone();
rulerTrack.appendChild(tick);
tick.name = ms + 'ms';
tick.visible = true;
tick.x = xPos;
const label = tick.findOne(n => n.type === 'TEXT');
if (label) {
try { await figma.loadFontAsync(label.fontName); } catch {}
label.characters = ms + 'ms';
}
}
tickTemplate.visible = false;
return { success: true, trackWidth: TRACK_WIDTH, tickInterval: tickInterval };
ステップ 11: タイムラインレイヤーをレンダリングする
タイムアウトを避けるために、レイヤーごとに1回のfigma_execute呼び出しを実行します。各レイヤー(hasAnimatedSegmentsがtrueのもの)に対して、#layer-templateをクローンし、レイヤー名を設定してから、アニメーションプロパティごとに#property-templateをクローンし、バーを配置します。
すべての__PLACEHOLDER__値を置き換えます。