convez.ai
SkillDesign & UIIntermediário
diegodoc11

Carrossel Premium para Instagram

diegodoc11/carruseles-premium

Gera carrosséis premium de Instagram com estilo ilustrado automaticamente

Ver no GitHub
InicialPluginScore · de 0 a 100

Skill 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-premium

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
28%
Último commit
há 4 meses
Versão
—
Issues abertas
0
Contribuidores
1

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.

Estilo visual Formato API


Que hace

Solo dale un tema y el numero de slides. El skill se encarga de todo:

  1. Genera el contenido de cada slide automaticamente
  2. Muestra un brief con la estructura del carrusel
  3. Pregunta por imagenes de referencia para cualquier slide
  4. Pregunta por logos/assets para integrar en slides de contenido
  5. Genera todas las imagenes EN PARALELO via Kie AI
  6. Guarda todo organizado por bundle

Resultado

Imagenes como estas (estilo ilustracion a mano):

PortadaContenidoCierre
Ilustracion creativa + titulo grandeFondo claro + logo real + bulletsMensaje 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_id basado 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

ArchivoSlideDescripcion
portada-ref.pngSlide 1Referencia para la portada (alias de ref-1)
ref-2.pngSlide 2Referencia para slide 2
ref-3.pngSlide 3Referencia para slide 3
ref-N.pngSlide NReferencia para cualquier slide

Como funciona

  1. Se guardan en carousel/assets/ con el nombre correspondiente
  2. Se registran en carousel/assets/urls.json
  3. El script auto-detecta los archivos y los asigna a sus slides
  4. Kie AI los recibe como image_input y 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:

  1. Descarga cada imagen a carousel/assets/{entidad}.png
  2. Guarda las URLs originales en carousel/assets/urls.json
  3. El script usa las URLs de urls.json como image_input en la API de Kie AI
  4. 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_input de la API

Tipos de slides

TipoDescripcion
PortadaIlustracion creativa e impactante + titulo grande + fondo beige watercolor
ContenidoFondo blanco/crema + logo real (si hay) + texto en bullets
CierreFondo beige + mensaje natural + handle

Costos y tiempos

ConceptoValor
Por imagen~$0.10 USD
Carrusel de 7 slides~$0.70 USD
GeneracionEN 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

ProblemaSolucion
El script se queda colgadoUsa --skip-interactive y PYTHONUNBUFFERED=1
No encuentra repurpose-pack.mdEl skill lo crea automaticamente. Si usas standalone, crealo con el formato de arriba
API key no configuradaCrea .env con KIE_AI_API_KEY=tu-key (copia .env.example)
Logos no se integran / genericosVerifica que urls.json esta en carousel/assets/ con las URLs correctas
Imagen de referencia no se enviaVerifica que el archivo existe (portada-ref.png o ref-N.png) y urls.json tiene la entrada
Timeout esperando resultadoAPI sobrecargada, usa --regenerate-slides para reintentar
Credits insufficientRecarga creditos en kie.ai, luego usa --regenerate-slides "6,7,8" para los que faltaron
ModuleNotFoundErrorEjecuta 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

Ver o original no GitHub

Bom para

Relacionados