Communitygithub.com

hubeiqiao/apple-bento-grid

Créez des cartes de présentation inspirées d'Apple, avec grilles bento pour vos statistiques, jalons et réalisations. Génère des fichiers HTML autonomes avec grilles sans espace, cartes de stats, étiquettes, graphiques à barres et cartes de citation sombres – optimisés pour l'export d'écrans. Thèmes clair (#f5f5f7) et sombre (#000) disponibles. Idéal pour des cartes de stats, tableaux de bord, présentations Apple, résumés visuels, infographies, diapositives.

Qu'est-ce que apple-bento-grid ?

Cette compétence vous permet de générer des fichiers HTML autonomes et visuellement soignés, imitant l'esthétique des grilles bento d'Apple. Elle transforme vos données (statistiques, jalons, catégories, citations) en cartes élégantes, sans dépendance à des outils de design comme Figma ou Keynote. Le résultat est un fichier HTML unique avec CSS intégré, prêt à être capturé en PNG haute résolution via Playwright. Vous disposez de 7 types de cartes (Hero, Stat, Catégorie, Graphique à barres, Badge, Citation, Highlight), 3 templates de mise en page (horizontale 4 colonnes, horizontale 3 colonnes, verticale 2 colonnes), et des thèmes clair et sombre. La compétence inclut des règles strictes de grille sans espace (gap: 6px, pas d'align-items: start) pour un rendu Apple authentique, ainsi qu'un processus de relecture visuelle pour éviter les lignes orphelines, les débordements de texte et les découpages d'écran. Idéale pour créer des diapositives, des infographies, des résumés de projet ou des publications sur les réseaux sociaux avec une présentation professionnelle et minimaliste.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add hubeiqiao/apple-bento-grid

Demander à votre IA préférée

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

Aperçu

Depuis le README du skill

apple-bento-grid preview

Documentation

Apple Bento Grid

Problème

Créer des graphiques de présentation visuellement soignés nécessite généralement des outils de design comme Figma ou Keynote. Cette compétence génère des mises en page en grille bento de qualité Apple sous forme de fichiers HTML autonomes qui donnent des images parfaites après capture d'écran – sans avoir besoin d'outil de design.

Présentation

Générez des fichiers HTML autonomes qui affichent des grilles de cartes bento inspirées d'Apple. Chaque sortie est un fichier HTML unique avec CSS intégré – aucune dépendance hormis Google Fonts. Les cartes remplissent une grille CSS serrée avec des espacements minimaux, prêtes pour l'export d'écran Playwright en résolution 2x. Les thèmes clair et sombre sont disponibles.

Flux de travail

  1. Lisez le système de design sélectivement : Consultez design-system.md selon les besoins :
    • Toujours lire : Section 2 (Grille sans espace) + Section 3 (Modèles de mise en page) – la base de la grille
    • Lire par type de carte : Sections 5.1–5.7 selon les cartes utilisées
    • Lire pour le thème : Section 1 (jetons clairs) ou Section 9 (jetons sombres)
    • Lire une fois pour la première génération : Section 8 (Squelette HTML) comme point de départ structurel
  2. Recueillez le contenu de l'utilisateur – quelles statistiques, jalons, catégories et citations mettre en avant
  3. Choisissez un thème – proposez le thème clair, sombre, ou les deux selon le contexte (voir Sélection du thème ci-dessous)
  4. Choisissez une mise en page – sélectionnez parmi les 3 modèles de mise en page en fonction du nombre de cartes et de l'orientation
  5. Composez les cartes – choisissez les types de cartes et remplissez-les avec le contenu de l'utilisateur ; privilégiez la densité (pas de cartes vides)
  6. Demandez les logos/images – si l'utilisateur a un logo ou des images, intégrez-les (voir Logos & Images ci-dessous)
  7. Générez le HTML – produisez un fichier HTML unique autonome
  8. Relecture visuelle – ouvrez le HTML dans un navigateur et faites une capture d'écran pour vérifier les problèmes (voir Relecture visuelle ci-dessous)
  9. Proposez une version verticale – après avoir généré une grille paysage, demandez : « Vous voulez une version verticale (portrait) pour les réseaux sociaux ? » et générez une adaptation du modèle C si oui
  10. Capture d'écran (optionnelle) – utilisez le script Playwright pour capturer des PNG en 2x

Relecture visuelle

Après avoir généré le HTML, visualisez toujours le résultat pour détecter les problèmes visuels avant de le présenter à l'utilisateur. Utilisez Playwright, les outils MCP du navigateur ou open pour afficher le fichier, puis vérifiez :

Lignes orphelines – Une seule étiquette ou un mot qui se retrouve seul sur une nouvelle ligne. Corrigez en supprimant une étiquette pour que les étiquettes restantes remplissent uniformément, ou ajoutez suffisamment d'étiquettes pour remplir deux lignes complètes.

Espace vide – Des cartes qui semblent clairsemées avec trop d'espace blanc. Corrigez en ajoutant un sous-titre, un badge ou un texte de description supplémentaire pour remplir la carte.

Débordement de texte – Des nombres ou des étiquettes trop longs pour la largeur de leur carte. Corrigez en réduisant la taille de la police ou en abrégeant (par exemple, « 2,4 M$ » au lieu de « 2 400 000 $ »).

Grille cassée – Espaces de ligne visibles ou cartes mal alignées. Vérifiez : pas de align-items: start, l'espacement est exactement de 6px, toutes les cellules de la grille sont occupées.

Police de secours – Texte rendu avec les polices système au lieu de Sora/DM Sans. Assurez-vous que le lien Google Fonts est présent et que la page a accès au réseau.

Découpage de la capture d'écran – Les bords droit ou inférieur des cartes sont coupés dans le PNG exporté. Corrigez en vous assurant que la largeur de la zone d'affichage correspond exactement à la largeur CSS de la grille et que le clip utilise box.x/box.y de boundingBox(), pas x: 0, y: 0.

Si des problèmes sont détectés, corrigez le HTML et revérifiez. Ne présentez pas le résultat à l'utilisateur tant que la sortie n'a pas passé la relecture visuelle.

Sélection du thème

Proposez un thème en fonction du contexte. En cas de doute, générez les deux.

ContexteThème suggéré
Diaporama / présentationSombre – impact visuel plus fort sur les projecteurs
Réseaux sociaux / portfolioSombre – se démarque dans les flux
Rapport / intégration dans un documentClair – correspond aux fonds de page blancs
Impression / PDFClair – économise l'encre, meilleure lisibilité
L'utilisateur dit « style Apple »Clair – l'apparence signature d'Apple
L'utilisateur dit « moderne » ou « élégant »Sombre – aspect contemporain
Aucune préférence expriméeLes deux – générez deux fichiers, laissez l'utilisateur choisir

Voir design-system.md Section 9 pour les jetons complets du thème sombre, ou Section 1 pour les jetons du thème clair.

Format de sortie

Produisez toujours un fichier HTML unique autonome avec :

  • <!DOCTYPE html> + <html lang="fr">
  • Balises <link> Google Fonts dans <head>
  • Tout le CSS dans un seul bloc <style>
  • Tout le contenu dans <body> – pas de JavaScript nécessaire

Types de cartes disponibles

CarteUtilisationFonctionnalité clé
HeroSlogans, titresBordure supérieure dégradée, s'étend sur 2 lignes
StatNombres + libellésAccent coloré par catégorie
CatégorieÉléments groupés (phases, équipes, trimestres)Étiquette de couleur + sous-titre + étiquettes
Graphique à barresCroissance / comparaison dans le tempsBarres dégradées, badge d'en-tête
BadgeAttribution d'outil, appel mis en avantIcône d'étiquette + nombre stat
CitationMission, témoignageFond sombre, texte blanc, <em> vert
HighlightNombre vedette (3x, 10x, 100%)Fond entièrement dégradé

Modèles de mise en page

ModèleColonnesLargeurRatio d'aspectIdéal pour
A : Horizontale4 col1200px52/2512-16 cartes, diapositives
B : Horizontale3 col1100px52/228-10 cartes, ciblé
C : Verticale2 col600pxaucun (contenu)8-14 cartes, réseaux sociaux

Règles critiques : Grille sans espace

Ces 5 règles sont obligatoires pour une apparence de type Apple. Voir la section 2 de design-system.md pour les détails.

  1. NE JAMAIS définir align-items: start – la valeur par défaut stretch remplit les cellules
  2. Utilisez aspect-ratio sur les mises en page horizontales pour verrouiller la forme du conteneur
  3. Lignes : 1fr pour l'horizontal, auto pour le vertical
  4. Espacement : 6px (pas 8px)
  5. Chaque cellule de la grille doit être occupée – pas de cellules vides

Export d'écran

Utilisez le script Playwright à l'emplacement scripts/screenshot.mjs pour capturer des PNG parfaits.

cd scripts
npm install
npx playwright install chromium
node screenshot.mjs

Modifiez le tableau pages dans screenshot.mjs pour pointer vers vos fichiers HTML. Chaque entrée a besoin de : file (chemin HTML), output (chemin PNG), viewportWidth (correspond à la largeur de la grille).

Critique : La zone d'affichage doit correspondre à la largeur de la grille. Si la zone d'affichage est plus large que la grille, la grille se centre et le clip peut couper le bord droit. Définissez toujours viewportWidth sur la largeur exacte de la grille CSS (1200 pour 4 col, 1100 pour 3 col, 600 pour 2 col).

Critique : Le clip doit utiliser la position de l'élément. Lors du clip sur l'élément de grille, utilisez box.x et box.y de boundingBox(), pas x: 0, y: 0. Si la grille est centrée dans une zone d'affichage plus large, x: 0 commencera le clip avant la grille et coupera le côté droit.

Après la capture, visualisez toujours l'image de sortie pour vérifier qu'aucun bord n'est coupé. Vérifiez que les cartes les plus à droite et en bas sont entièrement visibles avec leur bordure intacte.

Logos & Images

Les utilisateurs peuvent ajouter leurs propres logos ou images aux cartes de la grille bento. Demandez à l'utilisateur s'il a des logos ou images à inclure.

Options de placement :

EmplacementComment faireIdéal pour
Coin de la carte Hero<img> avec position: absolute; top: 20px; right: 20px; width: 40px;Logo de l'entreprise
Icône de la carte BadgeRemplacez le SVG dans .badge-pill par une balise <img> (width: 16px; height: 16px; border-radius: 4px;)Logo d'outil/framework
Fond de carte entierbackground-image: url(...) avec dégradé de superposition pour la lisibilité du texteCaptures d'écran de fonctionnalités
Carte image autonome<img> remplissant la carte avec object-fit: cover; border-radius: 18px;Photos de produits

Recommandations :

  • Utilisez <img src="chemin/vers/fichier.png"> avec un chemin de fichier local – le HTML est destiné à l'export d'écran, pas à l'hébergement
  • Gardez les logos petits (24–48px) pour qu'ils ne dominent pas la carte
  • Pour le thème sombre, assurez-vous que les logos fonctionnent sur des fonds sombres (utilisez des versions blanches/claires)
  • Ajoutez toujours un texte alt pour l'accessibilité

Adaptation du contenu

Données de l'utilisateurModèle recommandéCombinaison de cartes
3–5 statistiques, pas de catégoriesC (2 col vertical)1 Hero + 3–5 Stats + 1 Citation
6–8 statistiques, 1–2 catégoriesB (3 col horizontal)1 Hero + 4–6 Stats + 1–2 Catégories + 1 Graphique
8–12 statistiques, 3+ catégoriesA (4 col horizontal)Mélange complet : Hero, Stats, Catégories, Graphique, Badge, Citation, Highlight
Réseaux sociaux / format portraitC (2 col vertical)N'importe quel mélange, polices plus petites

Règle de densité : Chaque carte doit sembler pleine. Si une carte paraît clairsemée, ajoutez un sous-titre, un badge ou des étiquettes. Si la grille comporte de l'espace vide visible, soit étendez une carte sur plusieurs cellules, soit ajoutez une carte de support.

Liste de personnalisation

  1. Recueillez le contenu – statistiques, catégories, jalons, citations
  2. Choisissez le thème – clair, sombre ou les deux
  3. Choisissez la mise en page – 4 col, 3 col ou 2 col
  4. Nommez les zones de la grille – noms lisibles correspondant au contenu
  5. Sélectionnez les types de cartes – Hero, Stat, Catégorie, Graphique, Badge, Citation, Highlight
  6. Attribuez les couleurs d'accent – une par catégorie, maximum 3–4 accents
  7. Définissez les dimensions – la largeur de la zone d'affichage correspond à la largeur de la grille
  8. Verrouillez le ratio d'aspect – horizontal uniquement ; omettez pour le vertical
  9. Vérifiez la densité – pas de cartes vides, pas de cellules de grille inutilisées, espacement 6px
  10. Adaptez à l'orientation – le vertical obtient des polices, espacements et rayons plus petits
  11. Capture d'écran – Playwright en 2x, la zone d'affichage correspond à la largeur de la grille

Vérification

Après avoir généré un fichier HTML de grille bento :

  1. Ouvrez dans Chrome ou Safari – vérifiez que toutes les cellules de la grille sont remplies sans espace de ligne visible
  2. Vérifiez le chargement des polices – Sora et DM Sans doivent s'afficher (pas de secours système)
  3. Pour le thème sombre – vérifiez que les fonds des cartes sont #1a1a1a, pas #fff
  4. Capture d'écran à la bonne largeur de zone d'affichage (1200/1100/600) en résolution 2x
  5. Confirmez la densité – aucune carte ne doit avoir d'espace blanc excessif

Notes

  • Google Fonts nécessite un accès Internet ; les grilles utilisent les polices système hors ligne
  • La capture d'écran Playwright est optionnelle ; les utilisateurs peuvent faire des captures d'écran manuelles dans le navigateur
  • aspect-ratio est uniquement pour les mises en page horizontales ; les mises en page verticales s'adaptent à la hauteur du contenu
  • Maximum 3–4 couleurs d'accent par grille pour conserver la retenue d'Apple
  • Cette compétence produit du HTML statique pour l'export d'écran, pas des tableaux de bord interactifs
  • Pour les grilles avec moins de 6 points de données, le modèle C (2 col vertical) fonctionne généralement le mieux

Fichiers de référence

  • design-system.md – Jetons de design complets (clair + sombre), CSS/HTML des cartes, modèles de mise en page et squelette
  • scripts/screenshot.mjs – Script de capture d'écran Playwright

Skills associés