Carrossel Premium para Instagram
diegodoc11/carruseles-premium
Gera carrosséis premium de Instagram com estilo ilustrado automaticamente
Ver no GitHubSkill de Claude Code que gera carrosséis automáticos para Instagram (1080x1350px) com estilo hand-drawn minimalista usando a API Kie AI. Integra texto nas imagens, gera conteúdo paralelo e oferece workflow interativo com suporte a assets e logos customizados.
Instalação
npx convez-ai diegodoc11/carruseles-premium1 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
Casos de uso
- Criar carrosséis educativos para redes sociais
- Gerar conteúdo visual sobre tendências e ferramentas de IA
- Produzir materiais de marketing com branding customizado
Veredito

Ferramenta sólida para automação de design visual, integrando bem com Claude Code e a API Kie AI. Workflow interativo é prático, mas exige configuração de chaves de API e funciona melhor com referências de assets do usuário para resultados polidos.
README
A tradução para o português deste README ainda está na fila.
Carruseles Automaticos
Skill de Claude Code para generar carruseles de Instagram con estilo hand-drawn minimalista usando Kie AI (Nano Banana Pro).
Genera imagenes estilo acuarela y lapices de colores con tipografia handwritten, perfectas para carruseles educativos y de contenido.
Que hace
Solo dale un tema y el numero de slides. El skill se encarga de todo:
- Genera el contenido de cada slide automaticamente
- Muestra un brief con la estructura del carrusel
- Pregunta por imagenes de referencia para cualquier slide
- Pregunta por logos/assets para integrar en slides de contenido
- Genera todas las imagenes EN PARALELO via Kie AI
- Guarda todo organizado por bundle
Resultado
Imagenes como estas (estilo ilustracion a mano):
| Portada | Contenido | Cierre |
|---|---|---|
| Ilustracion creativa + titulo grande | Fondo claro + logo real + bullets | Mensaje natural + @handle |
Requisitos
- Claude Code instalado
- Python 3.8+
- API Key de Kie AI
- Paquetes Python:
requests,python-dotenv,Pillow
Instalacion
1. Clonar el repositorio
git clone https://github.com/santmun/carruselesdef.git
cd carruselesdef
2. Instalar dependencias Python
pip install requests python-dotenv Pillow
3. Configurar API Key
Copia el archivo de ejemplo y agrega tu API key:
cp .env.example .env
Edita .env y reemplaza tu-api-key-aqui con tu API key de kie.ai.
4. (Opcional) Copiar a otro proyecto
Si quieres usar el skill en otro proyecto de Claude Code:
# Desde la raiz de TU proyecto
mkdir -p .claude/skills/carousel-gen scripts
cp carruselesdef/.claude/skills/carousel-gen/SKILL.md .claude/skills/carousel-gen/
cp carruselesdef/scripts/generate-carousel.py scripts/
cp carruselesdef/.env.example .env.example
Uso
Dentro de Claude Code
/carousel-gen [tema] [numero_de_slides]
Ejemplos:
/carousel-gen 5 herramientas IA para emprendedores 7
/carousel-gen como usar ChatGPT para crear contenido 5
/carousel-gen tendencias de IA en 2026 8
El skill automaticamente:
- Genera un
bundle_idbasado en la fecha y el tema - Crea todas las carpetas necesarias
- Genera el contenido de los slides
- Ejecuta el workflow interactivo
Workflow interactivo
El skill sigue 4 pasos obligatorios:
PASO 1: Mostrar brief
Claude genera el contenido y te muestra una tabla resumen
PASO 2: Imagenes de referencia
Te pregunta si tienes imagenes de referencia para CUALQUIER slide
(portada, contenido o cierre)
PASO 3: Logos y assets
Detecta herramientas mencionadas (n8n, Claude, ChatGPT...)
y te pregunta si tienes logos para integrar
PASO 4: Generacion en paralelo
Ejecuta el script y genera todas las imagenes al mismo tiempo
Standalone (sin Claude Code)
Tambien puedes usar el script directamente:
# Generacion completa
python3 scripts/generate-carousel.py "mi-bundle-id"
# Solo ver el brief (sin generar)
python3 scripts/generate-carousel.py "mi-bundle-id" --dry-run
# Regenerar slides especificos
python3 scripts/generate-carousel.py "mi-bundle-id" --regenerate-slides "2,4"
# Saltar preguntas interactivas (para automatizacion)
python3 scripts/generate-carousel.py "mi-bundle-id" --skip-interactive
Estructura de archivos
carruselesdef/
├── README.md
├── .env.example # Template de configuracion
├── .gitignore
├── .claude/
│ └── skills/
│ └── carousel-gen/
│ └── SKILL.md # Definicion del skill para Claude Code
└── scripts/
└── generate-carousel.py # Script principal de generacion
Estructura del bundle (output)
El script crea y genera archivos en esta estructura:
outputs/bundles/[bundle_id]/
├── repurpose-pack.md # Texto de cada slide (auto-generado)
└── carousel/
├── carousel-01.png # Imagenes generadas
├── carousel-02.png
├── ...
├── manifest.json # Metadata de generacion
├── carousel-assets-needed.md # Guia de assets opcionales
└── assets/ # Logos y referencias descargados
├── urls.json # URLs originales de los assets
├── portada-ref.png # Referencia para slide 1 (opcional)
├── ref-N.png # Referencia para slide N (opcional)
└── *.png # Logos de entidades
Imagenes de referencia
Puedes proporcionar imagenes de referencia para cualquier slide, no solo la portada. Las imagenes de referencia se usan como inspiracion visual (composicion, colores, estilo).
Convencion de nombres
| Archivo | Slide | Descripcion |
|---|---|---|
portada-ref.png | Slide 1 | Referencia para la portada (alias de ref-1) |
ref-2.png | Slide 2 | Referencia para slide 2 |
ref-3.png | Slide 3 | Referencia para slide 3 |
ref-N.png | Slide N | Referencia para cualquier slide |
Como funciona
- Se guardan en
carousel/assets/con el nombre correspondiente - Se registran en
carousel/assets/urls.json - El script auto-detecta los archivos y los asigna a sus slides
- Kie AI los recibe como
image_inputy los usa de inspiracion
Ejemplo de urls.json con referencias
{
"portada-ref": "https://example.com/mi-imagen-portada.png",
"ref-3": "https://example.com/referencia-slide-3.png",
"claude": "https://example.com/claude-logo.png",
"chatgpt": "https://example.com/chatgpt-logo.png"
}
Manejo de assets (logos)
Cuando el skill detecta herramientas mencionadas en los slides (Claude, ChatGPT, n8n, etc.), te pregunta si tienes logos para integrar. Los logos se integran como elementos del diseno (overlay), a diferencia de las imagenes de referencia que son solo inspiracion.
Si proporcionas URLs:
- Descarga cada imagen a
carousel/assets/{entidad}.png - Guarda las URLs originales en
carousel/assets/urls.json - El script usa las URLs de
urls.jsoncomoimage_inputen la API de Kie AI - Nano Banana integra los logos reales en las ilustraciones hand-drawn
Estilo visual
Caracteristicas
- Ilustraciones estilo acuarela + lapices de colores
- Tipografia handwritten (Nano Banana la escribe directamente en la imagen)
- Fondos claros: beige
#F5F1E8, crema#FAF9F6, blanco#FFFFFF - Elementos organicos e imperfectos (estilo "charming")
- Logos reales integrados via
image_inputde la API
Tipos de slides
| Tipo | Descripcion |
|---|---|
| Portada | Ilustracion creativa e impactante + titulo grande + fondo beige watercolor |
| Contenido | Fondo blanco/crema + logo real (si hay) + texto en bullets |
| Cierre | Fondo beige + mensaje natural + handle |
Costos y tiempos
| Concepto | Valor |
|---|---|
| Por imagen | ~$0.10 USD |
| Carrusel de 7 slides | ~$0.70 USD |
| Generacion | EN PARALELO (todas al mismo tiempo) |
| Tiempo total (7 slides) | ~2-3 minutos |
Herramientas detectadas automaticamente
El script detecta menciones de estas herramientas para sugerir logos:
n8n ChatGPT Claude Make WhatsApp Zapier Anthropic OpenAI Gemini
Troubleshooting
| Problema | Solucion |
|---|---|
| El script se queda colgado | Usa --skip-interactive y PYTHONUNBUFFERED=1 |
| No encuentra repurpose-pack.md | El skill lo crea automaticamente. Si usas standalone, crealo con el formato de arriba |
| API key no configurada | Crea .env con KIE_AI_API_KEY=tu-key (copia .env.example) |
| Logos no se integran / genericos | Verifica que urls.json esta en carousel/assets/ con las URLs correctas |
| Imagen de referencia no se envia | Verifica que el archivo existe (portada-ref.png o ref-N.png) y urls.json tiene la entrada |
| Timeout esperando resultado | API sobrecargada, usa --regenerate-slides para reintentar |
| Credits insufficient | Recarga creditos en kie.ai, luego usa --regenerate-slides "6,7,8" para los que faltaron |
| ModuleNotFoundError | Ejecuta pip install requests python-dotenv Pillow |
Personalizacion
Cambiar aspect ratio
ASPECT_RATIO = "4:5" # Instagram carousel (1080x1350px)
# Cambiar a:
ASPECT_RATIO = "1:1" # Cuadrado (1080x1080px)
ASPECT_RATIO = "9:16" # Stories (1080x1920px)
Agregar nuevas herramientas detectadas
Busca el diccionario KNOWN_ENTITIES en generate-carousel.py y agrega las tuyas.
Licencia
MIT
Creditos
- Imagenes generadas con Kie AI - Nano Banana Pro
- Skill diseñado para Claude Code de Anthropic