Communitygithub.com

Creación, edición y análisis de PPTX

Usa esta habilidad cada vez que un archivo .pptx o .potx esté involucrado de alguna manera: como entrada, salida o ambos. Esto incluye: crear presentaciones, leer, modificar, combinar o dividir archivos, y trabajar con plantillas, diseños, notas del orador o comentarios.

¿Qué es Creación, edición y análisis de PPTX?

Esta habilidad proporciona un conjunto completo de herramientas y scripts para trabajar con presentaciones de PowerPoint (archivos .pptx y .potx) desde la línea de comandos o scripts en Node.js y Python. Es especialmente útil para desarrolladores y profesionales técnicos que necesitan automatizar la creación, edición, análisis o conversión de presentaciones de diapositivas. La habilidad se basa en el uso de 'pptxgenjs' para crear nuevas presentaciones desde cero y en un flujo de trabajo de descompresión → edición de XML → recomprimir para modificar presentaciones existentes o rellenar plantillas. Además, incluye scripts de utilidad para generar miniaturas, validar la integridad del archivo OOXML, agregar diapositivas duplicadas y limpiar referencias huérfanas. La habilidad está diseñada para plataformas como Claude Code, Cursor, Codex y otros asistentes de codificación AI que pueden ejecutar comandos de shell y scripts de Node.js/Python. Al seguir las pautas detalladas (especialmente las 'gotchas' de pptxgenjs) se pueden evitar errores comunes que corrompen los archivos, y las herramientas de validación integradas garantizan que el resultado final sea compatible con PowerPoint.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

¿Qué hace Creación, edición y análisis de PPTX?

Un .pptx es un archivo ZIP que contiene archivos XML. Elige tu enfoque según la tarea:

TareaEnfoque
Crear una nueva presentaciónEscribe un script pptxgenjs — consulta las advertencias abajo
Editar una presentación existente, o construir a partir de una plantilladescomprimir → editar ppt/slides/slideN.xml → comprimir
Leer contenidomarkitdown deck.pptx (un bloque por diapositiva bajo marcadores <!-- Slide number: N -->); cuadrícula visual: python scripts/thumbnail.py deck.pptx

Scripts

Las rutas son relativas al directorio de esta habilidad. Todo lo demás es Python, node o shell simples.

ScriptQué hace
scripts/thumbnail.py deck.pptx [prefijo]Cuadrícula etiquetada de cada diapositiva, para elegir diseños de plantilla. Solo .pptx. Pasa prefijo — por defecto es thumbnails, lo que sobrescribe las cuadrículas de cualquier otra presentación hecha en el mismo directorio
scripts/add_slide.py unpacked/ slide2.xml [--after slideN.xml]Duplica una diapositiva (o un slideLayoutN.xml) con toda la contabilidad del paquete. También acepta un .pptx directamente con -o out.pptx
scripts/clean.py unpacked/Elimina diapositivas, medios y rels que ya no se referencian. Ejecutar después de que <p:sldIdLst> esté finalizado
scripts/office/validate.py deck.pptx [--original src.pptx]Verificaciones de esquema, relaciones, tipos de contenido, gráficos y diapositivas; cada fallo nombra su solución. Pasa --original para cualquier presentación derivada de una plantilla — establece una línea base de las comprobaciones de esquema contra la plantilla, para que los propios errores XSD de la plantilla no se lean como tuyos
scripts/office/soffice.py --headless --convert-to pdf deck.pptxWrapper de LibreOffice — soffice desnudo se cuelga en esta caja de arena

Crear con pptxgenjs — advertencias

pptxgenjs está preinstalado — no ejecutes npm install primero; escribe el script y usa require('pptxgenjs') directamente. Solo si ese require falla: npm install pptxgenjs. El modelo conoce la API; estos son los errores comunes:

  • Configura pres.layout antes de agregar diapositivas. El lienzo predeterminado es LAYOUT_16x9 = 10" × 5.625", no 13.3" de ancho. Las coordenadas que exceden el borde se escriben, no se recortan — la forma simplemente no está en la diapositiva. (LAYOUT_WIDE es 13.3" × 7.5".)
  • Colores hex: nunca #, nunca 8 dígitos. color: "FF0000". Tanto "#FF0000" como el alfa incluido en el hex ("00000020") corrompen el archivo. Para translucidez: transparency: 0-100 en rellenos e imágenes, opacity: 0.0-1.0 en sombras — cada uno se ignora silenciosamente en el otro.
  • pptxgenjs muta los objetos de opciones en su lugar (convierte valores a EMU en el primer uso). Nunca compartas un objeto shadow/options entre dos llamadas add* — crea un objeto nuevo cada vez.
  • El offset de la sombra debe ser ≥ 0 — un offset negativo corrompe el archivo. Para proyectar una sombra hacia arriba, usa angle: 270 con un offset positivo.
  • letterSpacing se ignora silenciosamente — la opción real es charSpacing.
  • Listas: bullet: true en cada elemento, nunca un • literal (representa viñetas dobles). Establece breakLine: true en cada elemento del array excepto el último. Espacia los párrafos con viñetas usando paraSpaceAfter, no lineSpacing (huecos enormes).
  • Un new pptxgen() por archivo de salida — nunca reutilices una instancia.
  • rectRadius solo funciona en ROUNDED_RECTANGLE, no en RECTANGLE.
  • Los rellenos degradados no son compatibles — usa una imagen degradada como fondo.
  • Los cuadros de texto tienen relleno interno incorporado — establece margin: 0 cuando el texto deba alinearse con una forma, línea o icono en la misma x.
  • Las notas del orador van en slide.addNotes("...") (texto plano, una vez por diapositiva), nunca en un cuadro de texto en la diapositiva.
  • Mantén los gráficos nativos. Usa addChart() para todo lo que PowerPoint pueda graficar (pasa un array de {type, data, options} para combinaciones). Para características nativas de PowerPoint que la biblioteca no expone (líneas de tendencia, barras de error), calcula la serie adicional tú mismo o posprocesa el OOXML generado — no recurras a una imagen renderizada. Solo los tipos de gráficos que PowerPoint no tiene forma nativa (Sankey, red, acorde) van como imágenes.
  • Los gráficos predeterminados se ven desnudos — sin título, sin etiquetas de datos, paleta anticuada. Establece showTitle + title, showValue: true + dataLabelPosition, chartColors: [...] de tu paleta, y silencia el marco (catAxisLabelColor/valAxisLabelColor, valGridLine: { color, size }, catGridLine: { style: "none" }, showLegend: false para una sola serie).
  • En un gráfico de barras o columnas apiladas, dataLabelPosition debe ser ctr, inEnd o inBase. outEnd corrompe el archivo.
  • Una serie combinada que usa secondaryValAxis/secondaryCatAxis necesita tanto valAxes como catAxes en las opciones del gráfico, dos entradas cada uno. Sin ellos, pptxgenjs escribe ids de eje que nunca declara, y PowerPoint descarta ese gráfico e informa que el archivo está corrupto. Proporcionar solo valAxes no es suficiente.
  • Después de writeFile(), ejecuta python scripts/office/validate.py deck.pptx. Reporta las dos fallas de gráficos anteriores y los defectos XML de diapositivas que PowerPoint rechaza, y nombra la solución para cada uno. Corrígelos en tu generador, no editando manualmente el XML empaquetado.
  • Nunca reordenes los hijos de <p:presentation>. pptxgenjs escribe <p:notesMasterIdLst> justo después de <p:sldIdLst> y apunta ambos maestros a una parte de tema. PowerPoint lo lee felizmente — mueve el elemento y la misma presentación se vuelve imposible de abrir.
  • Iconos: renderiza react-icons a SVG (ReactDOMServer.renderToStaticMarkup), rasteriza con sharp a ≥256px, e inserta mediante addImage({ data: "image/png;base64," + buf.toString("base64") }) — el prefijo image/png;base64, es obligatorio (react-icons, react, react-dom y sharp están preinstalados — npm install react-icons react react-dom sharp solo si un require falla).

Editar presentaciones y plantillas existentes

Elige primero los diseños: python scripts/thumbnail.py template.pptx template-thumbs escribe una cuadrícula etiquetada de cada diapositiva e imprime los archivos que creó — template-thumbs.jpg, dividido en template-thumbs-N.jpg si hay más de 12 diapositivas. Siempre pasa ese segundo argumento, nombrado después de la presentación. Por defecto es thumbnails, por lo que dos presentaciones con miniaturas en un mismo directorio sobrescriben silenciosamente las cuadrículas de la otra — las de la primera simplemente desaparecen (solo análisis de plantilla; la revisión visual necesita los renders de resolución completa de Conversión a imágenes; solo acepta .pptx, así que copia un .potx con nombre .pptx primero). Úsalo con markitdown para mapear cada sección de contenido a una diapositiva de plantilla, y varía los diseños — no pongas todas las secciones en la misma diapositiva de título y viñetas.

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   # duplica una diapositiva (o slideLayoutN.xml); imprime la ruta de la nueva diapositiva
# reordenar / eliminar diapositivas = edita <p:sldIdLst> en ppt/presentation.xml
python scripts/clean.py unpacked/                                     # después de eliminar: elimina diapositivas huérfanas, medios, rels
# edita el contenido de la diapositiva en ppt/slides/slideN.xml
(cd unpacked && rm -f ../out.pptx && zip -Xr ../out.pptx .)           # comprime DESDE DENTRO del directorio; rm primero o las partes eliminadas sobreviven
python scripts/office/validate.py out.pptx --original deck.pptx
  • Haz todo el trabajo estructural — agregar, eliminar, reordenar — antes de editar cualquier contenido de diapositiva. add_slide.py copia un archivo de diapositiva textualmente, por lo que duplicar después de editar clona el contenido editado; y clean.py elimina cualquier diapositiva que falte en <p:sldIdLst>, incluida una que acabas de escribir.
  • Nunca copies un archivo de diapositiva manualmente — add_slide.py hace todo el registro que necesita una nueva diapositiva e informa lo que ha hecho (Created ppt/slides/slide17.xml from slide2.xml). También funciona directamente sobre un archivo: add_slide.py deck.pptx slide2.xml -o out.pptx — pasa -o, o reescribe la presentación de entrada en su lugar. Una diapositiva duplicada aún referencia las partes de gráfico/SmartArt/objeto incrustado de su fuente en lugar de clonarlas, por lo que editar el gráfico de una diapositiva cambia el de la otra.
  • Si usas python-pptx, tres cosas que no hará: duplicar una diapositiva (su único punto de entrada es add_slide(layout)), preservar el formato a través de text_frame.text = "..." (colapsa el párrafo en una sola ejecución sin estilo — asigna run.text en su lugar), o leer el SVG/EMF que la mayoría del arte de plantilla usa (add_picture lanza UnidentifiedImageError).
  • El .ppt heredado debe convertirse primero: python scripts/office/soffice.py --headless --convert-to pptx file.ppt. Las plantillas .potx se desempaquetan y empaquetan de manera idéntica — mantén la extensión .potx en la salida.
  • Para reutilizar un icono o imagen de plantilla, duplica una diapositiva o diseño que ya lo contenga.

Al rellenar una plantilla:

  • Si escribes un transformación XML, analiza con defusedxml.minidom — pasar OOXML por xml.etree.ElementTree reescribe los prefijos de espacio de nombres y corrompe la presentación.
  • Las ranuras de plantilla ≠ elementos de origen. Si la plantilla muestra 4 miembros del equipo y tienes 3, elimina todo el grupo del 4º miembro (imagen + cuadros de texto), no solo su texto — luego verifica si hay elementos visuales huérfanos en la revisión de calidad.
  • Un <a:p> por elemento de lista — nunca concatenes elementos en un solo párrafo. Copia el <a:pPr> hermano para preservar el espaciado, y pon b="1" en el <a:rPr> de títulos, encabezados de sección y etiquetas en línea (Estado:, Propietario:).
  • Deja que las viñetas hereden del diseño; solo agrega <a:buChar>, <a:buAutoNum> (numerado) o <a:buNone> para anular — nunca un • literal en el texto.
  • El texto con espacios al inicio o final necesita xml:space="preserve" en su <a:t>.

Ideas de diseño

No crees diapositivas aburridas. Las viñetas simples sobre fondo blanco no impresionarán a nadie. Considera ideas de esta lista para cada diapositiva.

Antes de empezar

  • Elige una paleta de colores audaz e informada por el contenido: La paleta debe sentirse diseñada PARA este tema. Si intercambiar tus colores en una presentación completamente diferente aún "funcionara", no has hecho elecciones lo suficientemente específicas.
  • Dominancia sobre igualdad: Un color debe dominar (60-70% de peso visual), con 1-2 tonos de apoyo y un acento nítido. Nunca des a todos los colores el mismo peso.
  • Contraste oscuro/claro: Fondos oscuros para diapositivas de título y conclusión, claros para contenido (estructura "sándwich"). O comprométete con oscuro en toda la presentación para una sensación premium.
  • Comprométete con un motivo visual: Elige UN elemento distintivo y repítelo: marcos de imagen redondeados, iconos en círculos de color. Llévalo a través de cada diapositiva. No uses una barra de color o franja de acento como tu motivo (ver lista de evitar).

Paletas de colores

Elige colores que coincidan con tu tema — no uses azul genérico por defecto. Usa estas paletas como inspiración:

TemaPrimarioSecundarioAcento
Ejecutivo medianoche1E2761 (azul marino)CADCFC (azul hielo)FFFFFF (blanco)
Bosque y musgo2C5F2D (bosque)97BC62 (musgo)F5F5F5 (crema)
Energía coralF96167 (coral)F9E795 (oro)2F3C7E (azul marino)
Terracota cálidaB85042 (terracota)E7E8D1 (arena)A7BEAE (salvia)
Degradado océano065A82 (azul profundo)1C7293 (verde azulado)21295C (medianoche)
Carbón minimalista36454F (carbón)F2F2F2 (blanco roto)212121 (negro)
Turquesa confianza028090 (verde azulado)00A896 (espuma de mar)02C39A (menta)
Baya y crema6D2E46 (baya)A26769 (rosa polvo)ECE2D0 (crema)
Salvia calmante84B59F (salvia)69A297 (eucalipto)50808E (pizarra)
Cereza audaz990011 (cereza)FCF6F5 (blanco roto)2F3C7E (azul marino)

Para cada diapositiva

Cada diapositiva necesita un elemento visual — imagen, gráfico, icono o forma. Las diapositivas solo de texto son olvidables.

Opciones de diseño:

  • Dos columnas (texto a la izquierda, ilustración a la derecha)
  • Filas de icono + texto (icono en círculo de color, encabezado en negrita, descripción debajo)
  • Cuadrícula 2x2 o 2x3 (imagen en un lado, cuadrícula de bloques de contenido en el otro)
  • Imagen a media página (lado izquierdo o derecho completo) con superposición de contenido

Visualización de datos:

  • Llamadas de estadísticas grandes (números grandes 60-72pt con etiquetas pequeñas debajo)
  • Columnas de comparación (antes/después, pros/contra, opciones lado a lado)
  • Línea de tiempo o flujo de proceso (pasos numerados, flechas)

Pulido visual:

  • Iconos en pequeños círculos de color junto a encabezados de sección
  • Texto en cursiva para estadísticas clave o lemas

Tipografía

Los nombres de fuentes que escribes en el .pptx son renderizados por PowerPoint del usuario, no por este entorno. Tu revisión visual se renderiza mediante LibreOffice, que sustituye fuentes que no tiene — y para algunas fuentes el sustituto tiene anchos diferentes, por lo que tu vista previa de calidad puede mostrar desbordamiento de texto (o ajuste) que la presentación real no tendrá. Para mantener tu revisión de calidad confiable:

  • Fuentes seguras (renderizan fielmente en la revisión de calidad y vienen con Office): Arial, Calibri, Cambria, Times New Roman, Courier New, Bookman Old Style, Century Schoolbook. Úsalas para texto del cuerpo y cualquier cosa donde el ajuste importe.
  • Encabezados con personalidad sin riesgo de calidad: combina un encabezado serif de la lista segura (Cambria, Bookman Old Style, Century Schoolbook) con un cuerpo sans de la lista segura (Calibri o Arial). Obtienes contraste visual sin renunciar a verificaciones confiables de desbordamiento.
  • Si el usuario pide una fuente fuera de la lista segura (ej. Georgia o Trebuchet MS): úsala donde el usuario pidió, pero dimensiona esos contenedores con margen extra (~10%) y no confíes en el ajuste de texto de revisión de calidad en esos elementos — la vista previa de esa fuente es aproximada. Si el usuario no ha especificado, prefiere fuentes de la lista segura para el texto del cuerpo.
  • Fuentes no confiables para revisión de calidad (el sustituto tiene anchos diferentes — las comprobaciones de desbordamiento pueden ser incorrectas): Georgia, Trebuchet MS, Impact, Arial Black, Garamond, Consolas, Palatino Linotype. La sustitución de Calibri Light varía según el entorno; trata como no confiable para revisión de calidad. Bien para títulos/acentos con margen; no confíes en el ajuste de texto de revisión de calidad en estos.
  • Nunca uses Aptos por defecto — el valor predeterminado de Office posterior a 2023 no tiene un sustituto compatible con métricas aquí y falta en instalaciones de Office más antiguas, por lo que no es confiable en ambos extremos.
ElementoTamaño
Título de diapositiva36-44pt negrita
Encabezado de sección20-24pt negrita
Texto del cuerpo14-16pt
Leyendas10-12pt atenuado

…

[truncado para traducción]

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 relacionados