Communitygithub.com

0n6k4v-Coder/skills

After Effectsのタイムラインデータからモーション仕様の注釈を生成します。ユーザーが「モーション」「モーション仕様」「アニメーション仕様」「タイムライン」に言及した場合や、コンポーネントのアニメーションプロパティをドキュメント化したい場合に使用します。

skills とは?

このスキルは、After EffectsのタイムラインJSONデータを解析し、Figma上にモーション仕様の注釈(タイムラインバーと詳細テーブル)を直接生成します。従来のコンポーネントマークダウンを必要とする他のスキルとは異なり、このスキルは独立して動作し、ユーザーがエクスポートしたJSONデータを唯一の入力として受け取ります。主なワークフローは、MCP接続の確認、テンプレートキーの読み取り、JSONの検証と解析、タイムラバーの生成、レイヤーごとのアニメーションバーのレンダリング、そして最終的な視覚的検証を含みます。このスキルは、デザイナーやアニメーターがアニメーションプロパティを正確にドキュメント化し、チーム間でのコミュニケーションを円滑にするために設計されています。対応プラットフォームはFigma(Figma ConsoleまたはFigma MCP)で、JSコードは両方のアダプターで同一です。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/0n6k4v-Coder/skills/tree/HEAD/figma/uSpec/create-motion

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

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

ドキュメント

モーション仕様の作成

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-consolefigma-mcp
接続の確認figma_get_statusスキップ — 暗黙的。最初のuse_figma呼び出しが失敗した場合、ユーザーにMCPセットアップを確認するよう案内します。
ファイルに移動URLを指定してfigma_navigateURLからfileKeyを抽出(figma.com/design/:fileKey/...)。移動は不要。
スクリーンショットを撮るfigma_take_screenshotfileKey + nodeIdを指定してget_screenshot
Plugin JSを実行codeを指定してfigma_executefileKey、code、descriptionを指定してuse_figma。JSコードは同一 — ラッパーの変更は不要。
コンポーネントを検索figma_search_componentsquery + fileKey + includeComponents: trueを指定してsearch_design_system
ファイル/コンポーネントデータを取得figma_get_file_data / figma_get_componentfileKey + nodeIdを指定してget_metadataまたはget_design_context
変数を取得(ファイル全体)figma_get_variablesuse_figmaスクリプト: return await figma.variables.getLocalVariableCollectionsAsync();
トークン値を取得figma_get_token_valuesモード/コレクションごとに変数値を読み取るuse_figmaスクリプト
スタイルを取得figma_get_stylesincludeStyles: trueを指定してsearch_design_system、またはuse_figma: return figma.getLocalPaintStyles();
選択範囲を取得figma_get_selectionuse_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: コンテキストを収集する

ユーザーが提供したものを確認します:

  1. JSONがすでに提供されている場合(インラインでペーストされたか、@motion-ex.jsonのようなファイル参照として)→ それを読み取り、直接ステップ5に進みます。再度要求しないでください。
  2. Figmaリンク(配置先)のみでJSONがない場合 → プロンプト:

    エクスポートされたJSONをペーストするか、.jsonファイルを参照してください(例: @motion-ex.json)。

  3. 何も提供されていない場合 → プロンプト:

    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__値を置き換えます。

Individual skills in this repo

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

0n6k4v-Coder/skills

Translates Figma motion and animations into production-ready application code. Use when implementing animation/motion from a Figma design — user mentions "implement this motion", "add animation from Figma", "animate this component", provides a Figma URL whose node is animated, or when `get_design_context` returns motion data or instructs you to call `get_motion_context`.

0n6k4v-Coder/skills

Motion / animation context for the `use_figma` MCP tool — animating Figma nodes via manual keyframes, animation styles, easing, and timeline duration. Load alongside figma-use whenever a task involves adding, editing, or inspecting animation on a node.

0n6k4v-Coder/skills

Turn on Cache Components in a Next.js app and resolve the blocking routes it surfaces. Use when the user wants to enable, adopt, or migrate to Cache Components, flip the `cacheComponents` flag, work through a flood of blocking-prerender / instant validation errors, run the `cache-components-instant-false` codemod, or decide between opting routes out with `export const instant = false` and fixing them in place.

0n6k4v-Coder/skills

Optimize a Next.js app that has `cacheComponents: true` — either the static shell on first paint, or the in-app navigation between routes. Picks the matching diagnostic loop and runs it.

0n6k4v-Coder/skills

Verify Next.js runtime behavior after editing app code. Use this skill to confirm a change actually works in a running app — not just that it compiles or type-checks. Combines /_next/mcp (Next.js's view) with agent-browser (the browser's view). Requires a running `next dev`.

関連スキル