Aller au guide d’utilisation
pptx-reference-deck-analysispar Seth Hobson

PPTX Reference Deck Analysis Skill.

Un skill Claude Code et Codex pour les présentations PPT : analyse un fichier PPTX de référence pour le thème, la typographie, le rythme de mise en page et les diagnostics.

  • Presentations
  • Rapport de revue
wshobson/agents · plugins/pptx-deck-creation/skills/pptx-reference-deck-analysis/SKILL.mdSKILL.md
--- name: pptx-reference-deck-analysis description: Use when analyzing a reference PPTX for read-only structure, theme, typography, layout rhythm, diagnostics, derived template catalogs, or safe OOXML package inspection. --- ## Contract ## Rules ## OOXML package inspection
En-tête et titres de section lus depuis le fichier source le 14/09/2026 · 2 755 caractères au total

01 Ce qu'il fait

Ce que fait le skill pptx-reference-deck-analysis dans Claude Code et Codex

Résumé, workflow et sorties, tous lus dans le SKILL.md du skill.

D'après le SKILL.mdLu le 14-09-2026 · pas une exécution enregistrée

Dans les termes du Skill

Inspecte un deck PPTX de référence comme preuve de conception et ne le copie, ne le clone ni ne le modifie jamais. Un script python-pptx local à la tâche effectue l'extraction requise à la demande, couvrant un contexte de prompt compact (nombre et taille des diapositives, nombre de formes, signaux de marque, rythme de mise en page), une extraction complète avec des preuves layout_tree en lecture seule, des diagnostics de dossier, une analyse des masters de style et un catalogue de modèles dérivé avec des indices source à base zéro.

Des utilitaires OOXML intégrés gèrent les thèmes bruts, les relations, les notes, les commentaires, les animations, les médias, les masters et les mises en page, et les scripts inspect.py, validate_package.py et unpack.py fournissent un rapport JSON, une validation de package et une extraction optionnelle du package brut. Chaque partie inspectée et chaque exception d'analyse est enregistrée dans un manifeste d'analyse, et les ressources extraites restent hors des nouveaux decks sans preuve de licence.

Ce qu'il produit

  • Contexte de prompt compact : nombre et taille des diapositives, résumés de texte, nombre de formes, styles, signaux de marque, utilisation des modèles et rythme de mise en page.
  • Extraction complète du résumé, des diapositives et des preuves layout_tree en lecture seule.
  • Analyse des masters de style couvrant les couleurs, les polices, la distribution des tailles, l'utilisation des masters/mises en page et les schémas de flux.
  • Un catalogue de modèles dérivé avec des indices source à base zéro, des rôles de mise en page, des zones utilisables, des placeholders, des structures visuelles et des contraintes.
Voir l'exemple de prompt ↗

Fonctionnement

  1. 01
    Écrire un extracteur local à la tâche

    L'extraction requise est implémentée à la demande avec un petit script python-pptx plutôt qu'un pipeline fixe, afin de ne capturer que les informations dont le nouveau deck a besoin.

  2. 02
    Exécuter l'inspection compacte

    scripts/inspect.py prend le chemin du deck et renvoie un rapport JSON couvrant l'ordre des diapositives, le texte, les tokens de thème, les relations, les notes, les commentaires, les animations et les médias.

  3. 03
    Passer aux utilitaires OOXML

    Les utilitaires intégrés constituent la solution de repli pour les thèmes bruts, les relations, les notes, les commentaires, les animations, les médias, les masters et les mises en page que l'extraction de haut niveau ne peut pas voir.

  4. 04
    Ancrer les relations au propriétaire du .rels

    Les cibles de relation sont résolues par rapport à la partie qui possède le fichier .rels, et l'ordre des diapositives n'est jamais déduit des noms de fichiers.

02 Trouvez celui qui vous convient

Quand utiliser le skill pptx-reference-deck-analysis

Utilisez le skill pptx-reference-deck-analysis dans Claude Code ou Codex lorsque le travail concerne PPT et slide decks de ce type. L'adéquation et les limites ci-dessous sont tirées du propre fichier du skill.

Bon choix

  • Vous souhaitez qu'un deck de référence soit lu comme preuve de conception pour un nouveau deck plutôt que dupliqué dans celui-ci.
  • Vous exécutez des diagnostics sur un dossier de decks et souhaitez un résultat par deck plus un manifeste.
  • Vous avez besoin des documents de référence intégrés sur les formes de sortie et les schémas de documentation uniquement.

Connaître les limites

  • Tout ce qui clone ou modifie le deck source au lieu de seulement le lire.

Quoi fournir

  • Le chemin du deck de référenceLes scripts intégrés prennent le .pptx comme premier argument ; c'est la seule entrée requise.
  • Un répertoire de sortie pour les preuves du package brutunpack.py écrit les parties extraites dans un répertoire que vous fournissez, et n'est exécuté que lorsque des preuves de package brut sont nécessaires.
  • defusedxml depuis requirements.txtInstallé avant l'utilisation de tout utilitaire OOXML intégré.

03 Dans le skill

Règles que le skill pptx-reference-deck-analysis donne à Claude Code et Codex

6 instructions concrètes, valeurs par défaut et limites que SKILL.md définit pour l'agent — la partie du fichier qui change le résultat.

  1. Conserver la source en lecture seule

    La présentation de référence n'est jamais modifiée, et chaque coordonnée des nouvelles diapositives cibles est définie de manière indépendante plutôt qu'héritée.

  2. Consigner ce qui a été inspecté

    Chaque partie inspectée et chaque exception d'analyse doit être enregistrée dans le manifeste d'analyse.

  3. Pas de réutilisation sans preuve de licence

    Le contenu extrait, les polices, les images et les ressources propriétaires ne peuvent pas apparaître dans une présentation générée sans autorisation explicite et preuve de licence.

  4. Exécuter depuis un espace de travail de confiance

    Les scripts rejettent le path traversal, les liens symboliques, les membres surdimensionnés et les archives bombes ; ils supposent donc un répertoire de travail de confiance.

  5. Analyser le XML avec Defusedxml

    Le XML non fiable doit passer par defusedxml, avec l'expansion des entités, le chargement des DTD et l'accès réseau tous désactivés.

  6. Traiter les couleurs de thème comme des tokens

    Une couleur de thème reste un token jusqu'à ce qu'elle soit entièrement résolue par rapport au jeu de couleurs.

04 Mettez-le en pratique

Installer pptx-reference-deck-analysis dans Claude Code ou Codex

Une commande npx skills add, puis une première tâche dans votre agent et une checklist pour le résultat.

Ajouter pptx-reference-deck-analysis à Claude Code, Codex ou votre agent

Exécutez-la dans votre projet ; l'installateur demande à quel agent l'ajouter.

Terminal
npx skills add https://github.com/wshobson/agents --skill pptx-reference-deck-analysis

Forme générique de la CLI skills pour plugins/pptx-deck-creation/skills/pptx-reference-deck-analysis/SKILL.md ; le dépôt peut documenter son propre chemin.

Donner à la skill une première tâche PPT et diaporamas

Rédigé dans les termes propres du skill ; remplacez les parties entre crochets par votre contenu.

Starter prompt
I have a reference deck at [path/to/reference.pptx]. Inspect it as design evidence and give me the compact prompt context, a style-master analysis of colors, fonts and flow patterns, and a derived template catalog with layout roles, usable regions and placeholders. Validate the package and record inspected parts and parsing exceptions in the manifest, keeping the source read-only.

Source : rédigé à partir du SKILL.md, dans les termes propres du skill.

Vérifiez le premier résultat

Ce que le SKILL.md lui-même présente comme un résultat correct :

  • Exécutez validate_package.py avec --output et lisez le rapport pour repérer le XML mal formé, les relations internes rompues, les lacunes de type de contenu, les liens de mise en page dupliqués et les parties orphelines.

Dans OpenDesign importez pptx-reference-deck-analysis depuis son lien SKILL.md : Plugins → Add → Skill → Import from link, puis sélectionnez-le dans la barre supérieure.

05 Open source, traçable

Source, licence et vérification

D'où proviennent les faits de cette page et quand ils ont été vérifiés pour la dernière fois.

Repository
github.com/wshobson/agents Branche main
Fichier du skill
plugins/pptx-deck-creation/skills/pptx-reference-deck-analysis/SKILL.md Somme de contrôle du contenu enregistrée lors de la vérification ; commit 4236bb9
License
MIT D'après LICENSE.
Étoiles du dépôt
39 635 Instantané GitHub pris le 14/09/2026 pour l'ensemble du dépôt wshobson/agents, qui contient 18 skills dans ce catalogue. Il ne s'agit pas d'une note ou d'un compteur d'utilisation pour pptx-reference-deck-analysis.
Vérifié par OpenDesign
2026-09-14 Le fichier source, le chemin, le texte de licence et le nombre d'étoiles ont été vérifiés. Non intégré dans OpenDesign main (vérifié le 2026-08-28) ; aucune exécution en conditions réelles n'a été enregistrée sur cette page.

Dans le SKILL.md

  1. ContratLes cinq résultats d'extraction : contexte de prompt, extraction complète, diagnostics de dossier, analyse du style maître, catalogue de modèles.
  2. RèglesSource en lecture seule, coordonnées définies de manière indépendante, journalisation dans le manifeste, preuve de licence avant réutilisation.
  3. Inspection du package OOXMLInstallez defusedxml, puis exécutez inspect.py, validate_package.py et unpack.py ; résolvez les cibles .rels.
  4. SécuritéEspace de travail de confiance, path traversal et archives bombes rejetés, analyse defusedxml, couleurs de thème traitées comme des tokens.
Description du skill lui-même
« Utiliser lors de l'analyse d'un PPTX de référence pour la structure en lecture seule, le thème, la typographie, le rythme de mise en page, les diagnostics, les catalogues de modèles dérivés ou l'inspection sûre du package OOXML. »

Description du front-matter tirée de SKILL.md. Le fichier complet contient environ 2 755 caractères. Lire le fichier complet sur GitHub.

06 Avant d'installer

Questions sur le skill pptx-reference-deck-analysis

Les réponses proviennent du SKILL.md tel que lu le 2026-09-14, et non d'une exécution enregistrée.

L'analyse de ma présentation de référence va-t-elle modifier le fichier ?

Non. Le skill ne modifie jamais une présentation fournie et ne copie jamais aveuglément des parties du package dans une nouvelle présentation ; la source reste en lecture seule et les nouvelles diapositives sont créées de manière indépendante.

PPTX Reference Deck Analysis

Exécutez pptx-reference-deck-analysis sur une tâche PPT et Slide Decks réelle.

Téléchargez OpenDesign, importez pptx-reference-deck-analysis depuis son lien SKILL.md, collez l'invite ci-dessus et lisez le plan avant le résultat.

Terminal
npx skills add https://github.com/wshobson/agents --skill pptx-reference-deck-analysis

OpenDesign Desktop

Un seul design system. Votre marque, cohérente partout

Dans le Vibe Design Workspace complet, appliquez les mêmes règles de marque aux sites, slides, prototypes interactifs, dashboards, images et vidéos HTML. Connectez Codex, Claude Code, Cursor et vos autres agents de code locaux, puis créez gratuitement.

  • Sites, slides, prototypes, dashboards, images et vidéos
  • Plus de 140 design systems et la bibliothèque complète de modèles et skills
  • Codex local et plus de 21 agents de code · Gratuit
Télécharger gratuitement

Disponible sur macOS et Windows