使い方ガイドへスキップ
design-handoff作者 Anthropic

Design Handoff スキル。

ブランドおよびデザインシステム作業のための Claude Code と Codex スキル:デザインから開発者へのハンドオフ仕様(レイアウト、トークン、コンポーネント状態、ブレークポイント)を生成します。

  • ブランドとデザインシステム
  • ハンドオフ仕様
anthropics/knowledge-work-plugins · design/skills/design-handoff/SKILL.mdSKILL.md
--- name: design-handoff description: Generate developer handoff specs from a design. Use when a design is ready for engineering and needs a spec sheet covering layout, design tokens, component props, interaction states, responsive breakpoints, edge cases, and animation details. --- ## Usage ## What to Include ## Principles ## Output ## Handoff Spec: [Feature/Screen Name] ## If Connectors Available
2026-09-14 にアップストリームファイルから読み取ったフロントマターとセクション見出し · 全3,939文字

01 できること

design-handoff スキルが Claude Code と Codex で行うこと

概要、ワークフロー、出力。いずれもスキルの SKILL.md から読み取った内容です。

SKILL.md より2026年9月14日読取 · 実行記録ではありません

スキル自身の言葉で

デザインからデベロッパー向けのハンドオフ資料を生成するもので、デザインがエンジニアリングに引き渡せる段階に達し、仕様書が必要なチームを対象としています。FigmaのURLを指定するか、それができない場合は説明文やスクリーンショットで代用してください。ビジュアル仕様、インタラクション仕様、コンテンツ仕様、エッジケース、アクセシビリティを順に処理します。

出力は、概要、レイアウト、使用するデザイントークン、コンポーネント、状態とインタラクション、レスポンシブ動作、エッジケース、アニメーションとモーション、アクセシビリティに関する注記の各セクションを備えたMarkdown形式のハンドオフ仕様書です。明記された4つの原則は、想定せずにすべてを明記すること、生の値ではなくトークンを参照すること、すべての状態を示すこと、そしてその挙動の理由を説明することです。

生成されるもの

  • 各トークンとその値、用途を一覧化したデザイントークンのテーブルです。
  • 各コンポーネントのバリアント、props、特殊な挙動に関する注記をまとめたコンポーネントテーブルです。
  • 要素、トリガー、アニメーション、時間、イージングを記録するアニメーションとモーションのテーブルです。
プロンプト例を見る ↗

仕組み

  1. 01
    デザインソースを特定する

    Figma URLがある場合、デザインはFigmaから取得されます。URLがない場合、スキルは文章による説明やスクリーンショットをもとに作業します。

  2. 02
    ビジュアルを明記する

    正確なパディング、マージン、幅、色・タイポグラフィ・スペーシングのデザイントークン参照、レスポンシブブレークポイント、コンポーネントのバリアントと状態です。

  3. 03
    インタラクションを明記する

    クリックおよびタップの挙動、ホバー状態、ジェスチャーサポート、そして時間とイージングを記録したトランジションです。

  4. 04
    コンテンツとエッジケースを網羅する

    文字数制限、切り捨て、空の状態、読み込み中およびエラー状態、さらに最小・最大のコンテンツ量、より長い多言語文字列、低速な接続、データの欠落です。

  5. 05
    アクセシビリティの詳細を追加する

    フォーカス順序、ARIAラベルとロール、キーボード操作、スクリーンリーダーによる読み上げです。

  6. 06
    テンプレートに沿って仕様書を生成する

    結果は、そのファイルのセクションとテーブル構造を用いたMarkdown形式のハンドオフ仕様書として記述されます。

02 適合性を確認

design-handoff スキルを使用するタイミング

この種のブランドおよびデザインシステム作業には、Claude Code または Codex で design-handoff スキルを使用します。適合性と制限事項は、スキル自体のファイルから取得されています。

適している場合

  • デザインが完成しエンジニアリングに引き渡す準備が整い、チームがレイアウト、トークン、コンポーネントのprops、状態、ブレークポイント、エッジケース、アニメーションを網羅する仕様書を必要としている場合。
  • プロジェクトトラッカーが接続されていて、ハンドオフを実装チケットに紐づけたい場合。

境界を知る

  • Figmaから正確に導き出された寸法、トークン値、書き出されたアセット、そして完全な仕様書は、デザインツールが接続されている場合にのみ得られます。
  • 仕様書の各セクションごとにサブタスクを設定するには、プロジェクトトラッカーが接続されている必要があります。

提供すべきもの

  • Figma URLまたはデザインの説明これはコマンドが受け取る引数であり、仕様書はこれをもとに生成されます。

03 スキルの内部

design-handoff スキルがClaude CodeとCodexに与えるルール

SKILL.mdがエージェントに設定する7つの具体的な指示、デフォルト、制限 — ファイルの中で結果を変える部分です。

  1. すべてを明記する

    最初の原則は「想定しない」ことです。何かが明記されていなければ、開発者は推測することになるため、ハンドオフはそれを網羅していなければなりません。

  2. トークンを参照し、生の値を使わない

    値はピクセル数値ではなく、spacing-md のようなトークン名として記述されます。

  3. すべての状態を表示

    default、hover、active、disabled、loading、error、empty のすべての状態が記載されている必要があります。

  4. 理由を説明する

    開発者が適切な判断を下せるように、動作と併せて根拠が示されます。例えばモバイルで折りたたまれる理由を説明します。

  5. エッジケースを明示的に尋ねる

    100件のアイテムがある場合はどうなるかといった境界に関する質問を挙げることで、その境界条件が仕様化されます。

  6. 技術スタックを伝える

    React と Tailwind のようにスタックを指定すると、そのスタックに関連する実装ノートが生成されます。

  7. Figma のリンクを共有する

    リンクがあることで、正確な寸法・トークン・コンポーネント情報が推測ではなく取得できるようになります。

04 実際に使う

Claude Code または Codex に design-handoff をインストール

npx skills add コマンドを実行し、エージェントで最初のタスクを実行して、結果をチェックリストで確認します。

Claude Code、Codex、または使用中のエージェントに design-handoff を追加

プロジェクトで実行してください。インストーラーが、どのエージェントに追加するかを尋ねます。

Terminal
npx skills add https://github.com/anthropics/knowledge-work-plugins --skill design-handoff

design/skills/design-handoff/SKILL.md 用の汎用的な skills CLI 形式です。リポジトリ側で独自のパスを記載している場合があります。

最初のブランドおよびデザインシステムの作業タスクをスキルに与える

スキル自身の用語で記述されています。角括弧の部分はご自身の内容に置き換えてください。

Starter prompt
Generate a developer handoff spec for the [checkout confirmation screen] in [Figma URL]. I need exact padding and margins, design token references instead of raw values, all component states including loading and error, and the responsive behavior at each breakpoint. We use [React + Tailwind], and please spec the empty state and what happens with [very long product names].

出典:SKILL.md をスキル自身の用語に沿って記述。

最初の結果を確認

SKILL.md 自体が正しい結果として示しているもの:

  • レスポンシブ動作テーブルには、768px未満のモバイル向けの行が空のプレースホルダーではなく記入されています。
  • エッジケースでは、データがない場合に何を表示するかが、truncation・読み込み中・エラー時の動作とともに指定されています。
  • アクセシビリティに関する注記には、フォーカス順序と必要な ARIA ラベルが記載されています。

OpenDesignではdesign-handoff を SKILL.md のリンクからインポートしてください:Plugins → Add → Skill → Import from link、その後トップバーで選択します。

05 オープンソースで追跡可能

ソース、ライセンス、検証

このページの情報の出所と、最終確認日時です。

Author
Anthropic
スキルファイル
design/skills/design-handoff/SKILL.md 検証時に記録されたコンテンツチェックサム; コミット 8f877b6
License
Apache-2.0 LICENSE より。
リポジトリスター数
24,012 2026年9月14日時点のGitHubスナップショット。anthropics/knowledge-work-pluginsリポジトリ全体の数値です。このカタログには7つのスキルが含まれています。design-handoffの評価や使用回数ではありません。
OpenDesign により検証済み
2026-09-14 ソースファイル、パス、ライセンステキスト、スター数を確認済み。OpenDesign 本体にはバンドルされていません(2026-08-28 確認)。このページには実行記録がありません。

SKILL.md の中身

  1. 使い方/design-handoff の呼び出し方法と、$ARGUMENTS および @$1 のプレースホルダーを示します。
  2. 含めるべき内容視覚・インタラクション・コンテンツ・エッジケース・アクセシビリティの仕様など、カバーすべきカテゴリを列挙します。
  3. 原則4つのルール:思い込まない、トークンを使う、すべての状態を示す、理由を説明する。
  4. 出力見出しと表を備えたMarkdown形式のHandoff Specテンプレートを提供します。
  5. コネクタが利用可能な場合接続されたデザインツールとプロジェクトトラッカー向けの条件付き追加項目です。
  6. ヒント3つのヒント:Figmaのリンクを共有する、エッジケースに言及する、技術スタックを指定する。
スキル自身による説明
「デザインから開発者向けハンドオフ仕様を生成します。デザインがエンジニアリングに向けて準備が整い、レイアウト、デザイントークン、コンポーネントのプロパティ、インタラクション状態、レスポンシブブレークポイント、エッジケース、アニメーションの詳細を網羅した仕様書が必要な場合に使用します。」

SKILL.md のフロントマターの説明です。完全なファイルは約 3,939 文字です。GitHub で完全なファイルを読む。

06 インストールする前に

design-handoff スキルに関するよくある質問

回答は 2026-09-14 時点で読んだ SKILL.md に基づくもので、記録された実行結果によるものではありません。

デザインツールが連携されている場合、何が変わりますか?

Figmaから正確な寸法、トークン、コンポーネントの仕様を直接取得し、アセットの書き出しや完全な仕様書の生成が可能になります。

Design Handoff

実際のブランドと design-system の作業タスクで design-handoff を実行します。

OpenDesign をダウンロードし、SKILL.md リンクから design-handoff をインポートし、上記のプロンプトを貼り付けて、結果の前に計画を確認します。

ターミナル
npx skills add https://github.com/anthropics/knowledge-work-plugins --skill design-handoff

OpenDesign デスクトップ版

ひとつのデザインシステムで、すべての制作物をブランドらしく

完全な Vibe Design Workspace で、同じブランドルールを Web サイト、スライド、操作できるプロトタイプ、ダッシュボード、画像、HTML 動画に展開できます。ローカルの Codex、Claude Code、Cursor などを接続して無料で制作しましょう。

  • Web、スライド、プロトタイプ、ダッシュボード、画像、動画
  • 140+ のデザインシステムと完全なテンプレート/スキルライブラリ
  • ローカル Codex と 21+ のコーディングエージェントを接続 · 無料
無料ダウンロード

macOS と Windows に対応