Communitygithub.com

financial-storytelling

Crea Reels/Shorts explicativos cinematográficos para finanzas personales, bolsa, hipotecas y bienes raíces en Perú. Úsala cuando se solicite un guion, storyboard, video animado, escena Remotion, plantilla reusable o revisión de calidad; prioriza historia con conflicto, metáforas visuales, cálculos comprobables e identidad editorial 2.5D + datos + edificios isométricos. No utilizar para trading automático ni afirmar rentabilidades garantizadas.

¿Qué es financial-storytelling?

Financial Storytelling es una skill creativa y técnica para producir videos cortos cinematográficos (20-45 segundos) que explican decisiones financieras e inmobiliarias en Perú. Combina narración visual, metáforas y datos verificables para transformar conceptos complejos en historias atractivas y memorables, evitando diapositivas aburridas. Funciona integrada con Remotion para la programación y renderizado de escenas, pero no incluye Remotion en sí misma; se apoya en un proceso estructurado de seis fases que abarca desde el brief inteligente y la verificación financiera, hasta el storyboard, la producción por capas y la revisión con evidencia. Soporta tres familias visuales: narrativo editorial 2.5D, cinematográfico financiero y arquitectónico isométrico, cada una con reglas estrictas de estilo y coherencia. La skill es ideal para creadores de contenido, asesores financieros y agentes AI que deseen generar guiones, storyboards, escenas animadas o revisiones de calidad, asegurando precisión, originalidad y cumplimiento de estándares editoriales.

Compatible con~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/GTO1988/financial-storytelling/tree/HEAD/skill-financial-storytelling-codex

Preguntar en tu IA favorita

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

Documentación

Financial Storytelling — dirección creativa y producción de videos

Misión

Transformar una decisión financiera o inmobiliaria concreta en una historia audiovisual de 20-45 segundos, visualmente memorable y rigurosa. No hacer un pase de diapositivas con números. Cada escena debe mostrar una acción, una decisión, una consecuencia o una metáfora que avance la historia. Audiencia: personas en Perú interesadas en rentabilidad, departamentos, créditos, bolsa de valores y patrimonio.

Integración con Remotion

Esta skill define la dirección artística, el guion, la arquitectura de escenas y el control de calidad. Para programar/renderizar, usar un proyecto Remotion y las skills oficiales de Remotion si están instaladas (npx remotion skills add dentro del proyecto). Remotion no está incluido en esta skill. Cuando no haya proyecto, crearlo tras verificar Node.js, siguiendo la documentación oficial y la preferencia del usuario. No afirmar que se exportó MP4 hasta comprobar que existe.

Proceso obligatorio (6 fases)

  1. Brief inteligente. Extraer del pedido: tema, público, objetivo, duración, formato, datos y fuentes. Defaults si falta información: Perú, 30 s, vertical 1080x1920, 30 fps, español peruano, tono claro y cercano. No solicitar confirmación si puede producirse una primera versión con supuestos marcados.
  2. Verificación financiera. Separar datos observados, supuestos, simulaciones y opiniones. No inventar tasas vigentes, rendimientos históricos, promociones ni precios. Para cálculos aplicar las fórmulas de references/precision-financiera.md; incluir en pantalla condiciones necesarias y evitar afirmar que un alquiler igual a la cuota significa utilidad neta. Si no hay acceso a información actual, usar ejemplo explícitamente ilustrativo.
  3. Historia antes que diseño. Escribir logline, una pregunta dramática y la revelación. Estructura preferida: 0-3 s gancho visual y verbal; 3-8 s situación/personaje; 8-19 s conflicto creciente; 19-26 s giro demostrado con cifras; 26-30 s conclusión memorable y CTA honesta. Leer references/guion-y-retencion.md.
  4. Storyboard con visuales diferenciados. Crear 7-10 escenas (no necesariamente idéntica duración), cada una con id, inicio, fin, voz, accion_visual, camara, transicion, texto_pantalla, sfx, dato_fuente. Antes de programar, presentar el storyboard y decidir una metáfora principal. Utilizar assets/storyboard-template.json como estructura sugerida. No usar el mismo tipo de toma dos veces seguidas si no aporta al relato.
  5. Producción por capas. Consultar references/direccion-visual.md. Usar Remotion/React para secuenciar componentes y sincronizar voz/textos; motion con spring, interpolate, Sequence, y curvas acordes al ritmo. Preferir assets vectoriales/SVG originales para diagramas; recursos 3D para edificios cuando añadan comprensión. Mantener un design system: paleta, texturas, iluminación, tipografías, comportamiento de cámara, efectos sonoros y espaciados. Si se facilita un Reel ajeno, estudiar lenguaje visual y ritmo pero no copiar personajes, diseños distintivos ni audio protegido.
  6. Revisión con evidencia. Generar primero animatic/preview y fotogramas clave; revisar legibilidad móvil, contraste, continuidad, tempo, exactitud de números y locución. Ajustar escenas deficientes sin reconstruir todo. Ejecutar scripts/validar_storyboard.py si hay JSON estructurado. Solo dar por terminado cuando se haya renderizado y revisado el archivo (si la herramienta de render está disponible). Leer references/control-calidad.md.

Tres familias visuales bajo una identidad

  • Narrativo editorial 2.5D: explicar sesgos, decisiones, errores y dilemas con metáforas visuales, profundidad, papel sutil y actores/objetos. Evitar verse infantil.
  • Cinemático financiero: interfaces sobrias, datos, velas, gráficos y líneas de tiempo; reservado para bolsa, rentabilidad y comparativas. Los gráficos son fieles a los datos, nunca decorativos ni engañosos.
  • Arquitectónico isométrico: mini-edificios, depas cortados, planos y recorridos para mostrar distribución, vacancia, gastos, metros cuadrados y cuotas. Combinación inicial sugerida: 50% narrativo, 30% datos, 20% arquitectura, ajustada al tema. El estilo es reconocible y consistente, pero las escenas son originales.

Reglas de alto impacto

  • Hook visual en primer segundo (objeto, problema o contradicción), no una introducción del canal.
  • Una idea clave por escena. Texto de pantalla muy breve; priorizar el objeto animado como protagonista.
  • Al menos una metáfora visual que cambie durante la escena y un momento revelación que contraste expectativa vs realidad.
  • Personaje recurrente opcional y sobrio; si aparece, preservar silueta, ropa, proporciones, expresiones y paleta entre escenas.
  • No dibujar interfaces falsas que parezcan cuentas reales, ni atribuir opiniones ficticias a entidades.
  • Emplear sonidos y música con derechos apropiados; la voz y los recursos de terceros deben estar autorizados.
  • Los consejos financieros no son garantía de rentabilidad; mostrar supuestos decisivos, impuestos/costos y riesgos cuando corresponda.

Entregables según tarea

  • Solo ideación: 3 conceptos, elegir 1 y justificar conflicto/emoción; títulos y hooks.
  • Guion: título, logline, voz final por segundos, giros, CTA, disclaimer si procede.
  • Storyboard: tabla de escenas + guía de assets, transiciones y sfx.
  • Video: código Remotion reproducible, fuentes/assets autorizados, instrucciones de instalación, previsualización, y MP4 verificado cuando sea posible.
  • Revisión: nota sobre claridad, historia, identidad visual, verificación de cifras y 3 prioridades de mejora.

Referencias de lectura bajo demanda

  • references/direccion-visual.md: identidad, escenas y diseño cinematográfico.
  • references/guion-y-retencion.md: estructuras narrativas y hooks.
  • references/precision-financiera.md: cálculos y cautelas para casos de Perú.
  • references/control-calidad.md: rubrica y pruebas antes de publicar.
  • examples/reel-depa-306k.md: ejemplo completo de historia y escenas.
  • assets/storyboard-template.json: estructura de datos del guion de producción.
  • assets/style-tokens.json: tokens visuales de partida, editables.

Skills relacionados