convez.ai
SkillDesign & UIIntermediário
Acosta1991

img-deck — Apresentações em IA em 5 passos

Acosta1991/claude-skill-img-deck

Gera PDFs de apresentações com slides como imagens via IA em fluxo aprovado

Ver no GitHub
InicialPluginScore · de 0 a 100

Skill de Claude Code que gera apresentações PDF onde cada slide é uma imagem completa criada com GPT Image 2 via kie.ai. O fluxo guiado inclui aprovação de wireframes editáveis e sistema de design antes da geração final das imagens, economizando créditos de API.

Instalação

$npx convez-ai Acosta1991/claude-skill-img-deck

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Criar decks de apresentação visualmente coerentes sem design manual
  • Gerar slides em qualquer idioma com estilo visual consistente
  • Prototipar apresentações rapidamente com wireframes editáveis antes da renderização

Veredito

Skill bem estruturada que resolve um problema real: gerar apresentações visuais por IA com aprovação prévia para controlar custos. A abordagem em 5 passos com portas de validação é pragmática e o editor visual integrado reduz fricção. Recomendado para quem precisa produzir decks rapidamente em escala.

README

A tradução para o português deste README ainda está na fila.

img-deck — Presentaciones por IA en 5 pasos

Skill para Claude Code que crea presentaciones donde cada slide es una imagen completa generada con gpt-image-2 de kie.ai, y las monta en un PDF.

En lugar de maquetar diapositivas a mano, le explicas a Claude de qué quieres hablar; la skill propone wireframes editables, acuerda contigo un sistema de diseño visual coherente, y genera todas las slides como imágenes que se montan en un único PDF.

TipoSkill de Claude Code
SalidaPDF (una imagen por página, 16:9)
Motor de imagenkie.ai · GPT Image 2 (gpt-image-2-text-to-image)
IdiomaCualquier idioma — el deck se genera en el idioma que pidas

¿Cómo funciona? — el flujo de 5 pasos

La skill guía una conversación con dos puertas de aprobación para que no se gasten créditos generando slides hasta que el diseño esté aprobado:

  1. Cuentas el contenido. Conversas con Claude sobre tema, objetivo, audiencia, nº de slides y mensajes clave. Claude resume todo en un outline.
  2. White frames editables. Claude crea un HTML con un wireframe por slide. Trae un editor visual integrado: lo abres en el navegador y editas directamente sobre las diapositivas (clic para escribir, arrastrar para mover/redimensionar, duplicar o borrar slides) y guardas. Para que "Guardar" sobrescriba el mismo archivo en cualquier navegador (incluido Safari), Claude lo sirve con un editor local (scripts/edit_server.py) y abres http://127.0.0.1:8765. (puerta de aprobación)
  3. Sistema de diseño. Claude genera una sola imagen tipo "design system board" (paleta, tipografía, componentes, mood). La apruebas o pides cambios. (puerta de aprobación)
  4. Generar todas las slides. Con el estilo aprobado, Claude redacta un prompt por slide y genera cada imagen (16:9, 2K). Revisa cada una y regenera si hace falta.
  5. Montar el PDF. Las imágenes se combinan en un PDF, una por página.
decks/<nombre>/
  white-frames.html      # wireframes editables (paso 2)
  design-system.png      # sistema de diseño aprobado (paso 3)
  prompts/slide-01.txt   # prompt final por slide (paso 4)
  slides/slide-01.png    # imágenes finales (paso 4)
  <nombre>.pdf           # PDF montado (paso 5)

Instalación

1. Requisitos

  • Claude Code instalado.
  • Una API key de kie.ai (Dashboard → API Keys).
  • Python 3 con:
    • Pillow — para montar el PDF (pip install Pillow)
    • playwright (opcional) — solo para previsualizar wireframes en imagen (pip install playwright && playwright install chromium)
  • Google Chrome — para el editor visual de los white frames (paso 2).

2. Instalar la skill

Clona este repo dentro de tu carpeta de skills de Claude Code. La skill puede ser de usuario (global) o de proyecto:

# Skill global (disponible en todos tus proyectos)
git clone https://github.com/Acosta1991/claude-skill-img-deck.git \
  ~/.claude/skills/img-deck

# …o skill de proyecto (solo en este repo)
git clone https://github.com/Acosta1991/claude-skill-img-deck.git \
  .claude/skills/img-deck

La carpeta debe contener SKILL.md en su raíz. Si clonas con otro nombre, renómbrala a img-deck.

3. Configurar la API key

La key se lee de la variable de entorno KIE_API_KEY o de un archivo .env en la raíz de tu proyecto. Copia la plantilla y rellénala:

cp .env.example .env
# edita .env y pega tu key:  KIE_API_KEY=tu_api_key_aqui

El script busca el .env subiendo desde el directorio actual, así que basta con tenerlo en la raíz de tu proyecto. Nunca subas tu .env a git (ya está en .gitignore).


Uso

Una vez instalada, simplemente pídeselo a Claude Code en lenguaje natural:

"Quiero crear una presentación sobre [tu tema]" "Hazme un deck / pitch / unas slides sobre…"

Claude reconocerá la skill y te llevará por los 5 pasos, parándose a pedir tu aprobación en los white frames y en el sistema de diseño.

Scripts (si quieres ejecutarlos a mano)

# Generar una imagen con kie.ai
python3 scripts/kie_image.py \
  --prompt-file decks/<nombre>/prompts/slide-01.txt \
  --aspect-ratio 16:9 --resolution 2K \
  --out decks/<nombre>/slides/slide-01.png

# Editar los white frames y que "Guardar" sobrescriba el mismo archivo
# (cualquier navegador, incl. Safari). Abre http://127.0.0.1:8765
python3 scripts/edit_server.py decks/<nombre>/white-frames.html

# Previsualizar los white frames como PNG (requiere Playwright)
python3 scripts/render_frame.py --html decks/<nombre>/white-frames.html --outdir frames/

# Montar el PDF a partir de la carpeta de slides
python3 scripts/build_pdf.py \
  --dir decks/<nombre>/slides \
  --out decks/<nombre>/<nombre>.pdf

Estructura del repo

SKILL.md                 # instrucciones de la skill (las lee Claude Code)
templates/
  white-frame.html       # plantilla de wireframes con editor visual integrado
scripts/
  kie_image.py           # genera una imagen con kie.ai (solo stdlib de Python)
  build_pdf.py           # monta las imágenes en un PDF (Pillow)
  render_frame.py        # previsualiza wireframes a PNG (Playwright, opcional)
  edit_server.py         # editor local: "Guardar" sobrescribe el HTML (stdlib)
references/
  kie-api.md             # referencia de la API de kie.ai
  prompting.md           # técnicas de prompt para texto legible y estilo coherente

Notas y consejos

  • Multiidioma. La skill funciona en cualquier idioma. En el paso 1 se fija el idioma del deck (por defecto, el idioma en que escribes) y se reitera en cada prompt — eso es lo que hace que el texto salga con ortografía perfecta, sea español, inglés, francés, etc.
  • Poco texto por slide. Cuanto menos texto, más fiable lo renderiza el modelo. Frases cortas y texto entre comillas → mejor ortografía. Ver references/prompting.md.
  • Mantén 16:9 y 2K en todas las slides para un PDF uniforme.
  • Costes: cada imagen consume créditos de kie.ai. Las dos puertas de aprobación existen para no generar 10+ slides antes de aprobar el diseño. Revisa tus tareas en https://kie.ai/logs.
  • Numera los archivos con dos dígitos (slide-01, slide-02…) para que el orden alfabético del PDF sea correcto.

Licencia

MIT — ver LICENSE.

Ver o original no GitHub

Bom para

Relacionados