Communitygithub.com

tmnhutwork/Landingpage-Photo-Retouch

Figmaデザインを本番コードに変換し、1:1の忠実度を実現します。FigmaファイルからUIコードを実装する際、ユーザーが「デザインを実装」「コード生成」「コンポーネント実装」と発言した場合、Figma URLを提供した場合、またはFigma仕様に一致するコンポーネントの構築を依頼した場合に使用します。Figmaキャンバスへの書き込みには `figma-use` を使用してください。

Landingpage-Photo-Retouch とは?

このスキルは、Figmaデザインをピクセルパーフェクトな本番コードに変換するための構造化ワークフローを提供します。AIエージェントは、Figma MCPサーバーと連携し、ファイルキーとノードIDを抽出してデザインコンテキストを取得し、ビジュアルリファレンスのスクリーンショットをキャプチャし、アセットをダウンロードした上で、プロジェクトの規約に従ってコードを生成します。主にClaude CodeやCodexなどのAIコーディングエージェント向けに設計されており、Figma MCPサーバー(リモートおよびデスクトップ)と統合して動作します。ワークフローは、デザイントークンのマッピング、既存コンポーネントの再利用、1:1の視覚的パリティの達成を重視し、不必要な新規作成を避けます。また、実装前のコンテキスト取得、段階的な検証、逸脱のドキュメント化といったベストプラクティスを推奨し、一貫性と高品質な実装を保証します。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/tmnhutwork/Landingpage-Photo-Retouch/tree/HEAD/.agents/skills/figma-implement-design

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

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

ドキュメント

デザインの実装

概要

このスキルは、Figmaデザインをピクセルパーフェクトな本番コードに変換するための構造化ワークフローを提供します。Figma MCPサーバーとの一貫した統合、デザイントークンの適切な使用、およびデザインとの1:1の視覚的パリティを保証します。

スキルの範囲

  • 成果物がユーザーのリポジトリ内のコードである場合にこのスキルを使用します。
  • ユーザーがFigma内のノードの作成/編集/削除を依頼した場合は、figma-useに切り替えます。
  • ユーザーがコードや説明からFigmaの全ページ画面を構築または更新するよう依頼した場合は、figma-generate-designに切り替えます。
  • ユーザーがCode Connectマッピングのみを依頼した場合は、figma-code-connect-componentsに切り替えます。
  • ユーザーが再利用可能なエージェントルール(CLAUDE.md/AGENTS.md)を作成するよう依頼した場合は、figma-create-design-system-rulesに切り替えます。

前提条件

  • Figma MCPサーバーが接続され、アクセス可能であること
  • ユーザーが以下の形式でFigma URLを提供すること: https://figma.com/design/:fileKey/:fileName?node-id=1-2
    • :fileKey はファイルキー
    • 1-2 はノードID(実装する特定のコンポーネントまたはフレーム)
  • または figma-desktop MCPを使用する場合: ユーザーはFigmaデスクトップアプリでノードを直接選択できます(URLは不要)
  • プロジェクトに確立されたデザインシステムまたはコンポーネントライブラリがあること(推奨)

必須ワークフロー

以下の手順を順に実行してください。手順をスキップしないでください。

ステップ1: ノードIDの取得

オプションA: Figma URLから解析

ユーザーがFigma URLを提供した場合、ファイルキーとノードIDを抽出してMCPツールの引数として渡します。

URL形式: https://figma.com/design/:fileKey/:fileName?node-id=1-2

抽出:

  • ファイルキー: :fileKey(/design/ の後のセグメント)
  • ノードID: 1-2(node-id クエリパラメータの値)

注: ローカルのデスクトップMCP(figma-desktop)を使用する場合、ツール呼び出しのパラメータとして fileKey は渡されません。サーバーは自動的に現在開いているファイルを使用するため、nodeId のみが必要です。

例:

  • URL: https://figma.com/design/kL9xQn2VwM8pYrTb4ZcHjF/DesignSystem?node-id=42-15
  • ファイルキー: kL9xQn2VwM8pYrTb4ZcHjF
  • ノードID: 42-15

オプションB: Figmaデスクトップアプリの現在の選択を使用(figma-desktop MCPのみ)

figma-desktop MCPを使用しており、ユーザーがURLを提供していない場合、ツールはデスクトップアプリで開かれているFigmaファイルの現在選択されているノードを自動的に使用します。

注: 選択ベースのプロンプトは figma-desktop MCPサーバーでのみ機能します。リモートサーバーは、コンテキストを抽出するためにフレームまたはレイヤーへのリンクが必要です。ユーザーはノードが選択された状態でFigmaデスクトップアプリを開いている必要があります。

ステップ2: デザインコンテキストの取得

抽出したファイルキーとノードIDを使用して get_design_context を実行します。

get_design_context(fileKey=":fileKey", nodeId="1-2")

これにより、以下の構造化データが提供されます:

  • レイアウトプロパティ(Auto Layout、制約、サイズ設定)
  • タイポグラフィ仕様
  • カラー値とデザイントークン
  • コンポーネント構造とバリアント
  • スペーシングとパディングの値

応答が大きすぎる、または切り捨てられている場合:

  1. get_metadata(fileKey=":fileKey", nodeId="1-2") を実行して高レベルのノードマップを取得します
  2. メタデータから必要な特定の子ノードを特定します
  3. get_design_context(fileKey=":fileKey", nodeId=":childNodeId") で個々の子ノードを取得します

ステップ3: ビジュアルリファレンスのキャプチャ

同じファイルキーとノードIDを使用して get_screenshot を実行し、ビジュアルリファレンスを取得します。

get_screenshot(fileKey=":fileKey", nodeId="1-2")

このスクリーンショットは視覚的な検証のための真実の情報源として機能します。実装中はアクセス可能な状態に保ってください。

ステップ4: 必要なアセットのダウンロード

Figma MCPサーバーから返されたアセット(画像、アイコン、SVG)をダウンロードします。

重要: 以下のアセットルールに従ってください:

  • Figma MCPサーバーが画像またはSVGの localhost ソースを返した場合、そのソースを直接使用します
  • 新しいアイコンパッケージをインポートしたり追加したりしないでください。すべてのアセットはFigmaペイロードから取得する必要があります
  • localhost ソースが提供されている場合、プレースホルダーを使用したり作成したりしないでください
  • アセットはFigma MCPサーバーの組み込みアセットエンドポイントを通じて提供されます

ステップ5: プロジェクト規約への変換

Figmaの出力をこのプロジェクトのフレームワーク、スタイル、および規約に変換します。

主要な原則:

  • Figma MCPの出力(通常はReact + Tailwind)は、デザインと動作の表現として扱い、最終的なコードスタイルとしては扱いません
  • Tailwindのユーティリティクラスをプロジェクトが好むユーティリティまたはデザインシステムトークンに置き換えます
  • 機能を複製する代わりに、既存のコンポーネント(ボタン、入力、タイポグラフィ、アイコンラッパー)を再利用します
  • プロジェクトのカラーシステム、タイポグラフィスケール、およびスペーシングトークンを一貫して使用します
  • 既存のルーティング、状態管理、およびデータ取得パターンを尊重します

ステップ6: 1:1の視覚的パリティの達成

Figmaデザインとのピクセルパーフェクトな視覚的パリティを目指します。

ガイドライン:

  • Figmaの忠実度を優先してデザインを正確に一致させます
  • ハードコードされた値を避け、可能な場合はFigmaのデザイントークンを使用します
  • デザインシステムトークンとFigma仕様の間に矛盾がある場合、デザインシステムトークンを優先しますが、視覚を一致させるためにスペーシングやサイズを最小限調整します
  • アクセシビリティのためにWCAG要件に従います
  • 必要に応じてコンポーネントのドキュメントを追加します

ステップ7: Figmaに対する検証

完了とマークする前に、最終的なUIをFigmaスクリーンショットと照らし合わせて検証します。

検証チェックリスト:

  • レイアウトが一致する(スペーシング、配置、サイズ設定)
  • タイポグラフィが一致する(フォント、サイズ、ウェイト、行の高さ)
  • 色が正確に一致する
  • インタラクティブな状態が設計通りに機能する(ホバー、アクティブ、無効)
  • レスポンシブ動作がFigmaの制約に従う
  • アセットが正しくレンダリングされる
  • アクセシビリティ基準が満たされている

実装ルール

コンポーネントの整理

  • UIコンポーネントはプロジェクトの指定されたデザインシステムディレクトリに配置します
  • プロジェクトのコンポーネント命名規則に従います
  • 動的な値に本当に必要な場合を除き、インラインスタイルを避けます

デザインシステムの統合

  • 可能な場合は常にプロジェクトのデザインシステムのコンポーネントを使用します
  • Figmaデザイントークンをプロジェクトのデザイントークンにマッピングします
  • 一致するコンポーネントが存在する場合、新しいものを作成するのではなく拡張します
  • デザインシステムに追加された新しいコンポーネントを文書化します

コード品質

  • ハードコードされた値を避け、定数またはデザイントークンに抽出します
  • コンポーネントは構成可能で再利用可能に保ちます
  • コンポーネントのプロップにTypeScript型を追加します
  • エクスポートされたコンポーネントにJSDocコメントを含めます

例

例1: ボタンコンポーネントの実装

ユーザーが言う: "このFigmaボタンコンポーネントを実装してください: https://figma.com/design/kL9xQn2VwM8pYrTb4ZcHjF/DesignSystem?node-id=42-15"

アクション:

  1. URLを解析して fileKey=kL9xQn2VwM8pYrTb4ZcHjF、nodeId=42-15 を抽出します
  2. get_design_context(fileKey="kL9xQn2VwM8pYrTb4ZcHjF", nodeId="42-15") を実行します
  3. ビジュアルリファレンスとして get_screenshot(fileKey="kL9xQn2VwM8pYrTb4ZcHjF", nodeId="42-15") を実行します
  4. アセットエンドポイントからボタンアイコンをダウンロードします
  5. プロジェクトに既存のボタンコンポーネントがあるか確認します
  6. ある場合は新しいバリアントで拡張し、ない場合はプロジェクトの規約を使用して新しいコンポーネントを作成します
  7. Figmaの色をプロジェクトのデザイントークン(例: primary-500、primary-hover)にマッピングします
  8. スクリーンショットに対してパディング、ボーダー半径、タイポグラフィを検証します

結果: Figmaデザインに一致し、プロジェクトのデザインシステムと統合されたボタンコンポーネント。

例2: ダッシュボードレイアウトの構築

ユーザーが言う: "このダッシュボードを構築してください: https://figma.com/design/pR8mNv5KqXzGwY2JtCfL4D/Dashboard?node-id=10-5"

アクション:

  1. URLを解析して fileKey=pR8mNv5KqXzGwY2JtCfL4D、nodeId=10-5 を抽出します
  2. ページ構造を把握するために get_metadata(fileKey="pR8mNv5KqXzGwY2JtCfL4D", nodeId="10-5") を実行します
  3. メタデータから主要セクション(ヘッダー、サイドバー、コンテンツエリア、カード)とその子ノードIDを特定します
  4. 各主要セクションに対して get_design_context(fileKey="pR8mNv5KqXzGwY2JtCfL4D", nodeId=":childNodeId") を実行します
  5. 全ページのスクリーンショットとして get_screenshot(fileKey="pR8mNv5KqXzGwY2JtCfL4D", nodeId="10-5") を実行します
  6. すべてのアセット(ロゴ、アイコン、チャート)をダウンロードします
  7. プロジェクトのレイアウトプリミティブを使用してレイアウトを構築します
  8. 可能な場合は既存のコンポーネントを使用して各セクションを実装します
  9. Figmaの制約に対してレスポンシブ動作を検証します

結果: レスポンシブレイアウトを備えた、Figmaデザインに一致する完全なダッシュボード。

ベストプラクティス

常にコンテキストから始める

前提に基づいて実装しないでください。常に最初に get_design_context と get_screenshot を取得してください。

段階的な検証

実装中に頻繁に検証し、最後だけではありません。これにより問題を早期に発見できます。

逸脱の文書化

Figmaデザインから逸脱する必要がある場合(例: アクセシビリティや技術的な制約のため)、コードコメントにその理由を文書化します。

新規作成よりも再利用

新しいコンポーネントを作成する前に、常に既存のコンポーネントを確認してください。コードベース全体の一貫性は、正確なFigmaの複製よりも重要です。

デザインシステムを優先

迷った場合は、文字通りのFigma変換よりもプロジェクトのデザインシステムパターンを優先します。

一般的な問題と解決策

問題: Figmaの出力が切り捨てられる

原因: デザインが複雑すぎるか、ネストされたレイヤーが多すぎて1回の応答で返せない。 解決策: get_metadata を使用してノード構造を取得し、その後 get_design_context で特定のノードを個別に取得します。

問題: 実装後にデザインが一致しない

原因: 実装されたコードと元のFigmaデザインの間に視覚的な不一致がある。 解決策: ステップ3のスクリーンショットと並べて比較します。デザインコンテキストデータのスペーシング、色、タイポグラフィの値を確認します。

問題: アセットが読み込まれない

原因: Figma MCPサーバーのアセットエンドポイントにアクセスできないか、URLが変更されている。 解決策: Figma MCPサーバーのアセットエンドポイントにアクセスできることを確認します。サーバーは localhost URLでアセットを提供します。これらを変更せずに直接使用します。

問題: デザイントークンの値がFigmaと異なる

原因: プロジェクトのデザインシステムトークンがFigmaデザインで指定された値と異なる。 解決策: プロジェクトトークンがFigmaの値と異なる場合、一貫性のためにプロジェクトトークンを優先しますが、視覚的な忠実度を維持するためにスペーシング/サイズを調整します。

デザイン実装について

Figma実装ワークフローは、デザインをコードに変換するための信頼性の高いプロセスを確立します:

デザイナーへ: 実装がデザインとピクセルパーフェクトに一致することへの自信。 開発者へ: 推測を排除し、やり取りの修正を減らす構造化されたアプローチ。 チームへ: デザインシステムの整合性を維持する、一貫性のある高品質な実装。

このワークフローに従うことで、すべてのFigmaデザインが同じレベルの注意と詳細さで実装されることが保証されます。

追加リソース

Individual skills in this repo

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

tmnhutwork/Landingpage-Photo-Retouch

Run a WCAG 2.1 AA accessibility audit on a design or page. Trigger with "audit accessibility", "check a11y", "is this accessible?", or when reviewing a design for color contrast, keyboard navigation, touch target size, or screen reader behavior before handoff.

tmnhutwork/Landingpage-Photo-Retouch

Get structured design feedback on usability, hierarchy, and consistency. Trigger with "review this design", "critique this mockup", "what do you think of this screen?", or when sharing a Figma link or screenshot for feedback at any stage from exploration to final polish.

tmnhutwork/Landingpage-Photo-Retouch

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.

tmnhutwork/Landingpage-Photo-Retouch

Audit, document, or extend your design system. Use when checking for naming inconsistencies or hardcoded values across components, writing documentation for a component's variants, states, and accessibility notes, or designing a new pattern that fits the existing system.

tmnhutwork/Landingpage-Photo-Retouch

Synthesize user research into themes, insights, and recommendations. Use when you have interview transcripts, survey results, usability test notes, support tickets, or NPS responses that need to be distilled into patterns, user segments, and prioritized next steps.

tmnhutwork/Landingpage-Photo-Retouch

Plan, conduct, and synthesize user research. Trigger with "user research plan", "interview guide", "usability test", "survey design", "research questions", or when the user needs help with any aspect of understanding their users through research.

tmnhutwork/Landingpage-Photo-Retouch

Write or review UX copy — microcopy, error messages, empty states, CTAs. Trigger with "write copy for", "what should this button say?", "review this error message", or when naming a CTA, wording a confirmation dialog, filling an empty state, or writing onboarding text.

tmnhutwork/Landingpage-Photo-Retouch

Design banners for social media, ads, website heroes, creative assets, and print. Multiple art direction options with AI-generated visuals. Actions: design, create, generate banner. Platforms: Facebook, Twitter/X, LinkedIn, YouTube, Instagram, Google Display, website hero, print. Styles: minimalist, gradient, bold typography, photo-based, illustrated, geometric, retro, glassmorphism, 3D, neon, duotone, editorial, collage. Uses ui-ux-pro-max, frontend-design, ai-artist, ai-multimodal skills.

tmnhutwork/Landingpage-Photo-Retouch

Brand voice, visual identity, messaging frameworks, asset management, brand consistency. Activate for branded content, tone of voice, marketing assets, brand compliance, style guides.

tmnhutwork/Landingpage-Photo-Retouch

Comprehensive design skill: brand identity, design tokens, UI styling, logo generation (55 styles, Gemini AI), corporate identity program (50 deliverables, CIP mockups), HTML presentations (Chart.js), banner design (22 styles, social/ads/web/print), icon design (15 styles, SVG, Gemini 3.1 Pro), social photos (HTML→screenshot, multi-platform). Actions: design logo, create CIP, generate mockups, build slides, design banner, generate icon, create social photos, social media images, brand identity, design system. Platforms: Facebook, Twitter, LinkedIn, YouTube, Instagram, Pinterest, TikTok, Threads, Google Ads.

tmnhutwork/Landingpage-Photo-Retouch

Audit, document, or extend your design system. Use when checking for naming inconsistencies or hardcoded values across components, writing documentation for a component's variants, states, and accessibility notes, or designing a new pattern that fits the existing system.

tmnhutwork/Landingpage-Photo-Retouch

Use the Figma MCP server to fetch design context, screenshots, variables, and assets from Figma, and to translate Figma nodes into production code. Trigger when a task involves Figma URLs, node IDs, design-to-code implementation, or Figma MCP setup and troubleshooting.

tmnhutwork/Landingpage-Photo-Retouch

Create strategic HTML presentations with Chart.js, design tokens, responsive layouts, copywriting formulas, and contextual slide strategies.

tmnhutwork/Landingpage-Photo-Retouch

Create beautiful, accessible user interfaces with shadcn/ui components (built on Radix UI + Tailwind), Tailwind CSS utility-first styling, and canvas-based visual designs. Use when building user interfaces, implementing design systems, creating responsive layouts, adding accessible components (dialogs, dropdowns, forms, tables), customizing themes and colors, implementing dark mode, generating visual designs and posters, or establishing consistent styling patterns across applications.

tmnhutwork/Landingpage-Photo-Retouch

UI/UX design intelligence for web, mobile, and desktop. This skill should be used when designing, building, reviewing, or fixing interfaces, including pages, components, design systems, accessibility, interaction, responsive layout, typography, color, charts, and stack-specific UI implementation. Searchable local data: 79 searchable styles (50 active), 192 product palettes and reasoning profiles, 74 font pairings, 119 UX guidelines, 105 icons, 17 GSAP presets, 25 chart types, and 22 stacks.

関連スキル