Communitygithub.com

Im-Fran/landing-skills

Utilisez cette compétence pour implémenter une page d'atterrissage en code, incluant la structure HTML, le CSS, la mise en page responsive, les polices, les images, les balises meta, les cartes sociales, les données structurées, les formulaires de capture de leads, l'accessibilité ou les performances de chargement, en HTML simple, Astro, Next, Vite avec React ou Tailwind.

Qu'est-ce que landing-skills ?

Cette compétence guide la création d'une page d'atterrissage statique et fonctionnelle, même sans JavaScript, à partir de maquettes, de direction artistique et de jetons de design. Elle garantit que chaque section est accessible via le header, que le formulaire fonctionne sans JS (avec une véritable action et méthode POST), et que la mise en page responsive est solide. La compétence s'appuie sur des fichiers d'entrée comme `landing/brief.md`, `landing/copy.md`, `landing/direction.md` et `landing/tokens.css` pour structurer le contenu, les polices, les images et les couleurs. Elle prend en charge les frameworks modernes comme Astro, Next.js, Vite avec React ou Tailwind, et détecte automatiquement la pile utilisée dans le projet. Le processus en 11 étapes couvre tout, de la détection de la pile à la vérification finale et à la remise, en incluant la construction de l'en-tête, le chargement des polices, la mise en page, les formulaires accessibles et l'accessibilité de base. Les bugs courants (comme les sections collées ou les formulaires morts) sont évités grâce à des règles structurelles et des recettes éprouvées dans `references/`. Cette compétence est idéale pour les développeurs souhaitant automatiser et standardiser la création de landing pages performantes et accessibles.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Im-Fran/landing-skills/tree/HEAD/skills/landing-build

Demander à votre IA préférée

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

Aperçu

Depuis le README du skill

landing-skills preview

Documentation

Construction d'une page d'atterrissage

Transformez la copie approuvée, la direction visuelle et les jetons de design en une page statique complète, même avec JavaScript désactivé. Complète signifie qu'un visiteur peut lire chaque section, accéder à chaque section depuis le header et envoyer le formulaire. Les animations et la 3D viennent plus tard, via landing-skills:landing-motion, et se superposent à une page qui fonctionne déjà.

Deux bugs sont apparus dans plus d'un test réalisé sans cette compétence, et cette compétence est conçue pour les rendre impossibles tous les deux :

  1. Une classe de conteneur avec une propriété raccourcie padding a remplacé le padding vertical de la section, de sorte que chaque section était collée à la suivante. La correction est structurelle : la section possède l'axe de bloc, le conteneur possède l'axe en ligne, et aucun des deux n'utilise la propriété raccourcie (étape 5).
  2. Un formulaire mort : action="#", onsubmit="return false", ou un script qui affichait "Merci" et jetait les données. La correction : une action réelle, une method réelle, une page de succès côté serveur, et aucun message de succès que la page ne peut pas confirmer (étape 8).

Entrées

Lisez ces éléments depuis le projet de l'utilisateur avant d'écrire du code.

FichierCe que vous en tirez
landing/brief.mdles champs que landing-skills:landing-page écrit. Vous utilisez : Langue (pour lang) ; Action de conversion (soit un formulaire avec ses champs et son endpoint, soit none yet, soit une URL externe) ; Stack (tel que nommé, ou detect) ; Domaine (le domaine de production, ou unknown) ; Routes de contact (pour le footer et /form-error/) ; Ressources disponibles
landing/copy.mdun H2 par section de page dans l'ordre de la page ; le dernier H2, Placeholders, liste chaque écart
landing/direction.mdles polices avec source et licence, la ligne de mise en page pour chaque section, les images avec leurs proportions, les surfaces, et le dernier H2 Motion and 3D intent
landing/tokens.cssles propriétés personnalisées : --color-*, --font-*, --text-*, --space-*, --radius-*

Lorsqu'une entrée manque :

  • Pas de copy.md : n'écrivez pas de texte marketing vous-même. Demandez le texte à l'utilisateur ou suggérez landing-skills:landing-copy. Si l'utilisateur vous donne du texte, utilisez-le tel quel. N'inventez jamais de preuves : pas de témoignages, logos, chiffres ou évaluations. Un élément manquant devient [PLACEHOLDER : ce qui est nécessaire].
  • Pas de direction.md ou tokens.css : suggérez d'abord landing-skills:landing-art-direction. Si l'utilisateur souhaite continuer sans, écrivez vous-même landing/tokens.css avec les cinq préfixes, dérivez les valeurs des contraintes de marque données par l'utilisateur, et indiquez à l'utilisateur que ces jetons sont provisoires.
  • Pas de brief.md : demandez la langue, l'action de conversion (un formulaire et où il doit poster, ou une URL externe), le domaine de production et une route de contact.
  • Un champ du brief qui dit unknown ou none yet est un écart, pas une erreur : construisez avec la règle que cette compétence lui donne (pas de balises URL sans domaine, le placeholder /api/lead sans endpoint, une ligne de contact placeholder sans routes de contact) et listez-le dans la remise. Détectez le stack depuis les fichiers du projet (voir "Détection du stack") plutôt que de demander quand vous le pouvez.

Processus

1. Détecter le stack

Utilisez le tableau dans "Détection du stack". Lisez la section correspondante de references/adapters.md avant d'écrire des fichiers ; elle ne couvre que ce qui diffère des recettes simples dans les autres références.

2. Faire un inventaire

Avant tout balisage, notez :

  • Chaque H2 de copy.md et la <section> qu'il devient, avec son id.
  • Chaque nom de jeton dans tokens.css. Vous utiliserez ces noms et aucun autre pour la couleur, la police, l'espacement et le rayon.
  • Chaque image demandée par la direction, son ratio d'aspect, et si le fichier existe.
  • L'action de conversion du brief : une URL externe (un lien, pas de formulaire), ou un formulaire avec ses champs et son endpoint. Avec l'endpoint none yet, le formulaire poste vers /api/lead et cet écart va dans la remise (étape 11).
  • Le Domaine (connu ou unknown) et les Routes de contact, dont le head, le footer et /form-error/ ont besoin.

3. Écrire le head

Titre, description, canonique, Open Graph et carte sociale, jeu de favicons, theme-color, lang, données structurées. Les modèles et règles sont dans references/seo-meta.md. Écrivez le titre et la description depuis copy.md ; un titre par défaut comme celui du starter du framework est un indice.

4. Charger les polices

Auto-hébergez les fichiers WOFF2 nommés dans la direction, déclarez @font-face avec des noms de famille qui correspondent exactement aux stacks dans tokens.css, ajoutez un fallback métriquement adapté, et préchargez uniquement les un ou deux fichiers utilisés au-dessus de la ligne de flottaison. references/performance.md contient la recette et un script testé qui calcule les valeurs de fallback. Une page qui nomme une police et ne la charge jamais, ou qui utilise system-ui comme fallback, s'affiche différemment sur chaque machine.

5. Construire le squelette de la mise en page

Chaque bande de la page est une <section class="section"> avec un <div class="container"> à l'intérieur. Les deux ne partagent jamais un même rôle :

/* La section possède le rythme vertical, le conteneur possède la largeur et les gouttières. */
.section { padding-block: var(--space-section-open); }
.container {
  inline-size: min(100% - 2 * var(--space-gutter), var(--space-content-max));
  margin-inline: auto;
}

Les noms de jetons ci-dessus sont des exemples ; utilisez les noms dans votre tokens.css. references/css.md liste chaque rôle de jeton que les recettes supposent et quoi faire lorsque votre fichier n'a pas de jeton pour l'un d'eux. Le conteneur ne définit aucun padding, donc aucun ordre de règle ou spécificité ne peut effacer l'espacement de la section. N'utilisez jamais la propriété raccourcie padding ou margin sur une classe de section ou de conteneur : une propriété raccourcie définit les deux axes et remplace silencieusement celui que l'autre classe a défini. C'est la règle qui supprime le bug 1. references/css.md montre la version cassée à côté de celle-ci, ainsi que les cas de pleine largeur et de ligne fine.

6. Construire les sections

  • Utilisez des éléments sémantiques : header, nav, main, section, footer, ol pour les étapes, dl ou table pour les spécifications, figure pour les médias avec légende.
  • Un h1, dans le hero. Chaque section commence par un h2 tiré de copy.md. Ne sautez pas de niveaux.
  • Disposez chaque section selon sa ligne dans direction.md. Lorsque la direction laisse la forme ouverte, choisissez parmi les recettes dans references/css.md ; le nombre et la forme des blocs suivent le contenu, donc trois cartes égales n'apparaissent que lorsque le contenu est composé de trois éléments égaux.
  • Utilisez les jetons pour chaque couleur, police, taille, espace et rayon. Ne redéclarez jamais un jeton dans le CSS de la page. Si une valeur dont vous avez besoin n'a pas de jeton, composez-la à partir de jetons (calc(), color-mix()) et listez-la dans la remise afin que la direction puisse l'ajouter.
  • Utilisez des tailles fluides avec clamp(), des propriétés logiques, la couleur oklch() avec les fallbacks dans references/css.md, et les requêtes de conteneur pour les composants qui changent de forme avec leur propre largeur.

7. Placer les médias

Les images réelles reçoivent width et height, un texte alt qui décrit ce qu'elles contiennent, des formats modernes avec un fallback, et fetchpriority="high" uniquement sur l'image du hero (references/performance.md). Un élément qui n'existe pas encore devient une boîte placeholder visible et étiquetée au ratio d'aspect final, avec un texte comme [PLACEHOLDER : photo, le banc de l'atelier vu du dessus, 3:2]. Ne donnez pas à la boîte role="img" : elle annoncerait une photographie qui n'existe pas. Donnez à chaque placeholder le ratio, la largeur et le fond que la direction donne à cette image, de sorte que les cadres montrent la mise en page prévue plutôt qu'une rangée de boîtes en pointillés identiques (references/css.md, Placeholders de médias). Ne dessinez jamais un écran de produit factice et ne le présentez pas comme le produit.

8. Construire l'action de conversion

L'action de conversion du brief décide ce que vous construisez :

  • Une URL externe (page de paiement, page de réservation, app store) : l'action est un lien, <a class="button" href="https://..."> avec le libellé de copy.md. Il n'y a pas de formulaire, pas de form.js, et pas de page /thanks/ ou /form-error/ ; passez le reste de cette étape. Si le brief dit que le clic doit être compté, landing-skills:landing-launch ajoute la balise.
  • Un formulaire avec un endpoint que l'utilisateur possède déjà : le formulaire poste vers cette URL et le placeholder /api/lead n'est pas utilisé. Construisez les pages de résultat uniquement si cet endpoint redirige vers elles ; sinon, dites dans la remise où l'endpoint envoie le visiteur.
  • Un formulaire avec l'endpoint none yet : le formulaire poste vers le placeholder /api/lead, que landing-skills:landing-launch construit comme un Worker.

Pour un formulaire, lisez references/forms-a11y.md. Les parties non négociables :

  • <form action="..." method="post"> avec l'endpoint du brief, ou action="/api/lead" avec un commentaire HTML à côté indiquant que l'endpoint n'existe pas encore, listé dans la remise.
  • Chaque champ a un name, un <label> visible, le bon type et autocomplete, et une astuce liée avec aria-describedby lorsque le format nécessite une explication.
  • Sans JavaScript, le navigateur poste le formulaire et l'endpoint répond avec une redirection 303 vers l'une des deux pages statiques que vous construisez maintenant : /thanks/ et /form-error/. Une fois que landing-skills:landing-launch ajoute Turnstile, un visiteur sans JavaScript n'a pas de jeton et arrive toujours sur /form-error/, donc cette page doit offrir un autre moyen de contacter, tiré des routes de contact du brief.
  • Expédiez toujours form.js depuis references/forms-a11y.md comme amélioration progressive. Le formulaire fonctionne sans lui ; le fichier fait toujours partie de la build, car landing-skills:landing-motion étend les états qu'il définit et landing-skills:landing-launch les vérifie. Il n'affiche le succès que lorsque la réponse est un 2xx et que son corps JSON dit ok: true. Un 2xx seul prouve seulement que quelque chose a répondu : fetch suit une redirection et signale la page sur laquelle il atterrit comme 200, et un hébergeur statique peut répondre à un POST avec une page HTML ordinaire. Les deux sont arrivés lors des tests, et les deux sont des échecs. En cas d'échec, le script le dit et conserve ce que le visiteur a tapé. Ne réinitialisez jamais le formulaire et n'affichez pas "Merci" avant que le serveur n'ait confirmé.

9. Atteindre le seuil d'accessibilité

Lien d'évitement, points de repère, un nav dont les liens pointent vers des id de sections réels, le logo liant vers /, un style de focus visible sur chaque élément interactif, des cibles d'au moins 44 x 44 px, et une vérification de contraste de chaque paire de texte et d'arrière-plan que la page affiche réellement : texte du corps sur chaque surface, légendes, astuces, texte placeholder, texte sur l'accent. Les détails et les chiffres sont dans references/forms-a11y.md. Une navigation qui cache ses liens sur mobile sans remplacement échoue à ce seuil ; laissez plutôt les liens passer à la ligne.

10. Laisser le mouvement de côté

Sous mouvement réduit, c'est le mouvement qui est réduit, jamais le feedback, donc n'écrivez aucune règle globale qui annule les transitions. Construisez chaque élément dans son état final et visible. Pas d'animations d'entrée, pas de opacity: 0 en attendant un script, pas de bibliothèques de défilement.

Pour chaque moment nommé dans la direction Motion and 3D intent, laissez un substitut : une image fixe, ou un placeholder étiqueté, à la taille et au ratio d'aspect finaux du moment, afin que la mise en page ne bouge pas lorsque landing-skills:landing-motion monte la version réelle. Marquez-le avec data-moment="<nom>", en utilisant le nom court que la direction donne à ce moment ; le mouvement trouve sa cible par cet attribut. Le substitut est complet sans mouvement : une image réelle avec un texte alt, ou un texte placeholder qui dit ce que le moment montre.

<div class="hero__media" data-moment="vue-explosee">
  <img src="/img/vue-explosee-poster.jpg" width="1600" height="1000" alt="Les couches de l'appareil écartées : boîtier, carte, batterie, objectif">
</div>

Lorsque l'intention est none, n'ajoutez aucun élément data-moment.

11. Vérifier et remettre

Exécutez "Définition de fait". Ensuite, dites à l'utilisateur, dans une courte liste :

  • ce qui a été construit et où (fichiers, dossier de sortie), et le stack résolu écrit dans le champ Stack du brief s'il indiquait detect,
  • chaque [PLACEHOLDER: ...] toujours sur la page et chaque ressource à fournir,
  • l'action de conversion telle que construite : un lien vers une URL externe, un formulaire postant vers l'endpoint de l'utilisateur, ou un formulaire postant vers /api/lead, qui n'existe pas encore,
  • chaque champ que le formulaire soumet, une ligne chacun : son name, son type (email, tel, text, textarea), s'il est required, et son maxlength depuis le balisage. landing-skills:landing-launch configure la validation de son Worker, les limites de longueur, le stockage et la limite de taille de requête à partir de cette liste, et refuse un champ dont il n'a pas été informé,
  • les valeurs composées parce qu'aucun jeton n'existait, et chaque jeton optionnel que tokens.css n'avait pas avec le fallback que les recettes ont utilisé pour lui,
  • le domaine de production si le brief dit unknown, et les balises URL omises à cause de cela (canonique, og:url, og:image, sitemap),
  • les routes de contact que le brief a laissées unknown, que le footer et /form-error/ affichent comme placeholders,
  • chaque fichier de police qui n'a pas été sous-ensemble, avec sa taille en octets,
  • chaque vérification de la Définition de fait qui n'a pas été exécutée, marquée "non exécutée" avec la raison,
  • chaque moment de Motion and 3D intent : son nom data-moment et où se trouve son substitut (section et élément), ou "none" lorsque l'intention est none,
  • la prochaine compétence : landing-skills:landing-motion lorsque la direction Motion and 3D intent nomme un moment, puis landing-skills:landing-review, puis landing-skills:landing-launch pour l'hébergement et l'endpoint du formulaire.

Détection du stack

Vérifiez la racine du projet dans cet ordre et arrêtez-vous à la première correspondance. Le champ Stack dans brief.md décide quand le dossier du projet est vide.

Une fois le stack résolu, écrivez-le : si le champ Stack du brief dit detect, remplacez ce seul mot par le stack résolu (par exemple Astro, ou HTML et CSS simples) et ne modifiez rien d'autre dans landing/brief.md. Les compétences ultérieures lisent le champ et ne devraient pas rencontrer un mot non résolu. Un stack nommé par l'utilisateur reste tel qu'écrit. Quand il n'y a pas de landing/brief.md, n'en créez pas.

Signal dans le projetStackSection de l'adaptateur
astro.config.mjs (ou .ts, .js), ou astro dans les dépendances package.jsonAstroAstro

…

[tronqué pour la traduction]

Individual skills in this repo

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

Skills associés