Communitygithub.com

newkayk12/claude-skills

Construye presentaciones PPTX a partir de contenido: lee una plantilla, escribe la presentación como Markdown y la renderiza. Compatible con Claude Code, Cursor y Codex.

¿Qué es claude-skills?

Esta skill transforma la creación de presentaciones en un proceso de construcción reproducible: no se editan diapositivas una por una, sino que se parte de una plantilla `.pptx` de referencia (obligatoria), se escribe el contenido en un archivo `deck.mdx` y se genera automáticamente la presentación final (`deck.pptx`). Es útil para desarrolladores, diseñadores técnicos y equipos que necesitan mantener consistencia visual (colores de marca, tipografías) sin perder control sobre el contenido. Funciona con cualquier agente que admita skills (Claude Code, Cursor, Codex). El motor principal es `scripts/deck.py`, que clona diapositivas de la plantilla y reemplaza su contenido, preservando el diseño byte a byte. Incluye herramientas para cambiar colores (`ppt_keycolor_changer.py`), verificar desbordamientos (`check`), renderizar vistas previas (`render`) y generar arte SVG en las mismas dimensiones y colores de la plantilla. El proceso completo es: catalogo de plantilla → mapeo de contenido → escritura de `deck.mdx` → verificación → construcción → renderizado y revisión visual.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/newkayak12/claude-skills/tree/HEAD/portfolio/skills/deck-builder

Preguntar en tu IA favorita

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

Documentación

Lo que hace esta skill

Trata una presentación como una construcción, no como un documento:

ArtefactoRol
template.pptxla cadena de herramientas — sus diapositivas son el catálogo de arquetipos. Siempre requerido.
deck.mdxla fuente — el único archivo que alguien edita
assets/*.svgarte generado, también fuente — solo contenido, sin diseño
deck.pptxel artefacto construido — se regenera completamente cada vez
deck.pdf + vistas previaslo que una persona realmente mira — el único lugar donde el diseño se ve

Cada diapositiva de salida es un clon de una diapositiva de la plantilla con su contenido intercambiado, por lo que el diseño de la plantilla sobrevive byte por byte. Nada se diseña desde cero.

Motor: scripts/deck.py (invocar con una ruta absoluta).

Recolorar (cualquier pptx; para una presentación ya construida, recolorar template.pptx y reconstruir): scripts/ppt_keycolor_changer.py, procedimiento y preajustes en references/recolor.md — descubrir, mapear por luminosidad, confirmar, reemplazar, verificar.

Mandatos Permanentes

  • Nunca construir sin una plantilla de referencia. No hay diseño de presentación incorporado ni respaldo. Si el usuario no te ha dado un .pptx, detente y pide uno — no ensambles diapositivas de otra manera, no ofrezcas una presentación genérica, no fabriques una plantilla. El motor también lo rechaza, pero la petición te corresponde a ti, antes de cualquier trabajo.
  • El archivo fuente es deck.mdx, nunca deck.md. Se compila, no se lee. El motor rechaza cualquier otra extensión.
  • Catalogar antes de escribir. Nunca redactes deck.mdx basándote en una suposición sobre la plantilla. Ejecuta catalog y escribe contra los identificadores de ranura que imprime.
  • Nunca edites manualmente el pptx de salida. Se regenera en la siguiente construcción. Las correcciones van en deck.mdx.
  • Ejecuta check antes de build y muestra al usuario las advertencias. Las advertencias de desbordamiento son lo que separa el texto abarrotado de una diapositiva que nadie puede leer.
  • La visibilidad decide, no la pulcritud. | transparent es correcto cuando el contenido de la imagen sigue siendo legible sobre la diapositiva; check dice cuándo no lo sería, y un panel detrás de la imagen es la mejor respuesta allí. No recurras a la transparencia porque suene más limpio.
  • Nunca recortes contenido sin decirlo. check informa el porcentaje; repítelo al usuario y ofrece | fit. Una imagen que pierde la mitad de sí misma es el mismo defecto que una fila de tabla que se cae de la diapositiva.
  • Nunca crees manualmente el arte de una ranura de imagen como binario. Escribe el SVG para que la presentación siga siendo reproducible a partir de texto. Un PNG que alguien pegó no se puede regenerar, recolorar ni revisar en un diff.
  • Una presentación la leen personas, así que mírala. Cuando haya un renderizador disponible, termina con render, no con build — la auditoría de diseño y las vistas previas de página son el único lugar donde aparecen las colisiones de texto. Si no hay renderizador disponible, dilo claramente en el informe en lugar de insinuar que se verificó el diseño.
  • Nunca inventes un arquetipo. Si ninguna diapositiva de la plantilla se ajusta al contenido, dilo y pregunta si se debe reformular el contenido o ampliar la plantilla — no hagas aproximaciones.
  • Informa las advertencias que decidiste ignorar. Una advertencia de desbordamiento que decidiste que estaba bien sigue perteneciendo al informe final — el usuario es quien verá la diapositiva.
  • Los gráficos son de solo lectura. Dilo explícitamente cuando el arquetipo elegido tenga uno; los números de la plantilla se envían a menos que el usuario edite el gráfico en PowerPoint.

Proceso

Paso 0 · Obtener la plantilla de referencia

Pide el .pptx antes de cualquier otra cosa si no tienes uno:

"레퍼런스 템플릿 pptx를 주세요. deck-builder는 템플릿 슬라이드를 복제하는 방식이라, 템플릿 없이는 만들 수 있는 슬라이드가 없습니다."

No continúes con una descripción de una plantilla, una presentación de aspecto similar o una promesa de proporcionarla más tarde.

Paso 1 · Catalogar la plantilla

python3 /abs/path/scripts/deck.py catalog \
  --template "template.pptx" --output "deck.catalog.md"

Imprime cada arquetipo como @s1…@sN con sus ranuras, lo que la plantilla muestra actualmente y una estimación de capacidad. Léelo antes de cualquier otra cosa.

Paso 2 · Mapear el contenido a los arquetipos

Pregunta al usuario por el contenido si no lo tienes. Luego, antes de escribir cualquier md, muestra un plan de una línea por diapositiva:

1. @s1  Portada            — Título + subtítulo
2. @s3  Resumen            — 3 viñetas + una conclusión
3. @s7  Números            — Tabla de 4 filas

Obtén la aprobación del plan. La elección incorrecta del arquetipo es el error costoso, no la redacción incorrecta.

Paso 3 · Escribir deck.mdx

---
template: template.pptx
template_hash: 5f84440a3521      # del catálogo — fija la presentación a la estructura de la plantilla
output: deck.pptx
---

## @s3
title: Resumen del trimestre
text1:
  - p99 de respuesta **2,1s → 340ms**
  - Tasa de fallos de despliegue 12% → 0,4%
table1:
  | Métrica | Antes | Después |
  | p99 | 2,1s | 340ms |
pic1: assets/arch.svg
notes: Menciona primero la fuente de los números
text5: !drop

Las imágenes toman un modo de ajuste — | fit mantiene la imagen completa, el predeterminado fill la recorta — y | transparent elimina el fondo de un PNG. Las ranuras que omitas mantienen el contenido de la plantilla.

La sintaxis completa — formas de ranura, !drop, notes:, énfasis en línea, niveles de esquema, y contra qué protege template_hash — está en references/mdx-syntax.md. Léelo antes de escribir la primera diapositiva.

Paso 3b · Generar el arte que la presentación necesita

Escribe el arte de una ranura de imagen como un .svg, en los colores de la plantilla y en el tamaño exacto en pt del marco — ambos impresos por catalog. Se convierte en fuente como el resto de la presentación y se rasteriza a PNG en el momento de la construcción.

Reglas, fundamentos y un ejemplo práctico: references/generated-art.md.

Paso 4 · Verificar

python3 /abs/path/scripts/deck.py check --deck deck.mdx

Los errores deben corregirse. Las advertencias son decisiones subjetivas — saca a la luz cada una, incluidas las que decidas ignorar.

Qué mideContra qué
Una tabla o texto que se sale de la diapositivael borde de la diapositiva — un error, nombrando las filas perdidas
Una línea demasiado ancha para una ranura que la plantilla mantiene en una líneael propio marco de esa ranura, en em, para que el Hangul no se cuente como latín
Una ranura que contiene mucho menos de lo que la plantilla pone allíel volumen propio de la plantilla — el marco se dibujó para esa cantidad y la diapositiva abre un hueco
Texto que se extiende más abajo de lo que el diseño lo colocael recuento de líneas propio de la plantilla, y lo que se encuentra debajo
Pérdida de recorte, dpi efectivo, desviaciones de paleta, bordes de cuadros pegadosel marco, la pantalla y la paleta de la plantilla
Texto sobre una imagenlos píxeles realmente detrás de ella: 3:1 para texto grande, 4,5:1 para cuerpo

Una imagen dibujada después de las palabras que cubre es un error — terminan detrás de la imagen.

Cada estimación aquí está calibrada contra el contenido propio de la plantilla en lugar de un absoluto, porque la mayoría de los marcos están dibujados para contener texto que ya se ajusta. Los márgenes de menos de una línea están más allá de lo que una estimación estática puede resolver: solo el Paso 6 resuelve esos.

Paso 5 · Construir

python3 /abs/path/scripts/deck.py build --deck deck.mdx [--output out.pptx] [--strict]

El mismo deck.mdx siempre produce un pptx byte-idéntico.

Paso 6 · Renderizar y mirar

python3 /abs/path/scripts/deck.py render --deck deck.mdx

Construye, convierte a través de LibreOffice, escribe vistas previas PNG de cada página y audita la geometría renderizada — overlap (dos marcos de texto chocan), bunched (las líneas dentro de un marco están más juntas de lo normal para ese marco, por lo que el texto ha superado su cuadro), off-slide (el renderizador lo cortó). Limpio significa limpio: la auditoría compara entre marcos y mide el interlineado contra la mediana de cada marco, por lo que las fuentes CJK cuyo cuadro em excede una línea al 100% no lo activan.

render primero dice cuáles de las tipografías de la plantilla no tiene el renderizador. Una fuente sustituida reajusta cada línea, por lo que hasta que esas estén instaladas, los saltos de línea de la vista previa son los del sustituto, no los de la presentación — la solución es instalar la fuente, no acortar las palabras. El pptx mismo siempre nombra las caras correctas.

Lee las vistas previas para el diseño, no para el espaciado. LibreOffice rellena la unión entre CJK y latín por defecto, por lo que 평균 42분 se renderiza como 평균 42 분 en la vista previa mientras que el pptx mantiene la cadena original. Verifica <a:t> en el archivo construido antes de tratar el espaciado como un defecto.

El renderizador es soffice en PATH o DECK_RENDER_DOCKER=<imagen>. Sin ninguno, render se niega en lugar de pretender que se verificó el diseño — dilo y recurre a build.

Plantilla de Salida

Informe después de una construcción:

Construcción completada — <ruta de salida>
  Diapositivas: <N> · Plantilla: <nombre> · Imágenes: <M> insertadas
  Inspección de renderizado — 0 superposiciones (o: El título de la página 3 se superpone con el cuerpo)

Arquetipos utilizados
  @s1 ×1  Portada
  @s3 ×4  Cuerpo

Revisión necesaria
  · Diapositiva 3, title 58 caracteres (marco ~39 caracteres/línea) — se desborda a dos líneas
  · Diapositiva 5, chart1 — Los valores del gráfico son los de la plantilla

Para la próxima modificación, solo edita deck.mdx y vuelve a ejecutar build. El pptx de salida se pierde si lo tocas manualmente.

Lo que hace Claude / Lo que haces tú

ClaudeTú
Pide el pptx de referencia, se niega a continuar sin élProporcionas la plantilla — obligatoria — y el contenido en bruto
Ejecuta catalog, lee el mapa de ranurasRevisas la lista de arquetipos
Propone el plan de arquetipos por diapositivaApruebas o reorganizas el plan
Escribe y revisa deck.mdxEditas deck.mdx directamente cuando prefieras
Ejecuta check, informa cada advertenciaDecides si una advertencia de desbordamiento es relevante
Ejecuta render, mira las vistas previas, informa colisionesAbres el pptx, editas gráficos si es necesario

Limitaciones

Las seis que cambian lo que puedes prometer:

LímiteConsecuencia
Sin nuevos diseñosCada diapositiva es un clon. El contenido sin arquetipo necesita ampliar la plantilla en PowerPoint — dilo en lugar de aproximarte.
Una plantilla es obligatoriaSin diseño incorporado, sin respaldo.
Los gráficos no se pueden escribirbuild deja los números de la plantilla. Usa un SVG en una ranura de imagen.
Los marcos nunca se muevenEscribe corto y el espacio permanece; check lo informa, solo la plantilla puede cerrarlo.
La verdad del diseño necesita un renderizadorcheck estima y no puede resolver márgenes de menos de una línea. Solo render ve lo que choca.
La legibilidad es solo PNGEl texto sobre un fondo JPEG o SVG no se puntúa; los colores de texto heredados se dejan intactos.

Tabla completa, y qué paso detecta cada uno: references/limits.md.

Skills Relacionadas

  • write:plans (propósito del documento) — desarrolla el contenido antes de mapearlo a diapositivas
  • think:untangle-thoughts — convierte notas dispersas en la estructura diapositiva por diapositiva que necesita el Paso 2

Individual skills in this repo

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

newkayak12/claude-skills

>- Use when someone explicitly asks for beta portfolio feedback: feedback plus writing patterns (피동, team subject, number density, decision visibility). Triggers only on "피드백 베타로", "feedback beta".

newkayak12/claude-skills

>- Use when someone shares a developer portfolio and wants interviewer-grade feedback: screen verdict, whether numbers and skills hold up, whether it reads at the claimed level. Triggers: "포트폴리오 피드백 해줘", "서류 통과할까", "숫자 근거 있어?", "시니어로 읽혀?", "고친 버전 비교".

newkayak12/claude-skills

>- Use when judging a portfolio's fit to a JD, or with no JD to company types or a named company. Triggers: "이 공고에 맞아?", "JD랑 비교해줘", "어느 회사에 잘 맞아?", "네이버 지원하려는데 어때?", "which companies fit me". Not generic "서류 통과할까?" (feedback).

newkayak12/claude-skills

>- Use when someone needs an interview preparation plan before their interview process begins — a study schedule, gap analysis by topic area, and STAR story prompts. This is planning, not practice. Triggers on: "interview prep plan", "면접 준비 계획".

newkayak12/claude-skills

>- Use when preparing a job application or career transition end-to-end, from JD fit through 자기소개서 to mock interview. Triggers on: "job application workflow", "이직 준비 전체", "취업 프로세스 시작", "career transition", "job search process".

newkayak12/claude-skills

>- Use when someone wants a realistic mock interview grounded in their own portfolio, with per-answer coaching. Triggers on: "모의 면접 해줘", "인터뷰 연습", "mock interview", "grill me on my portfolio".

newkayak12/claude-skills

>- Use when someone wants to understand the writing patterns in their portfolio — not what it says but how it reads: passive voice ratio, subject audit, number density, and decision visibility. Triggers on: "패턴 분석해줘", "오너십이 잘 드러나나", "피동형 많이 썼나".

newkayak12/claude-skills

>- Use when resume or portfolio lines need a stronger rewrite, optionally to a JD. Triggers: "이 문장 고쳐줘", "이 부분 어떻게 쓰면 좋아", "더 잘 쓰는 법", "임팩트 있게 바꿔줘", "rewrite this portfolio section", "이력서 맞춰줘", "공고에 맞게 고쳐줘", "이력서 최적화", "tailor my resume to this JD".

Skills relacionados