CommunityImagegithub.com

hyliox-pixel-perfect

Transformez une capture d'écran UI (page d'accueil, écran d'appli, tableau de bord, maquette) en un cahier des charges de reconstruction fidèle et prêt pour les agents de codage IA (Cursor, v0.dev, Lovable, Codex, Claude Code), ciblant Next.js 16 App Router + Tailwind + shadcn/ui + Framer Motion.

Qu'est-ce que hyliox-pixel-perfect ?

Cette compétence est conçue pour les développeurs et agents IA spécialisés dans la reconstruction d'interfaces utilisateur à partir de captures d'écran. Elle produit un cahier des charges Markdown extrêmement détaillé (environ 1000 lignes), structuré en 21 sections fixes, afin de guider des agents comme Cursor, v0.dev, ou Claude Code vers une reconstruction pixel-parfaite. L'accent est mis sur la fidélité maximale : chaque propriété visuelle (position, taille, couleur, typographie) est décrite dans son propre bloc de code, le texte visible est retranscrit textuellement (y compris les fautes), et aucune section ou fonctionnalité n'est inventée. La cible technique par défaut est Next.js 16 App Router, mais les spécifications s'adaptent de manière cohérente à partir d'exemples de référence (gold standards) qui couvrent divers styles visuels. Le workflow est strict : il commence par la lecture de documents de référence, puis l'analyse de l'image, la rédaction du fichier spec, et enfin une réponse concise dans le chat. Cette compétence est idéale pour cloner des designs existants avec une précision chirurgicale, sans ajout de jugement esthétique ou de suggestion d'amélioration.

Compatible avec✓Claude Code✓Codex CLI✓Cursor
npx skills add https://github.com/ys-sites/video/tree/HEAD/hyliox-pixel-perfect

Installed? Explore more Image skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

Demander à votre IA préférée

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

Documentation

Hyliox Pixel Perfect

Traduisez des captures d'écran d'UI en cahiers des charges longs, denses et prescriptifs pour les agents frontend. Optimisé pour une fidélité maximale, pas pour la concision.

Philosophie

Cette compétence produit un cahier des charges fixe de 21 sections, d'environ 1000 lignes, prêt à être copié-collé dans Cursor / v0 / Lovable / Codex / Claude Code. Il est prescriptif, pas adaptatif : les mêmes 21 sections apparaissent dans chaque sortie, dans le même ordre. Si une section n'a pas de contenu pour une image donnée (ex. aucune animation visible), indiquez explicitement « Non visible sur cette capture d'écran — implémenter comme statique » plutôt que de la sauter. Une structure prévisible prime sur une ingéniosité variable.

La compétence est rétro-conçue à partir de deux sorties de référence (« gold standard » : assets/gold-standard-kraken.md et assets/gold-standard-agentai.md). En cas de doute sur le format, la longueur ou la granularité, lisez d'abord les gold standards. Ils constituent la vérité de référence.

Fidélité avant interprétation. Décrivez ce qui se trouve dans l'image. N'inventez pas de sections, de textes, de fonctionnalités ou d'améliorations. Si l'image montre trois cartes de fonctionnalités, décrivez-en trois. Si un logo est répété dans la rangée de marques, répétez-le. S'il y a une faute de frappe dans la navigation (« Why Karken »), conservez-la (et offrez au reconstructeur le choix de la corriger).

Granularité avant prose. Chaque propriété visuelle — position, taille, couleur, padding, graisse de police — obtient son propre bloc de code txt étiqueté. Le code en ligne dans la prose ne suffit pas. Le cahier des charges est un artefact à copier-coller, pas un essai.

Stack technique par défaut

  • Next.js 16.2 (App Router + Turbopack) + React 19 + TypeScript
  • Tailwind CSS (config dans tailwind.config.ts)
  • Primitives shadcn/ui là où c'est pertinent
  • Framer Motion (motion/react)
  • lucide-react pour les icônes
  • Actifs statiques dans /public/images/ et /public/icons/
  • Variables CSS au format HSL (convention shadcn : 0 0% 100% brut, sans wrapper hsl() dans la variable)

Note sur l'adaptation à partir des gold standards. Les deux exemples gold standard ciblent React + Vite. Cette compétence produit du Next.js 16 App Router à la place. Les règles de conversion sont simples mais doivent être appliquées de manière cohérente :

  • index.css → app/globals.css
  • Les chemins d'actifs font référence à /public/... depuis <Image> ou <img> sous forme d'URLs relatives à la racine (/images/foo.png)
  • Les composants qui utilisent Framer Motion, les hooks React (useState, useEffect, useScroll, useInView), les gestionnaires d'événements, les contrôles <video> ou les API navigateur (hls.js) doivent déclarer 'use client' en haut
  • Les composants de mise en page / contenu statique pur restent des Server Components (pas de 'use client')
  • La structure des pages montre l'arborescence du App Router (app/layout.tsx, app/page.tsx, app/globals.css, app/components/...)
  • Utilisez next/image pour les images statiques avec des dimensions connues ; utilisez <img> brut pour les GIFs, contenu dynamique ou animé

Tout le reste (utilitaires CSS, familles glass, helper fadeUp, motifs d'animation, arrière-plans en couches, astuce fine-border) se transfère à l'identique.

Flux de travail

Lorsque la compétence est déclenchée, exécutez ces étapes dans l'ordre. Ne sautez pas d'étapes.

Étape 1 — Lire les références et un gold standard

Avant d'écrire quoi que ce soit, chargez :

  1. references/section-templates.md — le modèle des 21 sections avec le rôle, les règles de contenu et le format pour chaque section
  2. references/idiom-library.md — extraits CSS canoniques (famille glass, fine-border, arrière-plans en couches, fadeUp, mouvement flottant)
  3. references/writing-patterns.md — motif de bloc de code étiqueté, hedging sur l'ambiguïté, format des anti-patrons
  4. Un gold standard comme référence concrète pour la longueur, la densité et le ton :
    • Si l'image d'entrée est sombre/cinématographique/agence → assets/gold-standard-agentai.md
    • Si l'entrée est produit/SaaS/fintech/paiements → assets/gold-standard-kraken.md
    • En cas de doute → assets/gold-standard-kraken.md (couverture de sections plus diversifiée)

Ces fichiers sont volumineux. Lisez-les une fois au début ; ne les relisez pas en cours de génération.

Étape 2 — Analyser l'image

Avant d'écrire, inventoriez en interne :

  • Classification selon trois axes (type d'interface, direction artistique, registre d'ambiance) — voir la section « Pré-écriture » dans references/section-templates.md pour le vocabulaire complet des étiquettes. La classification détermine le préréglage de police, la direction des jetons de design et la liste d'ouverture « devrait ressembler à ».
  • Nom de la marque et logo (visible dans la navigation)
  • Métaphore visuelle qui définit la page (Kraken : pendentifs crypto suspendus. AgentAI : méduse rouge bioluminescente. Essayez toujours de nommer l'âme visuelle de la page en une phrase.)
  • Liste des sections de haut en bas (navbar, hero, preuve, bande de logos, services, etc.)
  • Palette de couleurs — arrière-plan principal, couleur d'accent, surface des cartes
  • Paire typographique — sans-serif d'affichage pour les titres, sans-serif de corps pour le texte, éventuel serif pour les accents en italique
  • Tout le texte visible — extrait textuellement, y compris les fautes et les répétitions
  • Traitements glass / flou / bruit / grain
  • Indices d'animation — tout ce qui implique du mouvement (éléments flottants, lueurs de halo, affordances au survol)

Si quelque chose est partiellement obscur ou illisible, prévoyez de le signaler dans le cahier des charges avec un langage de hedging (« …with your customers » — étendre si l'utilisateur veut une phrase complète, sinon garder textuellement).

Étape 3 — Écrire le cahier des charges dans un fichier

Produisez le cahier des charges sous la forme d'un seul fichier Markdown dans /mnt/user-data/outputs/<slug>-spec.md, où <slug> est en kebab-case dérivé de la marque visible dans l'image (ex. kraken-spec.md, agentai-spec.md, bloom-spec.md). Repliez-vous sur ui-rebuild-spec.md uniquement si aucune marque n'est identifiable.

Le fichier suit le modèle fixe des 21 sections de references/section-templates.md. Objectif de longueur : 800 à 1300 lignes. Moins de 800 signifie que vous avez négligé la granularité ; plus de 1300 signifie que vous avez ajouté des redondances.

Étape 4 — Présenter le fichier et répondre de manière concise dans le chat

Appelez present_files avec le chemin du cahier des charges. La réponse dans le chat fait 3 à 6 lignes maximum :

  • Quelles sections ont été couvertes (ou lesquelles ont été marquées « Non visible sur cette capture d'écran »)
  • Toute incertitude ou hypothèse signalée dans le cahier des charges
  • Toute décision explicite que le reconstructeur devra prendre (ex. conservation des fautes, logos répétés)

Ne dupliquez pas le cahier des charges dans le chat. Ne le résumez pas. Le fichier est la livraison.

Règles strictes de fidélité

Ces règles sont non négociables. Elles priment sur la commodité, la concision et la politesse.

Copie textuelle. Chaque mot visible dans l'image — titres, boutons, labels, pied de page, microcopie — apparaît dans le cahier des charges exactement comme écrit, dans la langue originale, y compris les fautes, les bizarreries de ponctuation et le contenu répété. Lorsqu'une faute est conservée, offrez éventuellement au reconstructeur le choix (« Utilisez Why Karken uniquement si vous reproduisez exactement la capture d'écran visible ; sinon utilisez Why Kraken »).

Anti-patrons explicites. La section VISUAL DETAILS TO MATCH inclut toujours une liste d'anti-patrons : ce qu'il faut éviter, ce qu'il ne faut PAS faire, les directions de couleur à ignorer. Exemple : « Évitez les dégradés bleus, verts, oranges ou multicolores. Limitez strictement la palette au noir, violet, lavande, blanc et gris. Ne rendez pas le design cartoon. »

Pas d'invention. N'ajoutez pas de sections, fonctionnalités, preuves sociales, témoignages ou tout contenu non visible dans l'image. Si l'image se termine au milieu d'une section (recadrée en bas), décrivez uniquement ce qui est visible et notez le recadrage.

Hedging sur l'illisible. Lorsque le texte est coupé, partiellement obscur ou vraiment ambigu, ne l'inventez pas. Marquez-le : « cette carte est partiellement coupée en bas de la capture d'écran ; le corps affiché est ce qui est visible — étendez naturellement avec '…' si l'utilisateur veut une phrase complète, sinon gardez textuellement. »

Arrière-plans en couches décomposés. Chaque arrière-plan complexe est décomposé en N couches absolues explicites (couleur de base, dégradés radiaux, superposition de bruit, vignette, etc.) avec leur ordre d'empilement. N'agrégez pas (« grille-pointillée + lueur-violette + sol-pixel ») ; listez chaque couche avec son propre extrait de code.

Nommage des familles glass. N'imposez pas un nom unique comme « liquid-glass ». Nommez les utilitaires glass en fonction de leur utilisation dans l'image : .glass-nav, .glass-card, .glass-card-soft, .glass-pill, .glass-panel. L'image guide le nommage.

Espace de noms de couleurs de marque. Lorsque le design a une palette de marque forte, namespacez l'extension Tailwind : colors: { kraken: { black, panel, purple, ... } } ou colors: { redai: { DEFAULT, dark, soft } }. Cela rend le cahier des charges intentionnel plutôt que générique.

Box-shadow en tant que jetons nommés. Définissez boxShadow: { 'red-glow': '...', 'glass': '...' } dans la configuration Tailwind plutôt que d'utiliser des chaînes shadow-[...] en ligne partout. Référencez-les ensuite comme shadow-red-glow.

Quand consulter les gold standards en cours de génération

Si vous êtes sur le point d'écrire une section et que vous n'êtes pas sûr de sa densité, granularité ou format — arrêtez-vous et relisez la section équivalente dans le gold standard correspondant. Le gold standard définit la barre. Exemples :

  • Sur le point d'écrire la section HERO mais vous ne savez pas combien de sous-sections (2a, 2b, 2c) ? Regardez comment le gold standard correspondant structure son hero.
  • Sur le point d'écrire SPACING AND LAYOUT DETAILS mais vous ne savez pas quelles clés appartiennent au JSON ? Copiez la structure du gold standard et adaptez les valeurs à votre image.
  • Sur le point d'écrire VISUAL DETAILS TO MATCH mais vous n'avez que 5 éléments ? Les gold standards en ont 15 à 25. Trouvez-en plus.

Les gold standards sont l'outil de calibrage. Utilisez-les.

Liste de vérification du format avant livraison

Avant d'appeler present_files, parcourez le brouillon une fois :

  • Longueur comprise entre 800 et 1300 lignes (plus court = sous-spécifié ; plus long = alourdi)
  • Commence par une phrase « Construisez un… » indiquant le stack technique et l'esthétique de base
  • Les 21 sections sont présentes dans l'ordre, même si certaines indiquent « Non visible sur cette capture d'écran »
  • La métaphore visuelle est énoncée dans l'ouverture ou GLOBAL PAGE DIRECTION
  • Stack technique adapté à Next.js 16 App Router (pas Vite)
  • Rappels 'use client' sur les composants animés/interactifs
  • Tout le texte visible extrait textuellement, dans la langue originale
  • Les accents en italique serif dans les titres sont détectés et signalés
  • Les utilitaires CSS sont nommés d'après leur utilisation, et non d'après un générique « liquid-glass »
  • Espace de noms de couleurs de marque dans la config Tailwind
  • Jetons nommés box-shadow dans la config Tailwind
  • Arrière-plans décomposés en N couches absolues (non agrégés)
  • Chaque propriété visuelle dans son propre bloc de code txt étiqueté (Style:, Position:, Implémentation:)
  • EXACT VISUAL HIERARCHY classe les éléments par poids visuel (liste numérotée)
  • SPACING AND LAYOUT DETAILS inclut un bloc JSON avec la géométrie en pixels
  • VISUAL DETAILS TO MATCH inclut des anti-patrons (« Évitez X, ne faites pas Y »)
  • COPYWRITING CONTENT regroupe tout le texte dans un bloc scannable
  • Hedging appliqué à tout contenu recadré, ambigu ou illisible
  • Pas de critique, pas de suggestions d'amélioration, pas de préambule
  • Cahier des charges écrit dans /mnt/user-data/outputs/<slug>-spec.md
  • Réponse dans le chat de 3 à 6 lignes maximum

Skills associés