Communitygithub.com

LiChangZheng10086/doyin_ai_video

Utilisez cette compétence à chaque fois qu'un fichier .pptx ou .potx est impliqué de quelque manière que ce soit, en entrée, en sortie ou les deux. Cela inclut la création de présentations, la lecture et l'extraction de texte, l'édition, la fusion ou la division de fichiers, le travail avec des modèles, des mises en page, des notes de l'orateur ou des commentaires.

Qu'est-ce que doyin_ai_video ?

Cette compétence est dédiée à la manipulation complète de fichiers PowerPoint (.pptx) et de modèles (.potx). Elle permet de créer de nouvelles présentations à l'aide de la bibliothèque pptxgenjs, d'éditer des fichiers existants en manipulant directement le XML décompressé, ou d'extraire le contenu via l'outil MarkItDown et des scripts dédiés comme thumbnail.py pour la visualisation. Utile pour tout développeur ou agent IA qui doit générer, modifier ou analyser des présentations de manière programmatique, elle offre des scripts robustes pour la duplication de diapositives, le nettoyage des ressources orphelines et la validation avancée du fichier de sortie. La compétence détaille les pièges courants de pptxgenjs (couleurs hexadécimales, ombres, espacement, graphiques combinés), les procédures pour travailler avec des modèles et les bonnes pratiques de conception pour produire des diapositives visuellement attrayantes avec des palettes de couleurs thématiques et des règles typographiques précises.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/LiChangZheng10086/doyin_ai_video/tree/HEAD/.agents/skills/pptx

Demander à votre IA préférée

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

Documentation

Création, édition et analyse de fichiers PPTX

Un fichier .pptx est une archive ZIP contenant des fichiers XML. Choisissez votre approche en fonction de la tâche :

TâcheApproche
Créer une nouvelle présentationÉcrire un script pptxgenjs — voir les pièges ci-dessous
Éditer une présentation existante, ou construire à partir d'un modèleDécompresser → éditer ppt/slides/slideN.xml → recompresser
Lire le contenumarkitdown deck.pptx (un bloc par diapositive sous les marqueurs <!-- Slide number: N -->); grille visuelle : python scripts/thumbnail.py deck.pptx

Scripts

Les chemins sont relatifs au répertoire de cette compétence. Tout le reste est en Python, Node ou shell.

ScriptCe qu'il fait
scripts/thumbnail.py deck.pptx [prefix]Grille étiquetée de chaque diapositive, pour choisir les mises en page du modèle. .pptx seulement. Passez prefix — par défaut thumbnails, ce qui écrase les grilles de tout autre jeu de diapositives fait dans le même répertoire
scripts/add_slide.py unpacked/ slide2.xml [--after slideN.xml]Duplique une diapositive (ou un slideLayoutN.xml) avec toute la gestion du package. Accepte aussi un .pptx directement avec -o out.pptx
scripts/clean.py unpacked/Supprime les diapositives, médias et relations qui ne sont plus référencés. Exécutez après que <p:sldIdLst> est finalisé
scripts/office/validate.py deck.pptx [--original src.pptx]Vérifications du schéma, des relations, des types de contenu, des graphiques et des diapositives ; chaque échec nomme son correctif. Passez --original pour toute présentation dérivée d'un modèle — cela établit une base des vérifications de schéma par rapport au modèle, de sorte que ses propres erreurs XSD ne soient pas considérées comme les vôtres
scripts/office/soffice.py --headless --convert-to pdf deck.pptxWrapper pour LibreOffice — soffice seul bloque dans ce sandbox

Création avec pptxgenjs — pièges

pptxgenjs est préinstallé — n'exécutez pas npm install d'abord ; écrivez le script et faites require('pptxgenjs') directement. Seulement si cette instruction échoue : npm install pptxgenjs. Le modèle connaît l'API ; voici les pièges :

  • Définissez pres.layout avant d'ajouter des diapositives. Le canevas par défaut est LAYOUT_16x9 = 10" × 5,625", pas 13,3" de large. Les coordonnées dépassant le bord sont écrites, pas ajustées — la forme n'est simplement pas sur la diapositive. (LAYOUT_WIDE fait 13,3" × 7,5".)
  • Couleurs hexadécimales : jamais #, jamais 8 chiffres. color: "FF0000". "#FF0000" ainsi que l'alpha intégré dans l'hexadécimal ("00000020") corrompent le fichier. Pour la translucidité : transparency: 0-100 sur les remplissages et les images, opacity: 0.0-1.0 sur les ombres — chacun est ignoré silencieusement sur l'autre.
  • pptxgenjs modifie les objets d'options sur place (convertit les valeurs en EMU lors de la première utilisation). Ne partagez jamais un objet shadow/options entre deux appels add* — créez un nouvel objet à chaque fois.
  • offset de l'ombre doit être ≥ 0 — un décalage négatif corrompt le fichier. Pour projeter une ombre vers le haut, utilisez angle: 270 avec un décalage positif.
  • letterSpacing est ignoré silencieusement — la bonne option est charSpacing.
  • Listes : bullet: true sur chaque élément, jamais un • littéral (rend des doubles puces). Définissez breakLine: true sur chaque élément du tableau sauf le dernier. Espacez les paragraphes à puces avec paraSpaceAfter, pas lineSpacing (gros écarts).
  • Un new pptxgen() par fichier de sortie — ne réutilisez jamais une instance.
  • rectRadius ne fonctionne que sur ROUNDED_RECTANGLE, pas sur RECTANGLE.
  • Les remplissages dégradés ne sont pas pris en charge — utilisez une image dégradée comme arrière-plan à la place.
  • Les zones de texte ont un remplissage interne intégré — définissez margin: 0 chaque fois que le texte doit s'aligner avec une forme, une ligne ou une icône à la même position x.
  • Les notes de l'orateur vont dans slide.addNotes("...") (texte brut, une fois par diapositive), jamais dans une zone de texte sur la diapositive.
  • Gardez les graphiques natifs. Utilisez addChart() pour tout ce que PowerPoint peut graphiquer (passez un tableau de {type, data, options} pour les combinaisons). Pour les fonctionnalités natives de PowerPoint que la bibliothèque n'expose pas (lignes de tendance, barres d'erreur), calculez la série supplémentaire vous-même ou post-traitez le OOXML généré — ne recourez pas à une image rendue. Seuls les types de graphiques pour lesquels PowerPoint n'a pas de forme native (Sankey, réseau, corde) sont insérés en tant qu'images.
  • Les graphiques par défaut sont nus — pas de titre, pas d'étiquettes de données, palette datée. Définissez showTitle + title, showValue: true + dataLabelPosition, chartColors: [...] à partir de votre palette, et rendez le cadre silencieux (catAxisLabelColor/valAxisLabelColor, valGridLine: { color, size }, catGridLine: { style: "none" }, showLegend: false pour une série unique).
  • Sur un graphique à barres empilées ou à colonnes empilées, dataLabelPosition doit être ctr, inEnd ou inBase. outEnd corrompt le fichier.
  • Une série combinée utilisant secondaryValAxis/secondaryCatAxis a besoin des deux valAxes et catAxes dans les options du graphique, deux entrées chacun. Sans eux, pptxgenjs écrit des ids d'axe qu'il ne déclare jamais, et PowerPoint rejette ce graphique et signale le fichier comme corrompu. Fournir seulement valAxes ne suffit pas.
  • Après writeFile(), exécutez python scripts/office/validate.py deck.pptx. Il signale les deux défauts de graphique ci-dessus et les défauts de XML de diapositive que PowerPoint refuse, et nomme le correctif pour chacun. Corrigez-les dans votre générateur, pas en éditant manuellement le XML compressé.
  • Ne réorganisez jamais les enfants de <p:presentation>. pptxgenjs écrit <p:notesMasterIdLst> juste après <p:sldIdLst> et pointe les deux maîtres vers une seule partie de thème. PowerPoint le lit heureusement — déplacez l'élément et la même présentation devient impossible à ouvrir.
  • Icônes : rendez react-icons en SVG (ReactDOMServer.renderToStaticMarkup), pixellisez avec sharp à ≥256px, et insérez via addImage({ data: "image/png;base64," + buf.toString("base64") }) — le préfixe image/png;base64, est obligatoire (react-icons, react, react-dom et sharp sont préinstallés — npm install react-icons react react-dom sharp seulement si une instruction require échoue).

Édition de présentations et de modèles existants

Choisissez d'abord les mises en page : python scripts/thumbnail.py template.pptx template-thumbs écrit une grille étiquetée de chaque diapositive et imprime le(s) fichier(s) créé(s) — template-thumbs.jpg, divisé en template-thumbs-N.jpg au-delà de 12 diapositives. Passez toujours ce deuxième argument, nommé d'après la présentation. Par défaut, il s'agit de thumbnails, donc deux présentations miniaturisées dans un même répertoire écrasent silencieusement les grilles l'une de l'autre — les grilles de la première présentation sont tout simplement perdues (analyse du modèle uniquement — le contrôle visuel a besoin des rendus haute résolution de Conversion en images ; n'accepte que .pptx, donc copiez d'abord un .potx sous un nom .pptx). Utilisez-le avec markitdown pour mapper chaque section de contenu sur une diapositive du modèle, et variez les mises en page — ne mettez pas chaque section sur la même diapositive titre-et-puces.

python3 -c "import sys,zipfile; zipfile.ZipFile(sys.argv[1]).extractall('unpacked')" deck.pptx
python scripts/add_slide.py unpacked/ slide2.xml --after slide2.xml   # duplique une diapositive (ou slideLayoutN.xml); imprime le chemin de la nouvelle diapositive
# réorganiser / supprimer des diapositives = éditer <p:sldIdLst> dans ppt/presentation.xml
python scripts/clean.py unpacked/                                     # après les suppressions : supprime les diapositives, médias et relations orphelines
# éditer le contenu de la diapositive dans ppt/slides/slideN.xml
(cd unpacked && rm -f ../out.pptx && zip -Xr ../out.pptx .)           # zipper DEPUIS l'intérieur du répertoire ; rm d'abord sinon les parties supprimées survivent
python scripts/office/validate.py out.pptx --original deck.pptx
  • Faites tout le travail structurel — ajouter, supprimer, réorganiser — avant d'éditer le contenu d'une diapositive. add_slide.py copie un fichier de diapositive textuellement, donc dupliquer après avoir édité clone le contenu édité ; et clean.py supprime toute diapositive manquante dans <p:sldIdLst>, y compris celle que vous venez d'écrire.
  • Ne copiez jamais un fichier de diapositive à la main — add_slide.py fait tous les enregistrements nécessaires pour une nouvelle diapositive et signale ce qu'il a créé (Created ppt/slides/slide17.xml from slide2.xml). Il fonctionne aussi directement sur un fichier : add_slide.py deck.pptx slide2.xml -o out.pptx — passez -o, sinon il réécrit la présentation d'entrée sur place. Une diapositive dupliquée référence toujours les parties de graphique/SmartArt/objet incorporé de sa source au lieu de les cloner, donc éditer le graphique d'une diapositive modifie celui de l'autre.
  • Si vous utilisez python-pptx, trois choses qu'il ne fera pas : dupliquer une diapositive (son seul point d'entrée est add_slide(layout)), préserver la mise en forme via text_frame.text = "..." (cela réduit le paragraphe à une seule exécution sans style — utilisez run.text à la place), ou lire le SVG/EMF de la plupart des éléments artistiques des modèles (add_picture lève UnidentifiedImageError).
  • Le format .ppt hérité doit d'abord être converti : python scripts/office/soffice.py --headless --convert-to pptx file.ppt. Les modèles .potx se décompressent et se recompressent à l'identique — conservez l'extension .potx sur la sortie.
  • Pour réutiliser une icône ou une image de modèle, dupliquez une diapositive ou une mise en page qui la contient déjà.

Lors du remplissage d'un modèle :

  • Si vous scriptez une transformation XML, analysez avec defusedxml.minidom — faire passer OOXML par xml.etree.ElementTree réécrit les préfixes d'espace de noms et corrompt la présentation.
  • Les emplacements du modèle ≠ éléments source. Si le modèle montre 4 membres d'équipe et que vous en avez 3, supprimez le groupe entier du 4ème membre (image + zones de texte), pas seulement son texte — puis vérifiez les visuels orphelins lors du contrôle qualité.
  • Un <a:p> par élément de liste — ne concaténez jamais les éléments en un seul paragraphe. Copiez le <a:pPr> frère pour préserver l'espacement, et mettez b="1" sur le <a:rPr> des titres, en-têtes de section et étiquettes en ligne (Status:, Owner:).
  • Laissez les puces hériter de la mise en page ; n'ajoutez que <a:buChar>, <a:buAutoNum> (numéroté) ou <a:buNone> pour remplacer — jamais un • littéral dans le texte.
  • Le texte avec des espaces de début ou de fin a besoin de xml:space="preserve" sur son <a:t>.

Idées de conception

Ne créez pas de diapositives ennuyeuses. De simples puces sur fond blanc n'impressionneront personne. Considérez les idées de cette liste pour chaque diapositive.

Avant de commencer

  • Choisissez une palette de couleurs audacieuse et adaptée au contenu : La palette doit sembler conçue pour CE sujet. Si l'échange de vos couleurs dans une présentation complètement différente "fonctionnait" toujours, vous n'avez pas fait de choix assez spécifiques.
  • Domination plutôt qu'égalité : Une couleur doit dominer (60-70% de poids visuel), avec 1-2 tons de soutien et un accent vif. Ne donnez jamais un poids égal à toutes les couleurs.
  • Contraste clair/foncé : Arrière-plans sombres pour les diapositives de titre + conclusion, clairs pour le contenu (structure "sandwich"). Ou optez pour le sombre partout pour une sensation premium.
  • Adoptez un motif visuel : Choisissez UN élément distinctif et répétez-le — cadres d'image arrondis, icônes dans des cercles colorés. Portez-le sur chaque diapositive. N'utilisez pas de barre de couleur ou de bande d'accentuation comme motif (voir la liste des choses à éviter).

Palettes de couleurs

Choisissez des couleurs qui correspondent à votre sujet — ne vous rabattez pas sur le bleu générique. Utilisez ces palettes comme inspiration :

ThèmePrimaireSecondaireAccentuation
Midnight Executive1E2761 (marine)CADCFC (bleu glacial)FFFFFF (blanc)
Forest & Moss2C5F2D (forêt)97BC62 (mousse)F5F5F5 (crème)
Coral EnergyF96167 (corail)F9E795 (or)2F3C7E (marine)
Warm TerracottaB85042 (terre cuite)E7E8D1 (sable)A7BEAE (sauge)
Ocean Gradient065A82 (bleu profond)1C7293 (sarcelle)21295C (minuit)
Charcoal Minimal36454F (charbon)F2F2F2 (blanc cassé)212121 (noir)
Teal Trust028090 (sarcelle)00A896 (écume de mer)02C39A (menthe)
Berry & Cream6D2E46 (baie)A26769 (rose poussiéreux)ECE2D0 (crème)
Sage Calm84B59F (sauge)69A297 (eucalyptus)50808E (ardoise)
Cherry Bold990011 (cerise)FCF6F5 (blanc cassé)2F3C7E (marine)

Pour chaque diapositive

Chaque diapositive a besoin d'un élément visuel — image, graphique, icône ou forme. Les diapositives uniquement textuelles sont oubliables.

Options de mise en page :

  • Deux colonnes (texte à gauche, illustration à droite)
  • Lignes icône + texte (icône dans un cercle coloré, titre en gras, description en dessous)
  • Grille 2x2 ou 2x3 (image d'un côté, grille de blocs de contenu de l'autre)
  • Image à moitié débordante (côté gauche ou droit complet) avec superposition de contenu

Affichage des données :

  • Chiffres clés en grand (grands nombres 60-72pt avec petites étiquettes en dessous)
  • Colonnes de comparaison (avant/après, pour/contre, options côte à côte)
  • Chronologie ou processus (étapes numérotées, flèches)

Finition visuelle :

  • Icônes dans de petits cercles colorés à côté des en-têtes de section
  • Texte d'accentuation en italique pour les statistiques clés ou les slogans

Typographie

Les noms de polices que vous écrivez dans le .pptx sont rendus par PowerPoint de l'utilisateur, pas par cet environnement. Votre contrôle qualité visuel rend via LibreOffice, qui substitue les polices qu'il ne possède pas — et pour certaines polices, le substitut a des largeurs différentes, donc votre aperçu de contrôle qualité peut montrer un débordement de texte (ou un ajustement) que la vraie présentation n'aura pas. Pour garder votre contrôle qualité fiable :

  • Polices sûres (rendent à largeur réelle dans le contrôle qualité et sont livrées avec Office) : Arial, Calibri, Cambria, Times New Roman, Courier New, Bookman Old Style, Century Schoolbook. Utilisez-les pour le corps du texte et tout ce qui nécessite un ajustement.
  • En-têtes avec personnalité sans risque de contrôle qualité : associez une police serif de la liste sûre pour l'en-tête (Cambria, Bookman Old Style, Century Schoolbook) avec une police sans serif de la liste sûre pour le corps (Calibri ou Arial). Vous obtenez un contraste visuel sans renoncer à des vérifications fiables de débordement.
  • Si l'utilisateur demande une police en dehors de la liste sûre (par exemple Georgia ou Trebuchet MS) : utilisez-la là où l'utilisateur l'a demandée, mais dimensionnez ces conteneurs avec un peu de marge (~10%) et ne faites pas confiance à l'ajustement du texte de l'aperçu sur ces éléments — l'aperçu de cette police est approximatif. Si l'utilisateur n'a pas précisé, préférez les polices de la liste sûre pour le corps du texte.
  • Polices non fiables pour le contrôle qualité (le substitut a des largeurs différentes — les vérifications de débordement peuvent être erronées) : Georgia, Trebuchet MS, Impact, Arial Black, Garamond, Consolas, Palatino Linotype. La substitution de Calibri Light varie selon l'environnement ; traitez-la comme non fiable pour le contrôle qualité. Acceptable pour les titres/accentuations avec marge ; ne faites pas confiance à l'ajustement du texte de l'aperçu sur ces polices.
  • Ne vous rabattez jamais sur Aptos — le défaut d'Office après 2023 n'a pas de substitut compatible métrique ici et est absent des installations Office plus anciennes, donc il n'est fiable des deux côtés.
ÉlémentTaille
Titre de diapositive36-44pt gras
En-tête de section20-24pt gras
Corps du texte14-16pt
Légendes10-12pt atténué

…

[tronqué pour la traduction]

Individual skills in this repo

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

LiChangZheng10086/doyin_ai_video

Browser automation CLI for AI agents. Use when the user needs to interact with websites, including navigating pages, filling forms, clicking buttons, taking screenshots, extracting data, testing web apps, or automating any browser task. Triggers include requests to "open a website", "fill out a form", "click a button", "take a screenshot", "scrape data from a page", "test this web app", "login to a site", "automate browser actions", or any task requiring programmatic web interaction.

LiChangZheng10086/doyin_ai_video

Reference for the Claude API / Anthropic SDK — model ids, pricing, params, streaming, tool use, MCP, agents, caching, token counting, model migration. TRIGGER — read BEFORE opening the target file; don't skip because it "looks like a one-liner" — whenever: the prompt names Claude/Anthropic in any form (Claude, Anthropic, Fable, Opus, Sonnet, Haiku, `anthropic`, `@anthropic-ai`, `claude-*`, `us.anthropic.*`, `[1m]`); the user asks about an LLM (pricing/model choice/limits/caching) — never answer from memory; OR the task is LLM-shaped with provider unstated (agent/MCP/tool-definition/multi-agent/RAG/LLM-judge/computer-use; generate/summarize/extract/classify/rewrite/converse over NL; debugging refusals/cutoffs/streaming/tool-calls/tokens). SKIP only when another provider is being worked on (overrides all triggers): OpenAI/GPT/Gemini/Llama/Mistral/Cohere/Ollama named in the query; OR `grep -rE 'openai|langchain_openai|google.generativeai|genai|mistralai|cohere|ollama'` over the project hits (run this grep FIR...

LiChangZheng10086/doyin_ai_video

Use this skill whenever the user wants to create, read, edit, or manipulate Word documents (.docx files) or Word templates (.dotx files). Triggers include: any mention of 'Word doc', 'word document', '.docx', '.dotx', or requests to produce professional documents with formatting like tables of contents, headings, page numbers, or letterheads. Also use when extracting or reorganizing content from .docx or .dotx files, inserting or replacing images in documents, performing find-and-replace in Word files, working with tracked changes or comments, or converting content into a polished Word document. If the user asks for a 'report', 'memo', 'letter', 'template', or similar deliverable as a Word or .docx file, use this skill. Do NOT use for PDFs, spreadsheets, Google Docs, or general coding tasks unrelated to document generation.

LiChangZheng10086/doyin_ai_video

Guidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.

LiChangZheng10086/doyin_ai_video

Grill me about specs for the workflows I want to build, within this workspace.

LiChangZheng10086/doyin_ai_video

Use this skill whenever the user wants to do anything with PDF files. This includes reading or extracting text/tables from PDFs, combining or merging multiple PDFs into one, splitting PDFs apart, rotating pages, adding watermarks, creating new PDFs, filling PDF forms, encrypting/decrypting PDFs, extracting images, and OCR on scanned PDFs to make them searchable. If the user mentions a .pdf file or asks to produce one, use this skill.

LiChangZheng10086/doyin_ai_video

智能 PPT 生成器。支持 7 种视觉风格(乐高/波普/黏土/黑白/商务/学术/科技),具备根据内容自动推荐风格、生成大纲、绘制配图并组装成片的全自动能力。

LiChangZheng10086/doyin_ai_video

Diagnose and fix React codebase health issues. Use when reviewing React code, fixing performance problems, auditing security, or improving code quality.

LiChangZheng10086/doyin_ai_video

Sentry error monitoring and performance tracing patterns for Next.js applications.

LiChangZheng10086/doyin_ai_video

Simplify and refine recently modified code for clarity and consistency. Use after writing code to improve readability without changing functionality.

LiChangZheng10086/doyin_ai_video

✅ "你知道今天所有大模型能读懂你的话,全靠一个叫Transformer的架构吗?"

LiChangZheng10086/doyin_ai_video

Use this skill any time a spreadsheet file is the primary input or output. This means any task where the user wants to: open, read, edit, or fix an existing .xlsx, .xlsm, .xltx, .csv, or .tsv file (e.g., adding columns, computing formulas, formatting, charting, cleaning messy data); create a new spreadsheet from scratch or from other data sources; or convert between tabular file formats. Trigger especially when the user references a spreadsheet file by name or path — even casually (like \"the xlsx in my downloads\") — and wants something done to it or produced from it. Also trigger for cleaning or restructuring messy tabular data files (malformed rows, misplaced headers, junk data) into proper spreadsheets. The deliverable must be a spreadsheet file. Do NOT trigger when the primary deliverable is a Word document, HTML report, standalone Python script, database pipeline, or Google Sheets API integration, even if tabular data is involved.

Skills associés