Communitygithub.com

sharonzhang98/editorial-pptx-deck

Compétence pour Cursor Agent : construire des présentations PPTX professionnelles au style éditorial minimaliste à partir de diapositives HTML.

Qu'est-ce que editorial-pptx-deck ?

Cette compétence permet de générer des présentations PowerPoint (PPTX) éditables, au style éditorial minimaliste, en partant de diapositives HTML. Elle est conçue pour les agents Cursor (tels que Cursor Agent) et exploite un pipeline de construction qui transforme des fichiers HTML contraints en objets PowerPoint natifs (zones de texte modifiables en double-clic) via le script `scripts/html2pptx.js`. Le format de corps est fixé à 1280 px × 720 px (960 pt × 540 pt, `LAYOUT_WIDE`). La compétence propose un système de conception complet, défini dans `shared/tokens.css`, avec des couleurs et des polices spécifiques (Georgia pour les titres, Arial/Helvetica pour le reste), une signature visuelle (barre rouge verticale, kicker, numéro de page), et une bibliothèque de photos. Elle inclut un catalogue de modèles de diapositives (couverture, séparateur, trois colonnes, tableau comparatif, etc.) et impose des contraintes strictes de rendu (pas de texte flottant, pas de dégradés CSS, etc.) pour garantir la conversion HTML→PPTX. Le résultat final est uniquement le fichier `.pptx` ; les diapositives HTML et autres fichiers temporaires sont nettoyés après la génération.

Compatible avec~Claude Code~Codex CLI✓Cursor
npx skills add sharonzhang98/editorial-pptx-deck

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

editorial-pptx-deck preview

Documentation

Présentation PPTX Éditoriale

Produisez un diaporama soigné, au style éditorial minimaliste, et exportez-le au format PPTX éditable. Le livrable final est uniquement le fichier .pptx — les diapositives HTML ne sont que la source de construction, et les visionneuses PDF/HTML ne sont pas produites.

Fonctionnement

Les diapositives sont rédigées sous forme de HTML contraint (un fichier par diapositive), puis le script scripts/html2pptx.js traduit chaque élément DOM en un objet PowerPoint natif (zones de texte réelles, modifiables en double-clic). Le corps est fixé à 1280 px × 720 px = 960 pt × 540 pt (LAYOUT_WIDE).

Workflow de construction

Copiez cette liste de contrôle et suivez la progression :

- [ ] 1. Initialiser le projet (shared/ assets/ slides/ output/)
- [ ] 2. Planifier le récit → mapper chaque diapositive à un type de modèle
- [ ] 3. Rédiger les diapositives slides/NN-name.html à partir des modèles (modifier uniquement le texte)
- [ ] 4. check_overflow → corriger toute diapositive qui ne fait pas exactement 1280x720
- [ ] 5. Exporter le PPTX (uniquement)
- [ ] 6. Nettoyer la source de construction (conserver uniquement le .pptx)

1. Initialisation. Dans le projet de travail, créez shared/, assets/, slides/, output/. Copiez shared/tokens.css de cette compétence dans le dossier shared/ du projet. Copiez uniquement les photos que vous utiliserez depuis le dossier assets/ de cette compétence dans le dossier assets/ du projet. Installez les dépendances une fois :

npm i pptxgenjs playwright sharp && npx playwright install chromium

2. Planification. Transformez le contenu source en une liste de diapositives. Chaque diapositive correspond à l'un des types de modèles. Un diaporama typique = couverture → (séparateur → 1 à 3 diapositives de contenu) × sections → conclusion. Gardez le texte concis ; ce style est aéré.

3. Rédaction des diapositives. Copiez le modèle le plus proche depuis templates/ dans slides/NN-name.html et remplacez le texte. Règles :

  • Conservez <link rel="stylesheet" href="../shared/tokens.css">.
  • Les titres utilisent la police serif ; tout le reste est en sans-serif (déjà câblé dans les tokens).
  • Un seul accent rouge. Utilisez le panneau sombre (--ink-panel) avec parcimonie pour le contraste, avec l'accent doré #C9A24B.
  • Les photos sont insérées via <img> (jamais en background-image CSS). Voir la bibliothèque de photos.

4. Vérification de l'ajustement. Les diapositives qui débordent sont rognées dans le PPTX :

node scripts/check_overflow.mjs --slides slides

Corrigez tout ce qui est signalé OVERFLOW (raccourcissez le texte ou ajustez les positions) jusqu'à ce que tout indique 1280x720.

5. Exportation du PPTX uniquement.

node scripts/export_deck_pptx.mjs --slides slides --out output/NomDeDeck.pptx

Les diapositives sont ordonnées par nom de fichier (01-…, 02-…). N'exécutez aucun export PDF/HTML — le PPTX est le seul livrable.

6. Nettoyage. Supprimez les fichiers HTML de slides/ et tous les fichiers temporaires, de sorte qu'il ne reste que output/NomDeDeck.pptx (plus les dossiers réutilisables shared/ et assets/ si l'utilisateur souhaite itérer).

Système de conception

Défini dans shared/tokens.css. N'inventez pas de nouvelles couleurs.

TokenHEXUtilisation
--ink#1A1A1ATitres et corps principal
--soft#555555Corps secondaire
--muted#8C8C8CÉtiquettes, notes, numéros de page
--red#C8102EL'accent unique : barre, amorce, mots-clés, soulignés
--red-deep#A00C24Accentuation négative dans les tableaux
--red-pale#FBE9ECPuces de liaison (par exemple, cercles « → »)
--box#F4F3F1Cartes claires / lignes zébrées
--line#E4E2DESéparateurs fins
--ink-panel#1C1C1CPanneaux de contraste sombres
gold#C9A24BAccent uniquement sur les panneaux sombres
background#FFFFFFPage
  • Police : Georgia serif pour les h* / titres ; Arial/Helvetica sans-serif pour tout le reste.
  • Signature : fine barre verticale rouge à gauche du titre + petite amorce rouge espacée au-dessus ; numéro de page minuscule centré en bas.
  • Remplacement de marque : pour correspondre à une autre société, modifiez --red (et éventuellement --ink-panel/gold) dans tokens.css — rien d'autre.

Bibliothèque de photos

Les photos se trouvent dans le dossier assets/ de cette compétence. Les images portrait remplissent la partie droite (~40 % du panneau du séparateur/de couverture (object-fit:cover) ; les images paysage conviennent aux couvertures pleine page.

FichierOrientationIdéal pour
sail.pngportrait 589×1024séparateur / panneau droit de couverture (par défaut)
lighthouse-cliff.pngportrait 627×1024séparateur / panneau droit de couverture
staircase.pnghaute 312×1024bande de séparateur calme/abstraite
mast.pngétroite 208×1024bande de séparateur étroite
hiker-clouds.pngétroite 225×1024bande de séparateur étroite
lighthouse-sunset.pngpaysage 1024×721couverture pleine page / bande supérieure
sailboat-deck.pngpaysage 1024×721couverture pleine page / bande supérieure

Remplacez une photo en modifiant <img src="../assets/….png">. Utilisez une photo cohérente (ou un motif cohérent) sur tous les séparateurs pour garantir l'harmonie. Les utilisateurs peuvent également placer leurs propres images dans assets/.

Catalogue de modèles

Dans templates/ (chaque modèle est une diapositive complète, sans débordement, de 1280×720) :

FichierType
01-cover.htmlCouverture divisée : titre serif à gauche, photo portrait à droite
02-divider.htmlSéparateur de section : amorce + titre serif + barre rouge, photo portrait à droite
03-three-column.htmlAmorce/titre + ligne de base + 3 colonnes + bande de résultat
04-mapping.htmlDeux colonnes « ce qu'ils veulent → ce que nous faisons » avec puces de liaison
05-compare-table.htmlTableau comparatif à 3 colonnes, lignes zébrées
06-dark-contrast.htmlDeux panneaux (clair vs sombre) + ligne de pied serif
07-pipeline.htmlPipeline d'étapes horizontales numérotées + barre de résultat sombre
08-closing.htmlArgumentaire de clôture : lignes serif numérotées + photo portrait à droite

Contraintes strictes

La conversion HTML→PPTX échoue ou se rend mal si ces règles ne sont pas respectées. Détails complets + correctifs dans reference.md :

  1. Texte uniquement à l'intérieur de <p>/<h1>–<h6> (jamais de texte libre dans un <div>).
  2. Pas de dégradés CSS.
  3. background/border/box-shadow uniquement sur <div>, jamais sur les balises de texte.
  4. Pas de background-image ; utilisez <img>.
  5. Les balises en ligne (span/em/strong) ne peuvent pas avoir de marges.
  6. Le corps reste à 1280×720 ; rien ne doit déborder.

Skills associés