Communitygithub.com

Implémenter un Design Figma

Traduit les designs Figma en code d'application prêt pour la production avec une fidélité visuelle 1:1. À utiliser lors de l'implémentation de code UI à partir de fichiers Figma, lorsque l'utilisateur mentionne « implémenter un design », « générer du code », « implémenter un composant », fournit des URL Figma ou demande de construire des composants correspondant aux spécifications Figma. Pour les écritures sur le canevas Figma via `use_figma`, utilisez `figma-use`.

Qu'est-ce que Implémenter un Design Figma ?

Cette compétence fournit un flux de travail structuré pour transformer des designs Figma en code prêt pour la production avec une précision pixel par pixel. Elle garantit une intégration cohérente avec le serveur Figma MCP, l'utilisation appropriée des jetons de design et une parité visuelle 1:1 avec les designs originaux. Le processus en sept étapes commence par l'extraction de l'identifiant du nœud à partir d'une URL Figma ou de la sélection dans l'application de bureau, puis la récupération du contexte de design (propriétés de mise en page, typographie, couleurs, structure des composants), une capture d'écran comme référence visuelle, le téléchargement des ressources nécessaires, la traduction en conventions de projet, l'obtention d'une parité visuelle parfaite et la validation finale par rapport à la capture Figma. Cette compétence est adaptée aux agents utilisant le serveur Figma MCP (à la fois à distance et de bureau). Elle met l'accent sur la réutilisation des composants existants d'un système de design, l'utilisation de jetons de design plutôt que de valeurs codées en dur, et la validation incrémentale tout au long de l'implémentation pour garantir des résultats de haute qualité. Des exemples concrets, comme l'implémentation d'un bouton ou la construction d'une mise en page de tableau de bord, illustrent l'application pratique du flux de travail. Des conseils de dépannage couvrent les problèmes courants tels que les réponses tronquées, les divergences visuelles, les ressources manquantes et les conflits de jetons de design.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Implémenter un Design

Aperçu

Cette compétence fournit un flux de travail structuré pour traduire des designs Figma en code prêt pour la production avec une précision pixel par pixel. Elle garantit une intégration cohérente avec le serveur Figma MCP, l'utilisation appropriée des jetons de design et une parité visuelle 1:1 avec les designs.

Limites de la compétence

  • Utilisez cette compétence lorsque le livrable est du code dans le dépôt de l'utilisateur.
  • Si l'utilisateur demande de créer/modifier/supprimer des nœuds dans Figma lui-même, passez à figma-use.
  • Si l'utilisateur demande de construire ou de mettre à jour un écran pleine page dans Figma à partir de code ou d'une description, passez à figma-generate-design.
  • Si l'utilisateur demande uniquement des correspondances Code Connect, passez à figma-code-connect-components.
  • Si l'utilisateur demande de rédiger des règles d'agent réutilisables (CLAUDE.md/AGENTS.md), passez à figma-create-design-system-rules.

Prérequis

  • Le serveur Figma MCP doit être connecté et accessible
  • L'utilisateur doit fournir une URL Figma au format : https://figma.com/design/:fileKey/:fileName?node-id=1-2
    • :fileKey est la clé du fichier
    • 1-2 est l'identifiant du nœud (le composant ou le cadre spécifique à implémenter)
  • OU lors de l'utilisation de figma-desktop MCP : l'utilisateur peut sélectionner un nœud directement dans l'application de bureau Figma (aucune URL requise)
  • Le projet doit avoir un système de design ou une bibliothèque de composants établi (recommandé)

Flux de travail requis

Suivez ces étapes dans l'ordre. Ne sautez pas d'étapes.

Étape 1 : Obtenir l'identifiant du nœud

Option A : Analyser à partir de l'URL Figma

Lorsque l'utilisateur fournit une URL Figma, extrayez la clé du fichier et l'identifiant du nœud à passer comme arguments aux outils MCP.

Format de l'URL : https://figma.com/design/:fileKey/:fileName?node-id=1-2

Extraire :

  • Clé du fichier : :fileKey (le segment après /design/)
  • Identifiant du nœud : 1-2 (la valeur du paramètre de requête node-id)

Remarque : Lors de l'utilisation du MCP de bureau local (figma-desktop), fileKey n'est pas passé comme paramètre aux appels d'outils. Le serveur utilise automatiquement le fichier actuellement ouvert, donc seul nodeId est nécessaire.

Exemple :

  • URL : https://figma.com/design/kL9xQn2VwM8pYrTb4ZcHjF/DesignSystem?node-id=42-15
  • Clé du fichier : kL9xQn2VwM8pYrTb4ZcHjF
  • Identifiant du nœud : 42-15

Option B : Utiliser la sélection actuelle de l'application de bureau Figma (figma-desktop MCP uniquement)

Lors de l'utilisation du MCP figma-desktop et que l'utilisateur n'a PAS fourni d'URL, les outils utilisent automatiquement le nœud actuellement sélectionné dans le fichier Figma ouvert dans l'application de bureau.

Remarque : La sollicitation basée sur la sélection ne fonctionne qu'avec le serveur MCP figma-desktop. Le serveur distant nécessite un lien vers un cadre ou un calque pour extraire le contexte. L'utilisateur doit avoir l'application de bureau Figma ouverte avec un nœud sélectionné.

Étape 2 : Récupérer le contexte de design

Exécutez get_design_context avec la clé du fichier et l'identifiant du nœud extraits.

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

Cela fournit les données structurées incluant :

  • Propriétés de mise en page (Auto Layout, contraintes, dimensionnement)
  • Spécifications typographiques
  • Valeurs de couleur et jetons de design
  • Structure des composants et variantes
  • Valeurs d'espacement et de remplissage

Si la réponse est trop volumineuse ou tronquée :

  1. Exécutez get_metadata(fileKey=":fileKey", nodeId="1-2") pour obtenir la carte des nœuds de haut niveau
  2. Identifiez les nœuds enfants spécifiques nécessaires à partir des métadonnées
  3. Récupérez les nœuds enfants individuels avec get_design_context(fileKey=":fileKey", nodeId=":childNodeId")

Étape 3 : Capturer une référence visuelle

Exécutez get_screenshot avec la même clé de fichier et le même identifiant de nœud pour une référence visuelle.

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

Cette capture d'écran sert de source de vérité pour la validation visuelle. Gardez-la accessible tout au long de l'implémentation.

Étape 4 : Télécharger les ressources requises

Téléchargez toutes les ressources (images, icônes, SVG) renvoyées par le serveur Figma MCP.

IMPORTANT : Suivez ces règles concernant les ressources :

  • Si le serveur Figma MCP renvoie une source localhost pour une image ou un SVG, utilisez cette source directement
  • N'IMPORTEZ PAS et n'ajoutez PAS de nouveaux packages d'icônes - toutes les ressources doivent provenir de la charge utile Figma
  • N'UTILISEZ PAS et ne créez PAS d'espaces réservés si une source localhost est fournie
  • Les ressources sont servies via le point de terminaison de ressources intégré du serveur Figma MCP

Étape 5 : Traduire selon les conventions du projet

Traduisez la sortie Figma dans le framework, les styles et les conventions de ce projet.

Principes clés :

  • Considérez la sortie Figma MCP (généralement React + Tailwind) comme une représentation du design et du comportement, et non comme un style de code final
  • Remplacez les classes utilitaires Tailwind par les utilitaires ou les jetons de système de design préférés du projet
  • Réutilisez les composants existants (boutons, champs de saisie, typographie, wrappers d'icônes) au lieu de dupliquer les fonctionnalités
  • Utilisez le système de couleurs, l'échelle typographique et les jetons d'espacement du projet de manière cohérente
  • Respectez les modèles de routage, de gestion d'état et de récupération de données existants

Étape 6 : Atteindre la parité visuelle 1:1

Efforcez-vous d'obtenir une parité visuelle pixel parfait avec le design Figma.

Directives :

  • Donnez la priorité à la fidélité Figma pour correspondre exactement aux designs
  • Évitez les valeurs codées en dur - utilisez les jetons de design de Figma lorsqu'ils sont disponibles
  • En cas de conflit entre les jetons du système de design et les spécifications Figma, préférez les jetons du système de design mais ajustez l'espacement ou les tailles de manière minimale pour correspondre aux visuels
  • Suivez les exigences WCAG pour l'accessibilité
  • Ajoutez de la documentation pour les composants si nécessaire

Étape 7 : Valider par rapport à Figma

Avant de marquer comme terminé, validez l'interface utilisateur finale par rapport à la capture d'écran Figma.

Liste de vérification de validation :

  • La mise en page correspond (espacement, alignement, dimensionnement)
  • La typographie correspond (police, taille, graisse, hauteur de ligne)
  • Les couleurs correspondent exactement
  • Les états interactifs fonctionnent comme conçu (survol, actif, désactivé)
  • Le comportement réactif suit les contraintes Figma
  • Les ressources s'affichent correctement
  • Les normes d'accessibilité sont respectées

Règles d'implémentation

Organisation des composants

  • Placez les composants d'interface utilisateur dans le répertoire du système de design désigné du projet
  • Suivez les conventions de nommage des composants du projet
  • Évitez les styles en ligne sauf s'ils sont vraiment nécessaires pour des valeurs dynamiques

Intégration du système de design

  • Utilisez TOUJOURS les composants du système de design du projet lorsque c'est possible
  • Faites correspondre les jetons de design Figma aux jetons de design du projet
  • Lorsqu'un composant correspondant existe, étendez-le plutôt que d'en créer un nouveau
  • Documentez tout nouveau composant ajouté au système de design

Qualité du code

  • Évitez les valeurs codées en dur - extrayez-les vers des constantes ou des jetons de design
  • Gardez les composants composables et réutilisables
  • Ajoutez des types TypeScript pour les props des composants
  • Incluez des commentaires JSDoc pour les composants exportés

Exemples

Exemple 1 : Implémenter un composant Bouton

L'utilisateur dit : « Implémente ce composant bouton Figma : https://figma.com/design/kL9xQn2VwM8pYrTb4ZcHjF/DesignSystem?node-id=42-15 »

Actions :

  1. Analyser l'URL pour extraire fileKey=kL9xQn2VwM8pYrTb4ZcHjF et nodeId=42-15
  2. Exécuter get_design_context(fileKey="kL9xQn2VwM8pYrTb4ZcHjF", nodeId="42-15")
  3. Exécuter get_screenshot(fileKey="kL9xQn2VwM8pYrTb4ZcHjF", nodeId="42-15") pour référence visuelle
  4. Télécharger les icônes de bouton depuis le point de terminaison des ressources
  5. Vérifier si le projet a un composant bouton existant
  6. Si oui, l'étendre avec une nouvelle variante ; si non, créer un nouveau composant en utilisant les conventions du projet
  7. Faire correspondre les couleurs Figma aux jetons de design du projet (par exemple, primary-500, primary-hover)
  8. Valider par rapport à la capture d'écran pour le remplissage, le rayon de bordure, la typographie

Résultat : Composant bouton correspondant au design Figma, intégré au système de design du projet.

Exemple 2 : Construire une mise en page de tableau de bord

L'utilisateur dit : « Construis ce tableau de bord : https://figma.com/design/pR8mNv5KqXzGwY2JtCfL4D/Dashboard?node-id=10-5 »

Actions :

  1. Analyser l'URL pour extraire fileKey=pR8mNv5KqXzGwY2JtCfL4D et nodeId=10-5
  2. Exécuter get_metadata(fileKey="pR8mNv5KqXzGwY2JtCfL4D", nodeId="10-5") pour comprendre la structure de la page
  3. Identifier les sections principales à partir des métadonnées (en-tête, barre latérale, zone de contenu, cartes) et leurs identifiants de nœuds enfants
  4. Exécuter get_design_context(fileKey="pR8mNv5KqXzGwY2JtCfL4D", nodeId=":childNodeId") pour chaque section majeure
  5. Exécuter get_screenshot(fileKey="pR8mNv5KqXzGwY2JtCfL4D", nodeId="10-5") pour la page entière
  6. Télécharger toutes les ressources (logos, icônes, graphiques)
  7. Construire la mise en page en utilisant les primitives de mise en page du projet
  8. Implémenter chaque section en utilisant les composants existants lorsque c'est possible
  9. Valider le comportement réactif par rapport aux contraintes Figma

Résultat : Tableau de bord complet correspondant au design Figma avec une mise en page réactive.

Bonnes pratiques

Commencez toujours par le contexte

N'implémentez jamais sur la base d'hypothèses. Récupérez toujours get_design_context et get_screenshot en premier.

Validation incrémentale

Validez fréquemment pendant l'implémentation, pas seulement à la fin. Cela permet de détecter les problèmes rapidement.

Documentez les écarts

Si vous devez vous écarter du design Figma (par exemple, pour des raisons d'accessibilité ou de contraintes techniques), documentez pourquoi dans les commentaires du code.

Réutilisation plutôt que recréation

Vérifiez toujours l'existence de composants existants avant d'en créer de nouveaux. La cohérence dans la base de code est plus importante que la réplication exacte de Figma.

Le système de design d'abord

En cas de doute, préférez les modèles du système de design du projet à la traduction littérale de Figma.

Problèmes courants et solutions

Problème : La sortie Figma est tronquée

Cause : Le design est trop complexe ou a trop de calques imbriqués pour tenir dans une seule réponse. Solution : Utilisez get_metadata pour obtenir la structure du nœud, puis récupérez les nœuds spécifiques individuellement avec get_design_context.

Problème : Le design ne correspond pas après l'implémentation

Cause : Des divergences visuelles entre le code implémenté et le design Figma original. Solution : Comparez côte à côte avec la capture d'écran de l'étape 3. Vérifiez les valeurs d'espacement, de couleurs et de typographie dans les données de contexte de design.

Problème : Les ressources ne se chargent pas

Cause : Le point de terminaison de ressources du serveur Figma MCP n'est pas accessible ou les URL sont modifiées. Solution : Vérifiez que le point de terminaison de ressources du serveur Figma MCP est accessible. Le serveur sert les ressources à des URL localhost. Utilisez-les directement sans modification.

Problème : Les valeurs des jetons de design diffèrent de Figma

Cause : Les jetons du système de design du projet ont des valeurs différentes de celles spécifiées dans le design Figma. Solution : Lorsque les jetons du projet diffèrent des valeurs Figma, préférez les jetons du projet pour la cohérence, mais ajustez l'espacement/le dimensionnement pour maintenir la fidélité visuelle.

Comprendre l'implémentation du design

Le flux de travail d'implémentation Figma établit un processus fiable pour traduire les designs en code :

Pour les designers : Confiance que les implémentations correspondront à leurs designs avec une précision pixel parfaite. Pour les développeurs : Une approche structurée qui élimine les conjectures et réduit les allers-retours de révisions. Pour les équipes : Des implémentations cohérentes et de haute qualité qui maintiennent l'intégrité du système de design.

En suivant ce flux de travail, vous assurez que chaque design Figma est implémenté avec le même niveau de soin et d'attention aux détails.

Ressources supplémentaires

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.

Skills associés