reveron

When to Use

Usuario pide explícitamente "Reverón" o menciona el skill por nombre
Usuario pide crear/generar/hacer una imagen, video, SVG, GIF, logo, banner, hero, thumbnail
Usuario pide un asset visual para su proyecto (landing, RRSS, presentación, mockup)
Usuario pide editar una imagen existente (cambiar fondo, inpaint, character swap)
Usuario pide narración, voz, TTS, doblaje, o sound effects
Usuario pide un video de avatar hablando (para RRHH, ventas, tutoriales)
Usuario pide un modelo 3D, GLB, asset para juego/AR/impresión 3D, desde texto o desde una imagen de referencia
Usuario pasa URLs de imágenes/videos para "inspirarte" o "usar como referencia"

Global Library

Toda generación queda guardada en la biblioteca global (~/.reveron/), no solo en el proyecto local. Esto significa:

Accedé a tus assets desde cualquier proyecto
Usá generaciones previas como referencias en nuevas generaciones
Consultá costo total y tendencias desde el dashboard (reveron serve)
Exportá o buscá en reveron import desde manifestos de proyectos anteriores

Use --refs reveron:<id> para referenciar un asset guardado:

reveron image --provider gemini --model nano-banana \
  --prompt "misma pose pero en la playa" \
  --refs reveron:84ac4a32-5c48-4f8e-8f4c-a8f8c8f8c8f8

Ideal para iteración: cambios de estilo, character consistency, refinamientos sobre trabajo anterior.

Critical Patterns

1. Decisión de proveedor/modelo — REGLA MAESTRA

Consultar references/model-matrix.md para la matriz completa. Resumen del árbol de decisión:

¿pidió SVG explícito?                → fal + recraft-v3-svg
¿pidió video?                         → default fal + kling-1.6-pro (calidad/precio óptimo)
                                     → con audio sincronizado: gemini + veo-3
¿pidió TTS/voz?                       → elevenlabs multilingual-v2
¿pidió avatar hablando?               → heygen avatar-video
¿pidió modelo 3D / GLB / asset 3D?    → tripo (text-to-model si es texto, image-to-model si pasó ref)
¿pasó imagen como referencia?         → gemini nano-banana (edit)
¿pidió "vector"/"logo"/"flat"?        → fal recraft-v3
¿pidió texto legible en imagen?       → fal ideogram-v3 o gpt-image-2
resto (imagen desde texto)            → fal flux-pro-ultra (default premium)
                                     → si el usuario dijo "rápido" → flux-schnell

2. Umbrales de costo — INNEGOCIABLE

Costo estimado	Acción
`< $0.10`	Ejecuta directo
`$0.10 – $1.00`	Ejecuta pero AVISA el costo en tu respuesta al user
`> $1.00`	PIDE CONFIRMACIÓN EXPLÍCITA antes de correr con `--force`

Nunca corras un video con kling-2.1-master, veo-3 (no fast), o batches de 5+ imágenes premium sin confirmación explícita. Es plata real.

3. Análisis de referencias — obligatorio

Cuando el usuario pasa una URL como referencia:

Descargala mentalmente (Claude visión analiza la URL si es imagen)
Extraé: estilo, paleta, composición, elementos clave
Enriquecé el prompt con esa info textual
Pasá la URL al proveedor como --refs URL1,URL2 para que TAMBIÉN la use

4. Nunca hardcodees valores del usuario

El skill soporta 3 fuentes de secretos con auto-detección (ver README §Setup):

Infisical — si INFISICAL_URL, INFISICAL_CLIENT_ID, INFISICAL_CLIENT_SECRET, DAVINCI_PROJECT_ID están seteadas
Archivo .env — busca $DAVINCI_ENV_FILE → ./.da-vinci.env → ~/.config/da-vinci/.env → ~/.claude/skills/da-vinci/.env
Env vars directas — cualquier combinación de las 6 keys en process.env

Override manual: DAVINCI_SECRETS_SOURCE=infisical|dotenv|env

Si el usuario dice "no me funciona", primero verificá con:

node ~/.claude/skills/da-vinci/scripts/generate.mjs image \
  --provider fal --model flux-schnell --prompt "test" --dry-run --verbose
# Muestra qué fuente detectó y qué keys cargó

Si NO tiene ninguna fuente configurada, el error te da un setup guide con las 3 opciones.

5. Registrar SIEMPRE en manifest

Toda generación queda en <cwd>/assets/generated/manifest.json. El helper lo hace automáticamente, pero si escribís lógica custom, respetá esa convención.

Commands

# ── Imagen ──────────────────────────────────────────────────────
# Default (flux-pro-ultra, calidad premium)
reveron image \
  --provider fal --model flux-pro-ultra \
  --prompt "..." --aspect 16:9

# Rápida y barata (flux-schnell, para iterar)
reveron image --provider fal --model flux-schnell --prompt "..."

# Con edición desde referencia (Nano-Banana)
reveron image \
  --provider gemini --model nano-banana \
  --prompt "cambiá el fondo a un bosque" \
  --refs "https://ejemplo.com/original.png"

# Texto legible en imagen
reveron image --provider fal --model ideogram-v3 \
  --prompt "poster que dice 'AgendaZap' en tipografía moderna"

# ── SVG (siempre FAL Recraft V3 SVG) ────────────────────────────
reveron svg --prompt "logo minimalista para una clínica"

# ── Video ───────────────────────────────────────────────────────
# Default (kling-1.6-pro, ~$0.42 por 5s)
reveron video --provider fal --model kling-1.6-pro \
  --prompt "café siendo servido, cinemático" --duration 5

# Con audio sincronizado (Veo 3, requiere --force por costo)
reveron video --provider gemini --model veo-3 \
  --prompt "..." --duration 5 --force

# Fast + barato (Veo 3 Fast)
reveron video --provider gemini --model veo-3-fast \
  --prompt "..." --duration 5

# ── Modelo 3D / GLB (Tripo3D) ───────────────────────────────────
# Desde texto
reveron model-3d --prompt "una espada medieval low poly" \
  --texture true --pbr true

# Desde imagen de referencia (image-to-model)
reveron model-3d --refs "https://ejemplo.com/producto.png"

# Sin textura (más barato, solo geometría)
reveron model-3d --prompt "silla moderna minimalista" --texture false

# ── Avatar hablando (HeyGen) ────────────────────────────────────
reveron list-avatars                        # ver IDs disponibles
reveron list-voices --provider heygen       # ver voices
reveron avatar-video \
  --avatar "AVATAR_ID" --voice "VOICE_ID" \
  --script "Hola, soy Reverón..."

# ── TTS + SFX (ElevenLabs) ──────────────────────────────────────
reveron list-voices --provider elevenlabs
reveron tts --text "..." --voice "VOICE_ID" --model multilingual-v2
reveron sfx --text "explosión épica" --duration 3

# ── Post-processing ─────────────────────────────────────────────
reveron bg-remove --image "URL"
reveron upscale --image "URL" --model clarity

# ── Costo pre-flight ────────────────────────────────────────────
# Agregá --dry-run para SOLO estimar sin ejecutar
reveron video --provider fal --model kling-2.1-master \
  --prompt "..." --duration 10 --dry-run

Code Examples

Cuando el usuario pide un hero image

Usuario: "Reverón, necesito un hero para una landing de clínica dental, moderna"

Claude debe:
1. Detectar intent: image, hero de landing → premium quality
2. Elegir: fal + flux-pro-ultra + aspect 16:9
3. Estimar costo: $0.06 → nivel auto
4. Enriquecer prompt con contexto:
   "Hero image for dental clinic landing page, modern minimal design,
    soft blue and white color palette, ambient lighting, empty space
    on the left for headline overlay, professional photography style"
5. Ejecutar CLI
6. Mostrar al user: path del asset generado + costo

Cuando el usuario pasa una referencia visual

Usuario: "hacé esta misma imagen pero con fondo playero" [+ URL]

Claude debe:
1. Detectar intent: image edit con referencia
2. Elegir: gemini + nano-banana (rey del edit con character consistency)
3. Estimar costo: $0.039 → nivel auto
4. Ejecutar con --refs URL
5. NO tratar de re-crear la imagen desde cero — usar la referencia

Cuando el costo es alto

Usuario: "hacé un video con veo 3 de 8 segundos"

Claude debe:
1. Estimar: gemini:veo-3:8s = $4.00 → nivel CONFIRM
2. NO ejecutar. Responder:
   "🛑 Este video con Veo 3 (8s) sale ~$4. ¿Confirmás? Si sí, corro con --force."
3. Esperar respuesta del usuario
4. Solo entonces ejecutar con --force

Extension: agregar modelos nuevos

Cuando salga un modelo que no está en el registry (los proveedores actualizan rápido):

Agregar al provider correspondiente en scripts/providers/<provider>.mjs:
```
// Ej en fal.mjs
'flux-3': 'fal-ai/flux-3',
```
Agregar costo en scripts/utils/cost-estimator.mjs
Actualizar references/model-matrix.md con el nuevo caso de uso
Bump metadata.version en este SKILL.md

Resources

Router CLI: src/generate.mjs
Providers: src/providers/{fal,openai,gemini,kie,heygen,elevenlabs,tripo}.mjs
Utils: src/utils/{infisical,cost-estimator,reference-loader,manifest}.mjs
Matriz de decisión: references/model-matrix.md
Setup + Troubleshooting: README.md