Communitygithub.com

Landing statique du dépôt

Construit une landing sans étape de build à partir du README, de la licence et des commandes du dépôt, avec thème clair et sombre, Open Graph, JSON-LD et six langues.

Qu'est-ce que Landing statique du dépôt ?

make-lp écrit docs/index.html, docs/style.css et docs/main.js à partir des fichiers déjà présents. La page comprend un hero, une grille de fonctions, les commandes d'installation et un pied de page, plus les jetons de thème, les cartes sociales, les données structurées, un favicon SVG, des boutons copier, et le texte en anglais, japonais, chinois, espagnol, russe et allemand. Rien n'est inventé au-delà du dépôt.

Compatible avec✓Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/hidao80/agent-skills/tree/HEAD/skills/make-lp

Demander à votre IA préférée

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

Documentation

Que fait Landing statique du dépôt ?

Génère une page d'accueil statique (docs/index.html + docs/style.css + docs/main.js) dont le contenu provient du dépôt dans lequel elle est placée. Ne listez jamais de fonctionnalités, fournisseurs ou commandes qui n'existent pas réellement dans le dépôt.

Source de vérité pour le contenu

Avant d'écrire quoi que ce soit, lisez ce qui suit :

  • README.* — aperçu, fonctionnalités, stack technique, commandes d'installation/démarrage rapide
  • LICENSE* — nom de la licence, version, URL
  • CHANGELOG.* — résumé de l'historique des modifications
  • package.json, composer.json, requirements.txt, etc. : nom, description, dépendances (base pour les badges de stack technique)
  • AGENTS.md, CLAUDE.md, config.toml, GEMINI.md, etc. : l'objectif du projet et, si le projet en possède, les tableaux des fournisseurs/paramètres pris en charge
  • Un docs/index.html existant (s'il est présent) : sauf demande explicite de refonte, réutilisez sa structure de sections et modifiez le contenu sur place plutôt que de reconstruire à partir de zéro

Éléments requis

  1. Thème clair/sombre — Remplacez les propriétés personnalisées CSS (--bg, --text, --accent, etc.) avec une media query prefers-color-scheme: dark. N'ajoutez pas de bouton de basculement de thème JS sauf demande explicite.

  2. OGP + carte Twitter/X — og:title, og:description, og:url, og:image, og:type, og:site_name, twitter:card, twitter:title, twitter:description, twitter:image. Pointez og:image/twitter:image vers un actif qui existe déjà réellement dans le dépôt (par exemple, social-preview.png). S'il n'en existe pas, générez-en d'abord un avec la compétence make-social-preview.

  3. Schéma JSON-LD — Un bloc <script type="application/ld+json"> (SoftwareApplication pour une application/outil ; sinon tout @type qui correspond au projet). Gardez-le cohérent avec la description OGP.

  4. Favicon — Référencez un SVG Twemoji qui convient au projet avec <link rel="icon">.

  5. Prise en charge multilingue via multilanguagejs (CDN, sans étape de build) :

    <script src="https://unpkg.com/[email protected]/dist/multilanguagejs.umd.cjs"></script>
    

    Enveloppez chaque élément à traduire dans <template type="language-group">, et à l'intérieur placez un élément enfant par langue, chacun avec un attribut language="xx" (pas lang) :

    <h2>
      <template type="language-group">
        <span language="en">Features</span>
        <span language="ja">機能</span>
      </template>
    </h2>
    

    Chaque template[type=language-group] doit contenir exactement un élément par langue prise en charge — multilanguagejs prend le premier élément correspondant [language=X] par template, donc les doublons entraînent une perte silencieuse de contenu.

    Initialisez-le dans main.js :

    var ml = new MultilanguageJS({ languages: [...], defaultLanguage: "en" });
    ml.setLanguage(lang); // au chargement, et sur l'événement change du sélecteur <select>
    

    <title> et <meta name="description"> sont hors de la portée des templates [language] (la bibliothèque ne met à jour que le textContent des éléments correspondants, et la traduction d'une balise <meta> réside dans son attribut content, pas dans son texte). Donnez à main.js un petit dictionnaire par langue { title, description } et mettez à jour ces deux balises manuellement avec ml.setLanguage().

    Détectez la langue du visiteur à partir de navigator.language, enregistrez la langue sélectionnée dans localStorage, et au chargement réappliquez-la avant de revenir à la détection du navigateur.

    Ensemble de langues requis (toujours, indépendamment de ce que l'application elle-même prend en charge) : Anglais (en), Japonais (ja), Chinois (zh), Espagnol (es), Russe (ru), Allemand (de) — au moins 6 langues. Ceci s'applique même si src/locales/*.json ou le propre i18n.ts/i18n.js de l'application ne couvre que certaines d'entre elles (par exemple, même pour une application uniquement en/ja, faites la page d'accueil en 6 langues). Si demandé, vous pouvez ajouter d'autres langues à ces 6.

  6. Boutons copier dans le presse-papiers — Donnez à chaque commande d'installation/exécution affichée dans un bloc <code> un bouton de copie avec une icône SVG en ligne (jamais un emoji), avec un état de confirmation de coche via navigator.clipboard.writeText(). Pour une mise en page cohérente, enveloppez le <code> et son bouton dans un conteneur flexible .code-row.

  7. Responsive — Mobile-first. Ne provoquez pas de défilement horizontal sur les fenêtres étroites, sauf à l'intérieur de conteneurs explicitement destinés à défiler (par exemple, un tableau comparatif large).

  8. Pas d'étape de build — Faites en sorte que la page fonctionne simplement en ouvrant le fichier HTML ou en servant le dossier statique tel quel, indépendamment du bundler (Vite, etc.) utilisé par l'application elle-même. Gardez main.js comme source lisible. Chargez-le directement dans la page avec <script src="main.js">.

  9. Structure sémantique — Structurez sémantiquement : hero (titre, texte d'accroche, CTA, commande d'exécution principale), captures d'écran (réutilisez les URL d'actifs existants du dépôt/GitHub s'il y en a), grille de fonctionnalités, commandes de démarrage rapide/installation, badges de stack technique, pied de page.

  10. Réutiliser le CSS existant — Réutilisez les propriétés personnalisées CSS et les noms de classe déjà présents dans le docs/style.css du dépôt plutôt que de créer un système de style parallèle et séparé.

  11. Respecter le système de design — Respectez le système de design dans l'environnement d'exécution d'agent IA existant. Lors de l'ajout de nouveau CSS, réutilisez les propriétés personnalisées et les noms de classe existants, et suivez les conventions de nommage, le design, la mise en page, le ton et la manière cohérents avec le système de design du dépôt.

Workflow

  1. Lisez les sources de contenu ci-dessus.
  2. Si docs/ n'existe pas, créez-le.
  3. Si docs/index.html existe déjà, modifiez-le sur place — sauf demande explicite de refonte, ne le remplacez pas en totalité ; conservez la structure de sections et mettez à jour le contenu.
  4. Structurez les sections sémantiquement : hero (titre, texte d'accroche, CTA, commande d'exécution principale), captures d'écran (réutilisez les URL d'actifs existants du dépôt/GitHub s'il y en a), grille de fonctionnalités, tableau de comparaison/paramètres (si le projet a plusieurs fournisseurs/modes/backends qui valent la peine d'être comparés), commandes de démarrage rapide/installation, badges de stack technique, pied de page.
  5. Réutilisez les propriétés personnalisées CSS et les noms de classe déjà présents dans le docs/style.css du dépôt plutôt que de créer un système de style parallèle et séparé.
  6. Mettez à jour docs/main.js.
  7. Vérifiez avant de terminer : aucun emoji n'est utilisé pour les icônes interactives (SVG uniquement) ; chaque template[type=language-group] a exactement un élément enfant par langue prise en charge, sans doublons ni omissions ; OGP/JSON-LD pointent vers des fichiers/URL qui existent réellement dans le dépôt.

Skills associés