Communitygithub.com

decks-narrative (Arquitecto de Historias)

Arquitecta la historia, el contrato de percepción de la audiencia y la tesis diapositiva por diapositiva de una presentación antes de construir cualquier diapositiva o gráfico. Úsala al inicio de cualquier presentación nueva o renovación para producir NARRATIVE.md, seleccionar el arco narrativo adecuado (Keynote, Pirámide, SCQA, Recorrido Técnico, Pitch) y justificar cada visual o transición Morph planeada al servicio de la historia.

¿Qué es decks-narrative (Arquitecto de Historias)?

Esta skill es el punto de partida obligatorio para cualquier proyecto de presentación. Su propósito es crear `NARRATIVE.md`, un documento que define la columna vertebral narrativa antes de que se genere cualquier diapositiva o animación. Esto asegura que el contenido, el tono y cada transición visual sirvan directamente la tesis y la respuesta emocional deseada en la audiencia. La skill guía al usuario a través de cuatro secciones clave: análisis de la audiencia y modo de entrega (en vivo o por lectura), un contrato de percepción detallado (pensar/sentir/hacer/evitar), la selección del formato de experiencia y arco narrativo adecuados (basados en referencias como `narrative-patterns.md`), y una tabla de storyboard diapositiva por diapositiva. También impone reglas estrictas: un mensaje por diapositiva, sin diapositivas huérfanas, y justificación obligatoria de cada elemento visual. Está diseñada para plataformas como Cursor, Claude Code, o Codex, y complementa habilidades como `deck-visuals` o `deck-builder`.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/SwePalm/deckcraft-skills/tree/HEAD/skills/deck-narrative

Preguntar en tu IA favorita

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

Documentación

Narrativa de Presentación (Arquitecto de Historias)

La narrativa es la luz guía. Los renders 3D geniales, shaders y transiciones Morph solo hacen que una presentación sea excelente cuando afinan la comprensión y el mensaje emocional de la audiencia. Cada presentación comienza bloqueando NARRATIVE.md antes de tocar deck-visuals o deck-builder.

Lo que NARRATIVE.md debe contener

Escribe NARRATIVE.md con cuatro secciones obligatorias:

  1. Audiencia y Modo de Entrega

    • ¿Quién está en la sala (ejecutivos, ingenieros, inversores, clientes)?
    • Modo de entrega: live (el presentador habla; las diapositivas tienen ~40 palabras y llevan un impacto visual) o preread (se lee solo/async; las diapositivas llevan mensajes completos de hasta ~100 palabras).
    • Duración objetivo y presupuesto de diapositivas (~1.5–2 min por diapositiva para presentaciones live).
  2. Contrato de Percepción (¡Alimenta la Puerta 2 de deck-eval!)

    • Pensar: ¿Qué tesis única debe creer la audiencia al final?
    • Sentir: ¿Qué tono emocional debe evocar la presentación (p. ej., autoridad técnica calmada, urgencia de movimiento, claridad editorial)?
    • Hacer: ¿Qué decisión o acción concreta debe ocurrir justo después de la última diapositiva?
    • Anti-Percepción (Nunca sentirse como): 2–3 cosas que esta presentación no debe parecer (p. ej., basura AI exagerada, vertedero de hojas de cálculo densas, presentación corporativa genérica).
  3. Trabajo Narrativo → Formato de Experiencia (Romper la Gramática de Diapositivas Predeterminada) Nunca asumas que cada historia pertenece a diapositivas de Kicker + Encabezado + Cuadro de Contenido. Deja que el Trabajo Narrativo seleccione el Formato de Experiencia:

    • Descubrimiento e Intuición (avance científico, misterio, "cómo funciona realmente") → Viaje Continuo de Cámara 3D + Golpes de Película (un mundo 3D vivo, cero encabezados de diapositivas, vuelos de cámara entre paradas).
    • Revelación de Producto / Cambio de Visión → Golpes Documentales Editados como Película (plano atmosférico amplio → estadística de tensión monumental 120pt+ → demo animada en vivo → cierre tranquilo).
    • Sistema Complejo / Estrategia → Lienzo Espacial Infinito (un mapa unificado que se desplaza y amplía en subsistemas mediante Morph).
    • Decisión Ejecutiva / Pre-Lectura → Revista Editorial / Bento Asimétrico (arco Piramidal, visualización de datos D3, decisiones nítidas).
    • Exploración Autoguiada → Historia Web Interactiva de Doble Artefacto → .pptx Compilado.

    También elige el Arco Narrativo (consulta references/narrative-patterns.md):

    • Pirámide (Ejecutivo / Decisión): Respuesta primero → pilares de apoyo → evidencia → decisión/próximos pasos.
    • SCQA (Estratégico / Pitch): Situación → Complicación → Pregunta → Respuesta + Prueba.
    • Tensión-Liberación Keynote: Status quo → Grieta/Insight → Nuevo Mundo → Prueba/Demo → Llamada a la Aventura.
    • Recorrido Técnico: Problema/Restricción → Modelo Mental del Sistema → Morph Zoom en Subsistemas → Compensaciones y Resultados.
  4. Tabla de Storyboard Diapositiva por Diapositiva Para cada diapositiva, especifica:

    • # de Diapositiva y Rol (Título, Tensión, Resumen de Pilar, Morph Zoom, Prueba de Datos, Arquitectura, Cierre)
    • Título (Tesis, no una etiqueta de tema): p. ej., "Morph convierte la arquitectura estática en enfoque guiado" en lugar de "Resumen de Arquitectura". Nunca termines los títulos con un punto.
    • Punto Clave y Notas del Ponente: Lo que la audiencia lee vs. lo que el presentador dice.
    • Justificación Visual / de Movimiento: Por qué esta diapositiva usa una transición Morph, un visual 3D de Three.js, un gráfico editorial o tipografía pura. Si un visual no aclara o eleva la tesis, elimínalo.

Barreras Narrativas

  • Un mensaje por diapositiva. Si una diapositiva tiene dos afirmaciones en competencia, divídela en dos diapositivas.
  • Sin diapositivas huérfanas. Lee solo los títulos de las diapositivas en secuencia; deben contar toda la historia de principio a fin sin lagunas.
  • Gana cada visual. Cada objeto 3D, gráfico o movimiento Morph debe responder: "¿Qué entiende la audiencia más rápido o siente más profundamente porque esto está aquí?"

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

Skills relacionados