Que fait Générateur de page d'accueil ?
Générez une page d'accueil complète et prête à déployer depuis n'importe quel dépôt en analysant sa documentation et sa structure.
Quand utiliser cette compétence
- Créer une page d'accueil pour un dépôt GitHub
- Générer des sites statiques à partir de documentation existante
- Uniformiser les pages d'accueil sur plusieurs projets
- Convertir le contenu d'un README en pages marketing/vitrine
Ce que fait cette compétence
- Analyser le dépôt : Lire README.md, CHANGELOG.md, package.json/VERSION, docs/, assets/
- Extraire le contenu : Identifier le titre, le slogan, les fonctionnalités, l'installation, les captures d'écran
- Mapper en sections : Hero, Fonctionnalités, Installation, FAQ, Pied de page (+ optionnel : Bannière d'avertissement, Tarifs)
- Générer la page d'accueil : Créer un site statique complet (HTML + CSS + JS)
- Sortie prête à déployer : Inclure un workflow GitHub Actions pour GitHub Pages
Comment utiliser
Utilisation de base
/landing-page-generator from ~/chemin/vers/depot
Avec options
/landing-page-generator from ~/chemin/vers/depot --risk-banner --pricing-table
Options disponibles
| Option | Description | Défaut |
|---|---|---|
--risk-banner | Ajouter une bannière d'avertissement/mention légale visible au-dessus du pli | false |
--pricing-table | Inclure un tableau comparatif des prix | false |
--screenshots <chemin> | Chemin vers le dossier de captures d'écran | ./assets/ |
--theme [dark|light] | Variante de thème de couleur | dark |
--search | Activer la recherche Cmd+K | true |
--output <chemin> | Répertoire de sortie | ./[nom-depot]-landing/ |
Workflow
Étape 1 : Analyse du dépôt
Lire et analyser ces fichiers du dépôt source :
README.md → Source de contenu principal (titre, slogan, fonctionnalités, installation)
CHANGELOG.md → Informations de version, changements récents
package.json → Numéro de version, dépendances, métadonnées
VERSION → Source de version alternative
docs/ → Pages de documentation supplémentaires
assets/ → Captures d'écran, images
LICENSE → Type de licence pour badge
Étape 2 : Carte d'extraction du contenu
| Source | Section cible | Méthode d'extraction |
|---|---|---|
| Titre/badges README | Hero | Premier H1 + lignes de badges shield.io |
| TL;DR README | Slogan Hero | Premier paragraphe ou citation après le titre |
| Fonctionnalités README | Grille des fonctionnalités | Sections H2/H3 avec listes à puces |
| Installation README | Démarrage rapide | Blocs de code avec commandes shell |
| Utilisation README | Exemples | Blocs de code avec exemples |
| FAQ README | FAQ | Détails/résumé ou motifs H3+P |
| CHANGELOG | Nouveautés | 1 à 3 dernières versions |
| assets/*.png | Captures d'écran | Section galerie |
Étape 3 : Génération des sections
Générer ces sections dans l'ordre :
-
En-tête (fixe)
- Logo/nom du projet
- Liens de navigation : Fonctionnalités, Installation, FAQ
- Actions : Recherche (Cmd+K), Étoile GitHub, appel à l'action principal
-
Bannière d'avertissement (si
--risk-banner)- Style orange/avertissement au-dessus du pli
- Texte de mention légale clair et visible
- Lien vers la section de divulgation détaillée
-
Section Hero
- Titre depuis H1 du README
- Slogan depuis le TL;DR/premier paragraphe
- Badges de statistiques (version, licence, plateforme)
- Appels à l'action : "Démarrage rapide" (principal), "Voir sur GitHub" (secondaire)
-
Architecture/Aperçu (si diagramme dans le README)
- Diagramme ASCII converti en bloc stylisé
- Ou cartes d'aperçu
-
Grille des fonctionnalités
- 4 à 6 cartes de fonctionnalités depuis le README
- Motif icône + titre + description
-
Tableau des prix (si
--pricing-table)- Tableau comparatif des formules
- Tableau des multiplicateurs/utilisation si présent
-
Galerie de captures d'écran (si des assets existent)
- Galerie par onglets ou carrousel
- Légendes depuis le texte alternatif
-
Section Démarrage rapide
- Commande d'installation en une ligne (bloc de code mis en valeur)
- Étapes de configuration
- Premier exemple d'utilisation
-
Divulgation des risques (si
--risk-banner)- Section de mention légale complète
- Considérations sur les CGV
- Recommandations
-
Section FAQ
- Générée depuis la FAQ du README ou les questions courantes
- Motif détail repliable
-
Projets associés (si liens dans le README)
- Cartes pointant vers les dépendances/dépôts associés
-
Pied de page
- Liens rapides
- Badge de licence
- Informations de version
- Liens vers l'auteur/le dépôt
Étape 4 : Structure de sortie
[nom-projet]-landing/
├── index.html # Page d'accueil principale
├── styles.css # Feuille de style complète
├── search.js # Fonctionnalité de recherche Cmd+K
├── search-data.js # Index de recherche (FAQ, fonctionnalités)
├── favicon.svg # Favicon généré ou copié
├── robots.txt # SEO
├── CLAUDE.md # Instructions du projet
├── README.md # Documentation du dépôt de la page d'accueil
├── assets/ # Captures d'écran copiées
│ └── [copiés depuis la source]
└── .github/
└── workflows/
└── static.yml # Déploiement GitHub Pages
Étape 5 : Point de validation
Avant de finaliser, vérifier :
- Toutes les sections s'affichent correctement dans un navigateur
- Les liens pointent vers des cibles valides (dépôt GitHub, docs, commandes d'installation)
- La mise en page responsive fonctionne aux largeurs mobile (375px), tablette (768px) et desktop (1280px)
- Accessibilité : liens d'évitement présents, labels ARIA sur les éléments interactifs, contraste des couleurs conforme WCAG AA
Pile technique
- Aucune étape de build : HTML + CSS + JS purs
- Recherche : MiniSearch chargé à la demande depuis un CDN avec solution de repli
- Déploiement : GitHub Pages via Actions
- Style : Propriétés CSS personnalisées, responsive, thème sombre par défaut
- Accessibilité : Liens d'évitement, labels ARIA, navigation au clavier
Modèles CSS (d'après les pages d'accueil établies)
Classes de composants
/* Boutons */
.btn, .btn-primary, .btn-secondary, .btn-github-star, .btn-outline
/* Cartes */
.feature-card, .comparison-card, .path-card
/* Mise en page */
.container, .features-grid, .hero, .section
/* Utilitaires */
.visually-hidden, .skip-link
Variables CSS
:root {
--color-bg: #0d1117;
--color-surface: #161b22;
--color-border: #30363d;
--color-text: #c9d1d9;
--color-text-muted: #8b949e;
--color-primary: #58a6ff;
--color-success: #3fb950;
--color-warning: #d29922;
--color-danger: #f85149;
--space-xs: 0.25rem;
--space-sm: 0.5rem;
--space-md: 1rem;
--space-lg: 1.5rem;
--space-xl: 2rem;
--radius: 6px;
}
Exemple
Utilisateur : /landing-page-generator from ~/projects/mon-projet --risk-banner --pricing-table
Sortie :
Crée ~/projects/mon-projet-landing/ avec :
- Page d'accueil complète présentant le routeur multi-fournisseur
- Bannière d'avertissement CGV bien visible (orange, au-dessus du pli)
- Cartes de fournisseurs (Anthropic, Copilot, Ollama)
- Tableaux de prix depuis le README
- Galerie de captures d'écran
- Prêt pour le déploiement GitHub Pages
Conseils
- Incluez toujours
--risk-bannerpour les projets avec des considérations juridiques/CGV - Les captures d'écran améliorent considérablement la qualité de la page d'accueil - assurez-vous que le dossier assets/ est rempli
- La compétence conserve la langue du README (anglais/français)
- Vérifiez la FAQ générée - une personnalisation peut être nécessaire
- Testez la conception responsive après génération
Références
Voir references/landing-pattern.md pour la documentation détaillée des motifs.
Voir assets/ pour les modèles et extraits réutilisables.