Communitygithub.com

turtleneck

Compétence de conception UI pour pages web et applications qui détecte le type de projet (page produit, tableau de bord, site e-commerce…) puis applique un style prédéfini — keynote, enterprise, cinema, et bien d'autres — avec des recettes pour HTML/CSS, Tailwind et SwiftUI.

Qu'est-ce que turtleneck ?

**turtleneck** est une compétence d'agent IA spécialisée dans la création et l'optimisation d'interfaces utilisateur (web et applications). Elle fonctionne en deux étapes : d'abord, elle analyse automatiquement le projet en cours — type de page (landing, dashboard, docs, e-commerce, etc.), dépendances techniques (React, Next.js, SwiftUI…), et l'industrie cible — pour choisir l'un des nombreux **presets de style** (keynote, enterprise, cinema, vibe, power, devtool, lab, journey, market, vault, drive). Chaque preset est un mélange raffiné de cinq grands sites de référence dans sa catégorie, garantissant un rendu crédible et professionnel, jamais une copie directe. La compétence fournit un fichier `tokens.css` central contenant toutes les variables de design (couleurs, typographie, espacements, ombres, animations) et des fichiers de surcharge par preset, ainsi que des recettes prêtes à l'emploi pour du HTML/CSS pur, Tailwind CSS (v3/v4, shadcn) et SwiftUI. Elle est conçue pour être utilisée lors de la construction, de la refonte ou de la révision de n'importe quelle interface : landing pages, pages de prix, tableaux de bord, panneaux d'administration, sites de documentation, écrans d'applications, composants ou prototypes. Elle répond également à des demandes stylistiques explicites comme « faire comme Apple », « style Netflix », « look gaming NVIDIA », « façon Stripe/Vercel », « design OpenAI », « site de voyage », « boutique en ligne », « page banque/fintech » ou « site automobile ». La compétence s'intègre parfaitement à un workflow d'agent IA (Claude Code, Cursor, Codex) et impose des règles strictes de qualité, d'accessibilité (contrastes AA, cibles tactiles 44px), de responsive design (largeurs de test de 320px à 2560px) et d'absence de scroll horizontal. Elle privilégie les décisions de conception sur les choix par défaut génériques des agents, notamment en matière de typographie système, de titres tonaux et d'écriture en casse de phrase.

Compatible avec✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/n-stau/turtleneck/tree/main/skills/turtleneck

Demander à votre IA préférée

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

Documentation

turtleneck (Turtleneck)

Choisissez le bon style pour votre application, puis construisez-la avec rigueur. Chaque style est un preset : un fichier de surcharge de variables par-dessus un socle commun partagé. Le preset par défaut, keynote, est le socle lui-même. Chaque autre preset est un mélange de cinq grands sites d'une catégorie, jamais une copie de l'un d'eux.

Lorsque cette compétence est active, elle remplace les compétences génériques d'"évitement des défauts d'IA" (comme frontend-design) en cas de désaccord : dans keynote, la police système, les sourcils en casse de phrase et les titres tonaux sont corrects.

Fichiers à côté de celui-ci :

  • tokens.css : le socle et les valeurs keynote. Chaque couleur est light-dark(light, dark) ; color-scheme sur :root, .a-dark, .a-light ou data-theme choisit la moitié. Tous les hooks de preset sont listés dans son :root. Les composants partagés y vivent aussi : échelle typographique, boutons, tuiles, .a-grid, .a-rail, .a-stats, .a-reveal.
  • styles/<preset>.css : surcharges de variables plus quelques règles propres au preset. Se charge après tokens.css.
  • styles/<preset>.md : une page par preset : quand l'utiliser, tableau des jetons, règles, deltas de composants, polices, à éviter, checklist.
  • recipes-html.md : squelette de page, navigations, héros, tuiles, bento, galerie, comparatif, pied de page (accordéon sur téléphones), reveal, et les motifs de preset partagés (bandes inversées, héros de recherche, rails, tableau de spécifications, cartes de forfaits, cadre de code).
  • tailwind.md, swiftui.md : les mêmes jetons pour ces piles.
  • test-widths.html?src=<url>[&h=800][&full=1] : la page à 320/375/414 côte à côte avec un rapport de débordement ; full=1 agrandit chaque cadre à la hauteur de son document pour des captures d'écran plein écran sur téléphone.
  • example.html et ../../demos/ dans le dépôt agent-skills : pages terminées.

Étape 0 : Détecter le type d'application (obligatoire, avant tout code)

  1. Un système de design existant ou une demande de style explicite l'emporte. Jetons de projet, thème de bibliothèque de composants, guide de marque, ou "faites-le sombre et rouge" : utilisez cela, gardez uniquement les règles de base ci-dessous, ignorez le tableau.
  2. Lisez les signaux : la demande ; le README ; les dépendances (package.json, pyproject.toml, Podfile, Package.swift, Gemfile, *.csproj) ; les routes ; le CSS existant ; la catégorie du produit et le public.
  3. Choisissez UN preset :
CatégorieSignaux (demande, produit, dépendances, routes)Preset
Matériel premiumProduit physique, appareil grand public, gadget lifestyle, page de lancement, "propre", "minimal", "premium" ; écrans marketing SwiftUI ; aucun signal clairkeynote
Logiciel d'entrepriseBureautique/productivité, B2B, CRM/ERP, intranet, IT/conformité, santé ; dépendances @fluentui/*, @microsoft/teams-js, office-addin-*, @azure/*, Blazor/.NET ; routes /admin, /settings, /reportsenterprise
StreamingVidéo, film/TV, séries, bandes-annonces, événements en direct, VOD ; dépendances hls.js, video.js, shaka-player, @mux/*, react-player ; routes /watch, /browse, /titlecinema
Musique & socialMusique/audio, playlists, créateurs, fil social, rencontres, cours de fitness, abonnement jeunesse ; dépendances howler, tone, wavesurfer.js, expo-av ; routes /player, /playlist, /profilevibe
Matériel gamingPièces GPU/PC, consoles, périphériques, e-sport, benchmarks, pilotes, "FPS" ; dépendances three, @react-three/fiber + bibliothèques de graphiques ; routes /specs, /compare, /driverspower
Développeur & cloudAPI, SDK, CLI, hébergement, déploiement, base de données, observabilité, API de paiement, "pour développeurs" ; dépendances next, @radix-ui/*, stripe, prisma, drizzle, trpc, turbo ; routes /docs, /changelog, /pricingdevtool
IAModèle, assistant, chat, agents, "alimenté par l'IA" comme produit ; dépendances openai, @anthropic-ai/sdk, ai, langchain, transformers ; routes /chat, /research, /modelslab
VoyageSéjours, vols, trajets, hôtels, réservations, itinéraires ; sélecteurs de dates, cartes (leaflet, mapbox-gl) ; routes /search, /stays, /trips, /bookjourney
Vente au détailBoutique, magasin, catalogue, marketplace, panier, paiement, offres, épicerie, mode ; dépendances @shopify/*, @medusajs/*, @commercetools/*, snipcart, @stripe/stripe-js avec un catalogue de produits ; routes /shop, /products, /p/, /cart, /checkout, /categorymarket
FinanceBanque, carte de crédit, paiements, portefeuille, assurance, prêt, épargne, investissement, tableau de bord de compte pour particuliers ; dépendances plaid, react-plaid-link, @adyen/*, dinero.js, currency.js ; routes /accounts, /cards, /rates, /apply, /transfer (une API de paiement vendue aux développeurs est devtool)vault
AutomobileVoitures, motos, vélos électriques, recharge VE, mobilité, concessionnaires, essais routiers ; configurateurs, pages de gamme et de spécifications ; routes /models, /configure, /inventory, /test-drive, /dealersdrive
Type de pagePreset (départage)
Site de documentation, changelogdevtool
Tableau de bord d'administrationenterprise pour les utilisateurs professionnels ; devtool pour les développeurs
Boutiquemarket ; une page de produit premium unique est keynote
Portfoliokeynote pour le travail de produit/design ; cinema pour le film, la photo, le motion design
Écran d'application mobilekeynote pour les utilitaires avec un aspect natif ; vibe pour les médias grand public et les réseaux sociaux
Jeu / studio de jeuxpower pour les jeux compétitifs et liés au matériel ; cinema pour les jeux narratifs et les bandes-annonces
Fonctionnalité IA à l'intérieur d'un autre produitla propre catégorie du produit ; lab uniquement quand l'IA est le produit
Flux de réservation à l'intérieur d'un autre produitjourney pour les pages de recherche et de résultats uniquement

Les mots de style utilisateur correspondent directement : "Apple-like / premium / clean" = keynote ; "Microsoft / Fluent" = enterprise ; "Netflix-style" = cinema ; "Spotify-like / TikTok-like" = vibe ; "gaming / NVIDIA-like" = power ; "Stripe / Vercel / GitHub style" = devtool ; "OpenAI / Anthropic-like" = lab ; "Airbnb / Booking-like" = journey ; "Amazon / IKEA-like" = market ; "banking / PayPal-like" = vault ; "Tesla / BMW-like" = drive. Le résultat est le mélange de la catégorie, jamais le site de cette entreprise (voir "Marques et actifs").

  1. Signaux faibles ou contradictoires : keynote.
  2. Annoncez le choix en une ligne avant de construire, par exemple "Style : devtool (Next.js + Prisma, routes /docs et /pricing, vendu aux développeurs)." Lisez ensuite styles/<preset>.md entièrement (keynote : styles/keynote.md).

Ce qu'un preset peut modifier

Uniquement via les variables dans tokens.css (:root) et quelques règles qui lui sont propres :

  • polices (affichage, corps, monospace) et l'échelle typographique, les graisses, le tracking, l'interlignage ;
  • style des sourcils et de l'intro, taille du corps (jamais en dessous de 14 px pour l'interface utilisateur, 16 px pour le texte de lecture) ;
  • couleurs des surfaces et du texte, clair/sombre par défaut, l'accent unique et le texte sur celui-ci, couleur des liens et du focus ;
  • rayons, bordures, ombres, remplissage des tuiles ; hauteur, padding, graisse et casse des boutons ;
  • hauteur, remplissage et flou de la navigation ; largeurs du contenu, espacement des sections et des tuiles ;
  • easing, durées, distance de révélations, retour visuel au survol et à la pression ;
  • imagerie et saveur de la copie (dans son fichier md).

Tout ce qui se trouve en dessous de cette ligne est valable pour chaque preset.

Flux de travail

  1. Respectez le projet. Chargez tokens.css + styles/<preset>.css, ou fusionnez le thème Tailwind, ou ajoutez la palette SwiftUI. Un preset peut lier les polices gratuites nommées dans son fichier md ; la page doit toujours être correcte avec la pile de secours. N'ajoutez jamais de dépendance npm pour le style.
  2. Écrivez le plan de la page en 3 lignes : la seule chose que la page vend, l'ordre des sections avec les arrière-plans, et le seul "moment" (un chapitre inversé, un bento de grandes statistiques, une démo, une vidéo, un défilement collant).
  3. Écrivez d'abord la copie : titre court (le preset définit la longueur), une ligne de sous-titre, intro de deux lignes maximum.
  4. Construisez à partir des recettes, section par section.
  5. Vérifiez à chaque largeur de test (Responsive), clair et sombre là où le preset a les deux : capture d'écran, vérification du débordement, checklist. Corrigez avant de signaler comme terminé.

Règles de base

Typographie

  • Une famille pour l'interface utilisateur (plus monospace uniquement pour le code réel, les touches et les valeurs d'API). La graisse d'affichage provient du preset.
  • Le tracking se resserre à mesure que la taille augmente ; le corps n'est jamais négativement traqué au-delà de -0.022em.
  • Les tailles d'affichage sont fluides clamp(min, rem + vw, max) ; mélangez toujours rem dans le terme du milieu.
  • Corps 16-17 px pour la lecture ; 14 px uniquement dans l'interface utilisateur dense, les lignes de métadonnées et les pieds de page. Interlignage 1.45-1.6 pour le corps.
  • text-wrap: balance sur les titres ; les mots longs s'adaptent (overflow-wrap, hyphens).
  • Les chiffres importants sont grands et utilisent des chiffres tabulaires ; leurs étiquettes sont petites.

Couleur

  • Les couleurs de la marque d'abord. Une couleur de marque de l'utilisateur ou du projet remplace l'accent du preset, qui n'est que le repli. Le preset décide toujours de la disposition, de la typographie, des rayons, de la densité, de l'imagerie et du mouvement.
  • Recette d'accent (couleur de marque ou tout changement d'accent), définie une fois sur :root :
    • --a-blue : le remplissage, c'est-à-dire la couleur de la marque telle que donnée (l'ancien nom est conservé ; il signifie "accent").
    • --a-on-accent : encre ou blanc, selon ce qui atteint 4.5:1 sur le remplissage.
    • --a-blue-hover : une étape plus sombre (plus claire sur un fond sombre) dont l'étiquette passe toujours.
    • --a-accent-text : light-dark(a, b), la teinte de la marque décalée en luminosité jusqu'à ce qu'elle atteigne 4.5:1 sur --a-bg et --a-bg-alt dans chaque thème. Les liens, les sourcils d'accent et l'anneau de focus (>= 3:1) le lisent. Les presets avec un bouton principal à l'encre (lab, journey) gardent l'encre dans --a-button-* ; la marque va toujours ici.
  • Un accent, petite portée : CTA principal, focus, liens, marque logo, petits badges et marqueurs "recommandé". Pas de grandes surfaces ou de texte de corps, sauf si le preset le dit. Couleurs de statut uniquement pour le statut.
  • Surfaces neutres en 2 à 4 étapes ; séparation par ton, trait fin ou un seul niveau d'ombre douce, selon le preset.
  • Le texte n'est jamais noir pur sur blanc ; le gris du corps est un vrai gris avec un contraste AA.
  • AA partout : 4.5:1 pour le texte et pour les étiquettes des boutons sur leur remplissage, 3:1 pour les grands textes, les icônes et les bordures qui ont une signification.
  • Le mode sombre est une palette différente, pas une inversion : un ton plus clair pour les surfaces surélevées, pas d'ombres pour la profondeur.

Disposition et rythme

  • Le contenu a des limites : une colonne de texte (--a-content) à l'intérieur d'une grille large (--a-content-wide), des gouttières fluides.
  • Les sections alternent la couleur de page et la couleur alternative ; les tuiles prennent le remplissage opposé de leur section.
  • Les héros centrés et les ouvreurs de section lorsque le preset le dit ; le texte à l'intérieur des tuiles et les copies longues sont alignés à gauche.
  • Un moment par page ; un chapitre inversé (sombre ou clair) au maximum, sauf si le preset est construit sur des bandes.

Responsive (règle stricte : chaque résolution, chaque preset)

  • Typographie et espacement fluides à partir des jetons clamp ; petite valeur à 375 px, grande à 1440 px.
  • Pas de largeurs ou hauteurs fixes qui peuvent casser : max-width + gouttière, min(), minmax(0, 1fr), aspect-ratio, min-height. Jamais 100vh (utilisez svh/dvh). Les enfants flex/grid contenant du texte reçoivent min-width: 0.
  • Les grilles se réorganisent par espace : repeat(auto-fit, minmax(min(100%, 20rem), 1fr)), pas de points de rupture par appareil.
  • Les médias évoluent : max-width: 100%; height: auto ; les SVG conservent un viewBox.
  • Navigation : en dessous de 834 px (ou dès que 6+ liens ne tiennent plus : requête de conteneur), les liens textuels se déplacent dans un menu plein écran (popover natif, pas de JS) ; masquez leur <li> avec une règle qui surpasse les styles de lien de base (recettes : Navigation globale). Gardez la marque, la recherche et une action visibles. Pas de liens textuels (seulement recherche, compte, panier) : pas de burger.
  • Pas de barre de défilement horizontale à aucune largeur ; seuls les défileurs intentionnels (galeries, rails, code) débordent, à l'intérieur de leur propre boîte.
  • Cibles tactiles >= 44x44 px : les petites pastilles, les échantillons, les palettes, les liens de navigation reçoivent une zone de contact invisible (.a-hit).
  • Zones de sécurité : viewport-fit=cover ; les gouttières et le padding inférieur utilisent env(safe-area-inset-*).
  • Très grands écrans : la typographie et le contenu s'arrêtent à leurs limites ; les arrière-plans restent en pleine largeur.
  • Paysage du téléphone : le héros ne doit pas avoir besoin de la hauteur de la fenêtre ; rien de collant ne couvre plus d'un tiers.
  • Zoom 200% : équivaut à une fenêtre moitié moins large ; tout se réorganise, rien n'est rogné.

Largeurs de test avant de dire terminé (panneau du navigateur : resize_window pour chacune, capture d'écran, plus document.documentElement.scrollWidth === innerWidth et une liste des éléments plus larges que la fenêtre) :

LargeurReprésente
320Petits téléphones, zoom 200% de 640
375 / 414Téléphone standard / grand
768 / 1024Tablette portrait / paysage, petit ordinateur portable
1280 / 1440Ordinateur portable / de bureau (largeur de référence)
1920 / 2560Full HD / QHD, ultra-large
812x375Paysage du téléphone
6401280 px à zoom 200%

Rapport par largeur : capture d'écran prise, débordement oui/non, ce qui a été corrigé. Chrome sans tête bloque les fenêtres en dessous de 500 px ; testez les largeurs de téléphone dans le panneau du navigateur ou avec test-widths.html?src=<page url> (même racine http). Captures sans tête : forcez le thème avec data-theme="light|dark" sur <html> ; le contenu révélé est invisible dans les captures statiques, alors passez --virtual-time-budget=5000 ou définissez data-reveal="off" sur <html> ; un héros 100svh s'étire dans une fenêtre pleine page haute, alors épinglez-le (min-height: 800px) pour la capture (&full=1 fait les deux).

Composants

  • Boutons : hauteur minimum 44 px (les visuels plus petits reçoivent la zone de contact), casse de phrase sauf si le preset dit majuscules, pas d'icônes sauf un chevron ou une flèche de fin, pas de dégradés. Bouton principal rempli, secondaire selon le preset.
  • Liens : visiblement des liens (couleur ou soulignement) ; chevrons style "En savoir plus ›" là où le preset les utilise.
  • Tuiles/cartes : un seul arrêt de tabulation lorsque la tuile entière est un lien (le bouton intérieur est un span). Rayon, remplissage, bordure et ombre du preset ; jamais tout le remplissage + la bordure + l'ombre à la fois.
  • Anneau de focus : 2 px solide --a-focus, décalage de 1 px, sur chaque élément interactif.
  • Navigation : solide ou vitre selon le preset, au maximum une barre collante, page courante marquée.
  • Pied de page : discret : petits liens gris en colonnes, ligne légale ; les colonnes deviennent des accordéons <details> sur les téléphones.

Imagerie

  • Sujet réel : le produit, son interface utilisateur, les propres photos et médias de l'utilisateur. Grands, recadrés avec intention.
  • Pas de personnes de stock sur des ordinateurs portables, pas de blobs 3D, pas d'emoji, pas de mascottes, pas d'icône devant chaque titre.
  • Sans actifs : dessinez le sujet une fois sous forme de <symbol> SVG recoloré par des variables CSS, ou un espace réservé gris honnête au bon ratio.

Mouvement

  • Les transitions nommées transition utilisent le timing et la durée du preset. Entrées discrètes, pas de rebond parasite. Chaque interaction est liée à un élément ; les animations d'entrée de page se produisent une fois.
  • prefers-reduced-motion: reduce arrête tout sauf les transitions nécessaires (état survolé, indicateur de chargement). Utilisez @media (prefers-reduced-motion: no-preference) pour les animations.

Marques et actifs

  • Aucune police payante dans le rendu final. Les presets peuvent référencer des polices gratuites de Google Fonts, Fontsource ou des polices système. Si le preset nomme une police payante : remplacez-la par la police système de repli la plus proche avec la même graisse. N'ajoutez pas de @import ou de link pour une police payante.
  • Aucun actif de marque d'un site de référence. Le preset peut créer un logo ou une icône générique à des fins de démonstration en utilisant des formes SVG simples, mais aucun logo, mot-symbole ou police propriétaire d'une entreprise.

Commandes de terminal (lorsque l'outil est un agent de terminal)

# Charger le socle avec le preset keynote (par défaut)
cat tokens.css styles/keynote.css > build.css

# Charger le preset devtool
cat tokens.css styles/devtool.css > build.css

# Voir la page de documentation du preset
cat styles/devtool.md

# Générer un aperçu HTML de test (nécessite un serveur HTTP)
python3 -m http.server 3000

Exemple de recette rapide (Nav de base avec preset)

Voir recipes-html.md pour la documentation complète.

Skills associés