Communitygithub.com

jpoindexter/theft-kit

Page d'attente minimale avant lancement 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 theft-kit ?

Cette compétence construit une page d'attente de pré-lancement minimale et élégante, respectant les principes d'honnêteté et de simplicité. Elle lit automatiquement un fichier `DESIGN.md` pour appliquer la charte graphique (couleurs, polices, espacements) et utilise un modèle HTML renforcé (`assets/template.html`) pour produire une page unique, optimisée mobile et accessible. Elle gère le remplacement sécurisé de variables (textes échappés, SVG de logo nettoyé) et empêche activement les motifs anti-éthiques comme les compteurs factices ou les preuves sociales artificielles. Destinée aux agents de codage (Claude Code, Cursor, Codex), elle garantit une livraison fiable via des contrôles qualité stricts (P0) avant chaque sortie, couvrant la sécurité, l'accessibilité, la réactivité et la conformité à la charte.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/jpoindexter/theft-kit/tree/HEAD/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 d'attente. Pas de rareté artificielle, pas de compte à rebours factice, pas de tactiques d'inflation — juste un contenant propre et mobile-first 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 vers index.html comme base. N'écrivez pas de HTML from scratch et ne déviez 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'infrastructure d'accessibilité.

Étapes : Remplacement de jetons avec validation et échappement

  1. Mapper les jetons à partir des entrées — Pour chaque espace réservé dans le modèle (ex. {{PRODUCT_NAME}}, {{BG_EXPRESSION}}, {{BORDER_EXPRESSION}}, {{LOGO_MARK}}), suivez les règles de remplacement ci-dessous :
    • Jetons texte ({{PRODUCT_NAME}}, {{TAGLINE}}) : Échappez HTML <, >, &, ", ' avant l'insertion dans les nœuds de texte HTML ou les valeurs d'attribut.
    • Jetons HTML ({{LOGO_MARK}}) : Si vous utilisez des initiales textuelles, échappez-les HTML par défaut. Si vous utilisez du SVG en ligne, vous devez strictement le nettoyer à l'aide d'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 non autorisé avant l'insertion. Si le SVG ne peut pas être nettoyé en toute sécurité, revenez aux initiales textuelles échappées. N'émettez jamais de code HTML brut non nettoyé. 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 éviter l'injection CSS. N'encapsulez pas dans # et 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 uniquement le repli autorisé #2D6A4F.
    • Jetons de nom de police ({{DISPLAY_FONT_CSS}}, {{BODY_FONT_CSS}}) : Ce sont des valeurs CSS font-family, déjà entre guillemets si elles contiennent des espaces (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 en + pour l'URL Google Fonts (ex. DM+Sans, IBM+Plex+Serif). Validez que l'URL est bien formée avant l'insertion.
  2. Vérifier les règles de mappage des jetons — Tous les jetons de couleur sont maintenant dans des variables CSS :
    • --bg = {{BG_EXPRESSION}} (ex. #FDE8DF)
    • --fg = {{FG_EXPRESSION}} (ex. #1A1410)
    • --accent = {{ACCENT_EXPRESSION}} (badge de marque)
    • --deco = {{DECO_EXPRESSION}} (décoration primaire)
    • --deco-stripe = {{STRIPE_EXPRESSION}} (rayure 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 du logo, nuance subtile de premier plan)
    • --logo-fg = {{LOGO_FG_EXPRESSION}} (couleur de texte contrastante pour les initiales du logo)
  3. Mise en page responsive — Le modèle inclut une mise à l'échelle mobile-first :
    • 375px : le formulaire passe en colonne unique, le logo réduit à 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 généreux espaces blancs.
    • Vérifiez que tout le texte reste lisible et que l'entrée email + le bouton sont entièrement visibles (sans coupure) à 375×667 et 390×844.

Validation : Exécuter les contrôles qualité renforcés avant l'émission

  1. Exécuter la liste de contrôle qualité — Lisez references/checklist.md. Validez chaque contrôle P0 avant l'émission :
    • Exactement un CTA (formulaire email)
    • Pas de compte à rebours, pas de preuve sociale factice, pas d'emoji
    • Pas de défilement horizontal à 375px
    • L'entrée email a type="email" et required ; le prénom n'a pas de required
    • Le formulaire n'utilise PAS novalidate ; le JS utilise la garde checkValidity()
    • Le message de succès a role="status" ou aria-live="polite"
    • Toutes les couleurs proviennent de DESIGN.md ou d'un repli autorisé ; aucune valeur hexadécimale inventée
    • Tout le texte utilisateur est échappé HTML ; les jetons de couleur adhèrent à une 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 survol et actif sur le bouton de soumission
    • Validation du 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 clavier Tab/Entrée
    • 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 du 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 impose un workflow basé sur un modèle renforcé pour garantir la conformité. Vous devez suivre ce chemin d'exécution ; toute déviation par rapport au 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 from scratch.
  • Copiez-le vers 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 un échoue, corrigez et revalidez.

Contrôles P0 (doivent réussir) :

  • CTA unique : Le formulaire 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. L'entrée email et le bouton de soumission sont entièrement visibles (sans coupure) à 375×667 et 390×844. Le débordement vertical est défilable, pas 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 à une grammaire stricte et ne contiennent pas de caractères dangereux (;, {}, <, >, /*, @, url() ; les noms de police sont encodés dans l'URL ; {{LOGO_MARK}} est des initiales textuelles échappées ou du SVG en ligne 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 héros visuellement distincte et au-dessus de la ligne de flottaison.
  • Le bouton de soumission email a des états survol et actif.
  • La validation du formulaire fournit un retour clair.
  • La page est défilable (non coupée) sur toutes les fenêtres mobiles ; le CTA est visible sans défilement.
  • L'animation du ticker est interrompue/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 du formulaire ; Entrée 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, rayure, grille ou ticker utilisent uniquement les couleurs de DESIGN.md.

Sortie

Émettez uniquement après que tous les contrôles P0 dans references/checklist.md sont réussis.

Émettez l'artefact entre les balises :

<artifact identifier="waitlist-id" type="text/html" title="Coming Soon — {{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 liste P0 avant d'émettre la version suivante. Ne sautez pas la validation lors des itérations.

Individual skills in this repo

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

jpoindexter/theft-kit

Produce a print-grade single-page kami (紙 / 纸) document — warm parchment canvas, ink-blue accent, serif at one weight, no italic, no cool grays. The output reads like a professional white paper or studio one-pager, not an app UI. Multilingual by design (EN · zh-CN · ja). One self-contained HTML file, zero dependencies.

jpoindexter/theft-kit

Read-only queue dashboard for workspace-aware ship. Shows which VERSION slots are currently claimed by open PRs, which sibling Conductor workspaces have WIP work likely to ship soon, and what slot /ship would pick next. No mutations — just a snapshot. Use when asked to "landing report", "what's in the queue", "show me open PRs", or "which version do I claim next". (gstack)

jpoindexter/theft-kit

Produce a single-file slide deck in the Atelier Zero visual language (warm-paper background, italic-serif emphasis spans, coral terminating dots, surreal collage plates) — Open Design's brand deck recipe. The deck uses **horizontal magazine-style swipe pagination** (←/→, wheel, swipe), a per-slide chrome strip with brand mark and slide counter, an ESC overview grid, a coral progress bar, and inherits the canonical stylesheet + 16-slot image library from the sister `open-design-landing` skill.

jpoindexter/theft-kit

Produce a world-class single-page editorial landing site in the Atelier Zero visual language (Monocle / Apartamento / Études editorial collage) — the same aesthetic Open Design uses for its own marketing surface. The agent fills a typed `inputs.json` from a brand brief, optionally generates 16 collage assets via gpt-image-2, then runs a pure-function composer that emits a self-contained HTML file; a separate path can mirror the Astro marketing site in `apps/landing-page/`. Drop-in scroll-reveal motion and a Headroom-style sticky nav are wired automatically.

jpoindexter/theft-kit

Single-page SaaS landing with hero, features, social proof, pricing, and CTA. Respects the active DESIGN.md color/typography/layout tokens. Trigger keywords: "saas landing", "marketing page", "product landing".

Skills associés