Communitygithub.com

Im-Fran/landing-skills

Utilisée pour réviser, auditer ou critiquer une page d’atterrissage, avant de déclarer le travail terminé, ou lorsque l’on se demande si une page semble générée par IA, basée sur un template ou non professionnelle.

Qu'est-ce que landing-skills ?

Cette compétence permet d’auditer une page d’atterrissage de manière exhaustive, en couvrant les aspects statiques, visuels, de mouvement et 3D, et de produire un rapport structuré dans `landing/review.md`. Elle est conçue pour les développeurs et agents IA travaillant sur des projets web, afin de détecter des problèmes souvent négligés comme des formulaires cassés, des promesses non vérifiées, ou des pages 3D qui échouent sans WebGL. Elle prend en charge tous les frameworks courants (HTML pur, Vite, Astro, Next.js, etc.) et utilise des scripts automatisés (détection de motifs, capture d’écran) ainsi qu’une grille d’évaluation détaillée. La compétence insiste sur la vérification à quatre largeurs (360, 768, 1280, 1440 px) et l’examen de chaque aspect de la page, en s’appuyant sur des fichiers de référence comme le brief client, le texte approuvé et les tokens visuels.

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

Demander à votre IA préférée

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

Documentation

Révision de page d'atterrissage

Vous auditez une page d'atterrissage et rédigez un verdict dans landing/review.md. La page peut provenir du pipeline landing-skills ou de n'importe où ailleurs. Vous lisez la source, examinez la page rendue à quatre largeurs, testez les animations et la 3D lorsqu'il y en a, et jugez le tout par rapport à une grille d'évaluation.

Les pages qui semblent terminées sont souvent cassées d'une manière que personne n'a cherchée : un formulaire qui rejette chaque prospect tout en remerciant le visiteur, des spécifications et des promesses que le client n'a jamais données, une page 3D qui devient blanche quand WebGL est indisponible, le padding d'une section annulé par une autre règle à toutes les largeurs. Les réviseurs qui capturent quatre largeurs et en regardent deux manquent ce qui n'apparaît qu'à une seule. Votre travail consiste à tout regarder et à ne signaler que ce que vous avez confirmé.

<skill-dir> ci-dessous désigne le répertoire qui contient ce SKILL.md ; les scripts se trouvent dans son dossier scripts/. Lorsque la compétence a été chargée depuis un plugin, le chemin de ce fichier vous a été donné au moment du chargement ; sinon, trouvez-le avec find ~ -path '*landing-review/scripts/detect-tells.mjs' 2>/dev/null. Exécutez chaque commande depuis le projet audité, en nommant les scripts par leur chemin complet.

Entrées

Vous avez besoin de la page, et vous utilisez tout contexte existant.

  1. La page. Un répertoire de projet, un fichier HTML unique ou une URL déployée. Trouvez le point d'entrée : index.html, src/pages/index.astro, src/App.jsx, app/page.tsx, ou quoi que ce soit que la pile utilise. Notez la pile ; elle détermine comment vous servez la page lors de la passe visuelle.
  2. landing/brief.md : produit, public, action de conversion, les faits et les preuves fournis par le client, les ressources fournies, la langue. C'est votre source de vérité pour ce que la page peut revendiquer.
  3. landing/copy.md : le texte approuvé. Comparez la page à celui-ci.
  4. landing/direction.md et landing/tokens.css : la direction visuelle avec ses justifications, et les tokens. Un choix qui ressemble à une valeur par défaut est acceptable lorsque la direction donne une raison spécifique au client.

Lorsque des fichiers sont manquants :

  • Pas de brief. Demandez quatre choses à l'utilisateur avant de juger les revendications : quel est le produit, à qui il est destiné, quelle est l'action de conversion unique, et quels faits, chiffres, témoignages et logos sont réels. Si vous ne pouvez pas demander, prenez les faits de ce que la page elle-même dit sur l'entreprise, et traitez chaque témoignage, nom de client, logo, évaluation et métrique comme non vérifié : signalez chacun comme un blocage avec la correction "confirmer que ceci est réel et fourni par le client, ou le supprimer". Une preuve non vérifiée qui est expédiée est le même risque qu'une preuve inventée.
  • Pas de copy.md ou direction.md. Révisez le texte et les visuels par leurs propres mérites avec la grille. Vous perdez la capacité de dire "ceci diffère du texte approuvé", rien d'autre. Ne demandez pas ces fichiers.
  • Pas de dossier landing/. Créez landing/ et landing/shots/ dans le projet ; le rapport et les captures d'écran y seront placés.
  • La page ne se construit pas ou ne se sert pas. Signalez-la sous la ligne de la grille B15, avec l'erreur. Si aucune page rendue ne peut être obtenue par un autre moyen (une URL déployée, une construction antérieure), la passe visuelle ne peut pas s'exécuter et le verdict est incomplete (voir Verdict).

Lisez references/rubric.md avant de commencer les passes. Elle contient chaque vérification avec ce à quoi ressemble une réussite et la gravité en cas d'échec. Lisez references/report-format.md avant d'écrire landing/review.md. references/snippets.md contient les scripts exécutés par les passes.

Processus

Exécutez les passes dans cet ordre, puis rédigez le rapport :

  1. Passe statique : scannez la source, puis lisez-la.
  2. Passe visuelle : rendez la page et regardez-la à quatre largeurs.
  3. Passe d'animation et 3D : uniquement lorsque la page a des animations ou une scène 3D.
  4. Parcourez toute la grille dans references/rubric.md, zone par zone : texte, direction artistique, build, animation, préparation au lancement. Écrivez une liste de contrôle de travail dans landing/review-checklist.md avec une ligne pour chaque identifiant de ligne : fail avec l'emplacement, pass avec une preuve, ou n/a avec la raison. Un passage compte seulement lorsque sa preuve est la sortie de la propre ligne "Comment vérifier" : la liste là où elle dit liste, le comptage là où elle dit comptage, et chaque section, en-tête et pied de page inclus, là où elle couvre chaque section. Une ligne cochée de mémoire de la page n'est pas parcourue. Lisez le texte et la direction artistique aussi attentivement sur une page statique courte que sur une page complexe, et parcourez chaque ligne même lorsqu'un blocage est déjà évident : la revue liste tout ce que le prochain tour doit corriger, pas seulement ce qui décide du verdict.
  5. Écrivez landing/review.md comme décrit dans references/report-format.md : échecs dans le tableau, réussites avec leurs preuves sous "Vérifié et correct". Ensuite, exécutez l'auto-vérification à la fin de ce fichier.

Prenez des notes au fur et à mesure : pour chaque constatation, où vous l'avez vue (fichier et ligne, ou largeur et section) et comment vous l'avez confirmée.

Passe statique

Pointez le scanner vers les chemins source de la page, pas vers un dépôt entier :

node <skill-dir>/scripts/detect-tells.mjs index.html styles.css
node <skill-dir>/scripts/detect-tells.mjs src --json

Ce qu'il lit : tout fichier que vous nommez directement, quelle que soit son extension. Dans un répertoire, il lit les fichiers .html, .htm, .css, .scss, .js, .jsx, .mjs, .ts, .tsx, .astro, .vue, .svelte, .md et .mdx, ignore les dossiers node_modules, .git, dist, build, .next, .astro, .output, .vercel et .wrangler, et ignore tout fichier de plus de 1 Mo. Chaque ligne est vérifiée par rapport à 25 règles. Une constatation s'imprime sous la forme file:line [rule-id] message suivie d'une ligne fix:. Le code de sortie 1 signifie qu'il a trouvé quelque chose, 0 signifie qu'il n'a rien trouvé, 2 signifie un mauvais chemin ou une mauvaise utilisation. --self-test vérifie le scanner lui-même.

Parce qu'il lit le Markdown, il signale également les phrases citées dans les notes, les rapports, le brief et les révisions précédentes. Ignorez toute constatation dans un fichier qui n'est pas la source de la page : landing/*.md, les README, les notes, les fichiers review.md précédents.

Traitez chaque constatation comme une invitation à regarder, jamais comme un verdict. Ouvrez la ligne, regardez ce qu'elle contient réellement et ce que la page en fait, et ensuite seulement décidez. Décrivez ce que la règle a trouvé : un hit de palette sur une couleur de balise n'est pas une constatation sur le fond de la page. Exemples de ce que le regard décide :

  • dead-anchor sur un lien de logo est un défaut de build mineur. Sur l'appel à l'action principal, cela signifie que la conversion ne fonctionne pas : un blocage.
  • overused-font signifie qu'une police courante domine la pile. C'est une constatation seulement lorsque direction.md ne donne aucune raison et que la police n'est pas associée à une police d'affichage ou mono distincte.
  • palette-cream-terracotta se déclenche sur deux valeurs hexadécimales exactes. Le crème seul n'est jamais un indicateur ; l'ensemble crème, accent terracotta et une police serif à la mode en est un.

Un scan propre ne prouve rien. Des revendications inventées, une page qui est vide sans JavaScript, un bundle surdimensionné et un appel à l'action qui renvoie à un identifiant valide dans la page mais ne mène jamais à un achat ne laissent aucun motif dans la source. La plupart des échecs sont des absences, des comptages, des contradictions, de la composition et un comportement cassé, qu'une regex ligne par ligne ne peut pas voir. Une page peut passer le scan proprement et échouer à toutes les autres passes.

Donc, après le scan, lisez la source vous-même. Les vérifications à effectuer en lisant sont dans references/rubric.md, marquées "source". Celles qui attrapent le plus :

  • Le <head> : titre, lang, meta description, favicon, balises Open Graph.
  • Chaque formulaire : où il soumet, ce que le gestionnaire fait des données, et si le message de succès attend le serveur.
  • Chaque href d'appel à l'action : où il mène réellement.
  • Polices : chaque font-family est-elle chargée par un @font-face, un lien de feuille de style ou une importation de police de framework, ou s'agit-il uniquement d'une pile système ?
  • Chaque revendication, nombre, nom, spécification et promesse sur la page, vérifié par rapport au brief. Chaque ressource que le brief dit avoir été fournie, vérifiée par rapport à ce que la page montre.
  • CSS qui s'annule lui-même, comme une classe de conteneur dont la propriété abrégée padding est plus spécifique que la règle de section et réinitialise silencieusement le padding vertical de la section à zéro. Confirmez dans le navigateur en lisant le padding calculé.
  • prefers-reduced-motion : présent ou absent, et ce qu'il fait.
  • Le corps du HTML construit : s'il s'agit d'un <div id="root"> vide sans <noscript>, la page est vide sans JavaScript.

Passe visuelle

Vous avez besoin d'une page rendue. Le scanner et la source ne peuvent pas vous montrer les chevauchements, les moitiés vides d'une mise en page, les titres qui passent à la ligne, l'espacement effondré ou le texte situé au-dessus d'une scène 3D.

Servir la page

Révisez toujours via HTTP, HTML simple inclus. Plusieurs vérifications ont besoin d'un serveur : les chemins d'actifs relatifs à la racine (/styles.css, /assets/...) échouent via file://, et la ligne L7 de la grille demande un chemin manquant, /robots.txt et /sitemap.xml. Installez d'abord les dépendances si node_modules est manquant.

  • URL déployée : utilisez-la directement.
  • HTML et CSS simples : dans le dossier qui contient index.html, exécutez python3 -m http.server 8000 et ouvrez http://localhost:8000/.
  • Vite : npm run build, puis npx vite preview (port 4173 par défaut).
  • Astro : npm run build, puis npx astro preview (port 4321 par défaut).
  • Next.js : npm run build, puis npm run start (port 3000 par défaut).
  • Tout autre build : construisez-le, puis exécutez la même commande python3 -m http.server dans le dossier de sortie.

Notez l'URL que vous avez révisée sous Passes. Ouvrez un chemin file:// uniquement en dernier recours, lorsque rien ne peut être servi ; alors L7 n'est pas exécutée, et tout actif avec un chemin relatif à la racine peut être manquant pour cette seule raison. Listez les deux sous Passes, et ne signalez pas un actif manquant que le serveur aurait trouvé.

Révisez une sortie de build existante uniquement lorsqu'elle est à jour avec la source. find src index.html -newer dist/index.html (avec les chemins source et de sortie de la pile) liste les fichiers source modifiés depuis le build ; s'il en liste, ou s'il n'y a pas de build, reconstruisez. Indiquez sous Passes lequel vous avez révisé et pourquoi.

Choisir la méthode de capture, dans cet ordre

  1. Un outil de navigateur, si l'environnement en a un. Vous avez besoin de ces capacités : naviguer vers une URL, définir la largeur de la fenêtre d'affichage, prendre une capture d'écran de toute la page, exécuter un script dans la page, et émuler les fonctionnalités média (schéma de couleurs, mouvement réduit) et JavaScript désactivé.

  2. Le script de secours, lorsqu'il n'y a pas d'outil navigateur ou qu'il ne peut pas capturer. Exécutez-le même si on vous a dit qu'aucun navigateur n'est disponible : il démarre son propre navigateur via npx et peut fonctionner quand même.

    node <skill-dir>/scripts/screenshot.mjs <url-ou-fichier> landing/shots
    node <skill-dir>/scripts/screenshot.mjs <url-ou-fichier> landing/shots --dark
    

    Il écrit 360.png, 768.png, 1280.png et 1440.png (avec --dark, 360-dark.png et ainsi de suite), pleine page, après une attente de 1,5 seconde, et imprime chaque chemin de fichier. S'il échoue avec "Executable doesn't exist", exécutez npx playwright install chromium et réessayez. Il a échoué lorsqu'il se termine avec un code non nul, imprime capture failed at <width>px, ou n'écrit aucune image.

  3. Ni l'un ni l'autre ne fonctionne. Ce n'est qu'alors que la passe visuelle n'a pas été exécutée. Faites la passe statique et la lecture de la source quand même, puis suivez la règle de Verdict pour incomplete.

Le script de secours ne peut pas exécuter de scripts dans la page, émuler le mouvement réduit, désactiver JavaScript ou WebGL, ou faire défiler. Avec lui, jugez ce que vous pouvez à partir des images, vérifiez le mouvement réduit, JavaScript désactivé et WebGL désactivé en lisant la source, et listez sous Passes chaque vérification que vous n'avez pas pu exécuter en direct, avec la raison.

Capturer les quatre largeurs

Pour chaque largeur, 360, 768, 1280 et 1440 (la hauteur 800 est acceptable) :

  1. Définissez la largeur, chargez la page, attendez les polices et les images.
  2. Confirmez la largeur réelle avec la vérification de la fenêtre d'affichage dans references/snippets.md. Certains outils ne réduiront pas une fenêtre en dessous d'un minimum et vous donneront silencieusement une page plus large ; utilisez plutôt l'émulation d'appareil ou de fenêtre d'affichage de l'outil, et vérifiez à nouveau.
  3. Prenez une capture d'écran pleine page dans landing/shots/.
  4. Exécutez le script de mesure depuis references/snippets.md et lisez ses mises en garde : débordement, éléments plus larges que la fenêtre d'affichage, changement de mise en page, nombre de toiles.
  5. Faites défiler la page dans le navigateur en direct, de haut en bas.

Ensuite, ouvrez et lisez chaque image : les quatre largeurs, et les sombres si vous les avez prises. Écrivez une ligne par largeur dans vos notes indiquant ce que vous avez vu avant de passer à autre chose. Regarder deux largeurs et supposer les autres est la façon dont les échecs qui n'apparaissent qu'à certaines largeurs sont manqués : un bloc étroit laissant la moitié de la ligne vide uniquement aux largeurs larges, ou des liens de section cachés sans menu uniquement à la plus étroite.

Si une capture pleine page échoue ou revient coupée, ce qui arrive sur les pages hautes avec des toiles, capturez plutôt la fenêtre d'affichage en haut et à plusieurs positions de défilement (un quart, la moitié, trois quarts, le bas) à chaque largeur, et dites-le sous Passes. Le script de secours ne prend que des captures pleine page ; s'il échoue de cette façon, enregistrez les largeurs manquantes.

Les captures pleine page de pages à défilement piloté peuvent montrer des bandes blanches là où les sections en parallaxe ou collées se trouvent hors écran à la position de défilement zéro. Avant de signaler une zone blanche, faites défiler jusqu'à elle dans la page en direct. Si elle s'affiche là, il s'agit d'un artefact de capture, pas d'un défaut.

Recherchez

À chaque largeur, avec la grille ouverte :

  • Défilement horizontal, texte rogné, éléments qui se chevauchent, texte sur une image ou une toile où il devient difficile à lire.
  • Espacement : sections sans padding vertical, titres collés au bloc au-dessus, bordures qui dépassent du contenu.
  • Composition : lignes à moitié vides à 1280 et 1440, titres qui passent à quatre lignes ou laissent un seul mot sur la dernière ligne, sourcils, étiquettes et boutons qui passent à la ligne à 360, cartes de hauteur inégale.
  • Navigation à 360 : les liens de section sont-ils encore accessibles, les boutons font-ils au moins 44 sur 44 px, un en-tête fixe couvre-t-il le titre ?
  • Ordre à 360 : le produit est-il visible au-dessus du formulaire, ou poussé en dessous ?
  • Images : ressources réelles, ou espaces réservés étiquetés au bon rapport d'aspect pour des ressources qui n'existent pas encore.
  • Clavier : parcourez la page une fois avec Tab à 1280. Le focus doit être

… [tronqué pour la traduction]

Individual skills in this repo

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

Skills associés