Communitygithub.com

Page d'Attente — kelgirechandrakant-cpu/statsarthi

Page de pré-lancement minimale avec capture d'email, logo de marque et couche décorative optionnelle. Lit DESIGN.md pour les couleurs, la typographie et les règles de mise en page. Idéal pour : lancements de produits, inscriptions bêta, programmes d'accès anticipé, projets indépendants.

Qu'est-ce que statsarthi ?

Cette compétence crée une page d'attente de pré-lancement élégante, centrée sur la marque et l'authenticité. Elle lit le fichier `DESIGN.md` pour en extraire la charte graphique (couleurs, polices, espacements) et assemble une page à partir d'un template HTML robuste (`assets/template.html`), en remplaçant des jetons tels que `{{PRODUCT_NAME}}` et `{{BG_EXPRESSION}}` par des valeurs validées et échappées. Le workflow intègre des règles de sécurité strictes : échappement HTML des textes utilisateur, nettoyage des SVG inline, grammaire de couleurs limitée (hex, rgb, hsl, oklch, color-mix) pour empêcher toute injection CSS. La page est responsive (mobile-first, testée à 375×667 et 390×844) et inclut une barre défilante (ticker), une décoration subtile et un formulaire d'email avec validation native. La compétence vérifie une liste de contrôles qualité (P0 obligatoires, P1 recommandés) avant de produire le fichier final `index.html` sous forme d'artefact HTML unique. Elle est conçue pour les agents comme Claude Code, Cursor ou Codex, et garantit une landing page professionnelle, sécurisée et conforme aux bonnes pratiques d'accessibilité.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/kelgirechandrakant-cpu/statsarthi/tree/HEAD/.agents/skills/waitlist-page

Demander à votre IA préférée

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

Documentation

Compétence Page d'Attente

Les pages de pré-lancement sont votre première poignée de main avec vos futurs utilisateurs. Cette compétence construit une entrée ciblée et honnête : votre identité de marque, ce que vous créez, un chemin clair pour rejoindre la liste des premiers inscrits. Pas de rareté artificielle, pas de compte à rebours factice, pas de tactiques d'inflation — juste un réceptacle propre, adapté au mobile, pour un intérêt authentique.

Workflow

Pré-vol : Charger le modèle renforcé et les fondations de la marque

  1. Charger l'identité de la marque — Lisez DESIGN.md pour le système de couleurs, l'association de polices et les règles spatiales. C'est votre fondation. Une page d'attente vit ou meurt par sa cohérence avec la marque qu'elle représente. Si DESIGN.md est manquant, demandez à l'utilisateur d'en fournir un avant de continuer.
  2. Lire et copier le modèle réutilisable — Lisez assets/template.html. Ce modèle est la base renforcée pour toutes les sorties. Copiez-le dans index.html comme base. N'écrivez pas de HTML à partir de zéro ou ne vous écartez pas de cette structure. Le modèle intègre toute la mise en page requise, la structure du formulaire, les décorations, les styles de focus et l'échafaudage d'accessibilité.

Étapes : Remplacement des jetons avec validation et échappement

  1. Mapper les jetons à partir des entrées — Pour chaque espace réservé dans le modèle (par ex., {{PRODUCT_NAME}}, {{BG_EXPRESSION}}, {{BORDER_EXPRESSION}}, {{LOGO_MARK}}), suivez les règles de remplacement ci-dessous :
    • Jetons texte ({{PRODUCT_NAME}}, {{TAGLINE}}) : Échappez les caractères HTML <, >, &, ", ' avant insertion dans les nœuds de texte HTML ou les valeurs d'attributs.
    • Jetons HTML ({{LOGO_MARK}}) : Si vous utilisez des initiales textuelles, échappez-les par défaut pour le HTML. Si vous utilisez du SVG inline, vous devez le nettoyer strictement en utilisant une liste blanche : supprimez les balises <script>, les gestionnaires d'événements (on*), <foreignObject>, les références externes (href, xlink:href, url()), et tout attribut/élément interdit avant insertion. Si le SVG ne peut pas être nettoyé en toute sécurité, revenez aux initiales textuelles échappées. N'émettez jamais de HTML arbitraire non nettoyé et non échappé. Assurez-vous que tout SVG s'adapte proprement dans son conteneur.
    • Jetons d'expression de couleur ({{BG_EXPRESSION}}, {{FG_EXPRESSION}}, {{ACCENT_EXPRESSION}}, {{DECO_EXPRESSION}}, {{STRIPE_EXPRESSION}}, {{SUCCESS_EXPRESSION}}, {{BORDER_EXPRESSION}}, {{BTN_LABEL_EXPRESSION}}, {{TICKER_BG_EXPRESSION}}, {{TICKER_FG_EXPRESSION}}, {{DECO_STROKE_EXPRESSION}}, {{LOGO_SHADOW_EXPRESSION}}, {{LOGO_FG_EXPRESSION}}) : Doivent strictement adhérer à une grammaire de couleur explicite (#hex, rgb/rgba, hsl/hsla, oklch, ou color-mix() utilisant uniquement des variables locales). Rejetez fermement toute entrée contenant ;, {}, <, >, des commentaires (/*), @, url(, ou des références externes pour empêcher l'injection CSS. N'encadrez pas dans # ou n'ajoutez pas de guillemets supplémentaires. Exemples : rgba(196, 169, 154, 0.38), color-mix(in srgb, var(--fg) 38%, transparent), #FDE8DF. Insérez tel quel dans les variables CSS :root. Dérivez --success de DESIGN.md si présent ; sinon, utilisez le repli autorisé #2D6A4F uniquement.
    • Jetons de nom de police ({{DISPLAY_FONT_CSS}}, {{BODY_FONT_CSS}}) : Ce sont des valeurs de font-family CSS, déjà entre guillemets si elles contiennent des espaces (par ex., 'DM Sans', Syne). Insérez tel quel dans les déclarations --font-display et --font-body ; n'ajoutez PAS de guillemets supplémentaires.
    • Jetons d'URL de police ({{DISPLAY_FONT_URL}}, {{BODY_FONT_URL}}) : Les espaces doivent être encodés comme + pour l'URL Google Fonts (par ex., DM+Sans, IBM+Plex+Serif). Validez que l'URL est bien formée avant insertion.
  2. Vérifier les règles de mappage des jetons — Tous les jetons de couleur sont désormais dans les variables CSS :
    • --bg = {{BG_EXPRESSION}} (par ex., #FDE8DF)
    • --fg = {{FG_EXPRESSION}} (par ex., #1A1410)
    • --accent = {{ACCENT_EXPRESSION}} (badge de marque)
    • --deco = {{DECO_EXPRESSION}} (décoration primaire)
    • --deco-stripe = {{STRIPE_EXPRESSION}} (bande d'accent)
    • --input-border = {{BORDER_EXPRESSION}} (expression CSS complète avec opacité)
    • --success = {{SUCCESS_EXPRESSION}} ou repli #2D6A4F
    • --btn-label = {{BTN_LABEL_EXPRESSION}} (couleur du texte du bouton pour le contraste)
    • --ticker-bg = {{TICKER_BG_EXPRESSION}} (fond du ticker animé)
    • --ticker-fg = {{TICKER_FG_EXPRESSION}} (texte du ticker animé)
    • --deco-stroke = {{DECO_STROKE_EXPRESSION}} (traits SVG, généralement atténués avec une opacité de 12 à 15%)
    • --logo-shadow = {{LOGO_SHADOW_EXPRESSION}} (ombre du conteneur de logo, nuance de premier plan subtile)
    • --logo-fg = {{LOGO_FG_EXPRESSION}} (couleur de texte contrastée pour les initiales du logo)
  3. Mise en page responsive — Le modèle inclut une mise à l'échelle mobile-first :
    • 375px : le formulaire s'empile en une seule colonne, le logo rétrécit à 40px, la décoration se compresse, pas de défilement horizontal.
    • 768px : espace de respiration confortable à deux colonnes.
    • 1440px+ : mise en page centrée avec beaucoup d'espace blanc.
    • Vérifiez que tout le texte reste lisible et que la saisie d'email + le bouton sont entièrement visibles (sans rognage) à 375×667 et 390×844.

Validation : Exécuter les contrôles de qualité renforcés avant d'émettre

  1. Exécuter la liste de contrôle qualité — Lisez references/checklist.md. Validez chaque contrôle P0 avant d'émettre :
    • Exactement un CTA (formulaire d'email)
    • Pas de compte à rebours, pas de preuve sociale factice, pas d'emoji
    • Pas de défilement horizontal à 375px
    • La saisie d'email a type="email" et required ; le prénom n'a pas de required
    • Le formulaire N'utilise PAS novalidate ; JS utilise le garde checkValidity()
    • Le message de succès a role="status" ou aria-live="polite"
    • Toutes les couleurs proviennent de DESIGN.md ou du repli autorisé ; aucune valeur hexadécimale inventée
    • Tout le texte utilisateur est échappé HTML ; les jetons de couleur adhèrent à la grammaire stricte ; les polices sont encodées dans l'URL
    • Passez P0 ou n'émettez pas. Si un contrôle P0 échoue, demandez à l'utilisateur ou corrigez les mappages de jetons et réessayez.
  2. Vérifier les contrôles P1 pour une soumission de qualité (recommandé) :
    • États de survol et actif sur le bouton de soumission
    • Validation de formulaire avec retour clair
    • L'animation du ticker respecte prefers-reduced-motion: reduce
    • Tous les éléments interactifs ont des styles de focus visibles (input:focus inclut outline)
    • Prise en charge du clavier Tab/Enter
    • Contraste WCAG AA pour le texte du corps (≥4.5:1) et l'étiquette du bouton (≥4.5:1)
    • Logo alt/aria-label présent ; ticker a aria-hidden="true"
    • <html lang=""> est défini

Sortie

  1. Émettre un HTML propre — Fichier unique, CSS intégré, SVG pour les graphiques. Marquez les éléments interactifs avec data-od-id (titre, formulaire, logo, ticker, grille, etc.) afin que les agents puissent personnaliser sans analyser.

Contrôles qualité

Cette compétence applique un workflow basé sur un modèle renforcé pour garantir la conformité. Vous devez suivre ce chemin d'exécution ; s'écarter du modèle disqualifie la sortie.

Exécution obligatoire basée sur le modèle :

  • Lisez assets/template.html comme base ; n'écrivez pas de HTML à partir de zéro.
  • Copiez-le dans index.html et remplacez uniquement les jetons {{PLACEHOLDER}} par des valeurs validées/échappées.
  • Exécutez chaque contrôle P0 dans references/checklist.md avant d'émettre ; si l'un échoue, corrigez et revalidez.

Contrôles P0 (doivent réussir) :

  • CTA unique : Le formulaire d'email est le seul élément interactif. Pas de navigation, pas de boutons secondaires, pas de liens sociaux.
  • Emplacement du logo : Fixe en haut à gauche, correspond à la couleur d'accent de DESIGN.md, se réduit sur mobile (50px → 40px).
  • Cohérence des couleurs : Chaque couleur provient de la palette DESIGN.md. Seule exception codée en dur autorisée : #2D6A4F pour --success.
  • Pas d'anti-patrons : Pas de compte à rebours, pas de preuve sociale factice, pas d'icônes emoji, pas de lorem ipsum.
  • Intégrité du contenu : Le titre et la copie sont directement liés aux entrées product_name et tagline — pas de contenu de remplissage.
  • Ajustement mobile : Pas de défilement horizontal à 375px. La saisie d'email et le bouton de soumission sont entièrement visibles (sans rognage) à 375×667 et 390×844. Le débordement vertical est défilable, non caché.
  • Discipline typographique : Polices d'affichage + corps uniquement (règle des 2 polices). Taille cohérente entre les sections.
  • Structure du formulaire : Deux champs (prénom optionnel, email requis), garde checkValidity(), message de succès avec role="status".
  • Échappement des jetons : Tout le texte fourni par l'utilisateur est échappé HTML ; les jetons de couleur adhèrent à la grammaire stricte et ne contiennent aucun caractère dangereux (;, {}, <, >, /*, @, url() ; les noms de police sont encodés dans l'URL ; {{LOGO_MARK}} est des initiales textuelles échappées ou du SVG inline strictement nettoyé (pas de scripts, pas de gestionnaires d'événements, pas de foreignObject, pas de hrefs externes).

Contrôles P1 (devraient réussir pour une soumission de qualité) :

  • Section hero visuellement distincte et au-dessus du pli.
  • Le bouton de soumission d'email a des états de survol et actif.
  • La validation du formulaire fournit un retour clair.
  • Page défilable (non rognée) à toutes les fenêtres mobiles ; CTA visible sans défilement.
  • Animation du ticker suspendue/supprimée sous prefers-reduced-motion: reduce.
  • Tous les éléments interactifs ont des styles de focus visibles (outline, pas seulement outline:none).
  • Clavier : Tab atteint chaque champ de formulaire ; Enter soumet.
  • Contraste WCAG AA : Texte du corps ≥4.5:1, étiquette du bouton ≥4.5:1.
  • Logo alt/aria-label présent ; ticker a aria-hidden="true".
  • <html lang=""> défini sur le code de langue correct.

Retenue décorative :

  • La zone inférieure améliore sans distraire. Opacité, traits subtils, animation atténuée.
  • Pas de dégradé qui s'étend sur plus de 20% de la hauteur de la fenêtre.
  • Spirale, bande, grille ou ticker utilisent tous uniquement les couleurs de DESIGN.md.

Sortie

Émettez uniquement après que tous les contrôles P0 dans references/checklist.md passent.

Émettez l'artefact entre les balises :

<artifact identifier="waitlist-id" type="text/html" title="Bientôt disponible — {{PRODUCT_NAME}}">
<!doctype html>
<html lang="en">
...
</html>
</artifact>

Une ligne de description au-dessus de l'artefact ; rien en dessous.

Post-émission : Si l'utilisateur demande des modifications, mettez à jour index.html sur place et réexécutez les contrôles de la checklist P0 avant d'émettre la version suivante. Ne sautez pas la validation sur les itérations.

Individual skills in this repo

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

Skills associés