Communitygithub.com

1999AZZAR/designer-mcp

Crea una presentación de diapositivas interactiva con HyperFrames — una presentación, pitch deck o deck interactivo con diapositivas discretas, revelación de fragmentos, ramificaciones, navegación por hotspots y modo presentador con notas del orador; también convierte una página existente en un deck. La salida es un deck navegable, no un MP4 renderizado. Si el usuario no solicitó explícitamente una presentación de diapositivas, confirma antes de crear.

¿Qué es designer-mcp?

Este skill permite crear presentaciones de diapositivas interactivas utilizando HyperFrames, un sistema que combina composiciones de escenas en un deck navegable en lugar de un video lineal. A diferencia de una renderización MP4 estándar, el output es un deck vivo que puede ser servido con `hyperframes present`, incluyendo soporte para diapositivas discretas, revelación de fragmentos, ramas navegables a través de hotspots, y un completo modo presentador con notas del orador editables. Es compatible con plataformas como Claude Code y Cursor, y se integra con el ecosistema de HyperFrames para reutilizar skills base como `/hyperframes-core`. El skill también permite convertir páginas web existentes en presentaciones, preservando fielmente el diseño visual, la interactividad y el comportamiento de medios originales. La validación es rigurosa: cada diapositiva debe cumplir reglas estrictas de escritura (titulares como afirmaciones completas, un concepto por diapositiva, tamaños mínimos de fuente) y el manifiesto JSON de la presentación debe estar presente en un bloque script dedicado para que el reproductor lo interprete correctamente. La confirmación de intención es obligatoria: si el usuario no pidió explícitamente una presentación de diapositivas, el skill preguntará antes de proceder para evitar construir el tipo de entrega incorrecto.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/1999AZZAR/designer-mcp/tree/HEAD/skills/video/engine/slideshow

Preguntar en tu IA favorita

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

Documentación

Primero, mantén este skill actualizado — confirma con el usuario antes de ejecutar: npx hyperframes skills update slideshow. Es un no-op rápido cuando todo está al día; de lo contrario, actualiza este skill junto con los skills del dominio base de los que depende antes de usarlos.

fuente figma: Si el contenido o guion gráfico del deck proviene de una URL de figma.com, ejecuta /figma primero — exportación de recursos, tokens de marca y reconstrucción del guion gráfico si la fuente es una tira de fotogramas de escena — luego construye a partir de su salida. No uses directamente las herramientas MCP de Figma sin procesar: eso omite la sanitización de SVG, la procedencia de .media/manifest.jsonl y el enlace var() de tokens de marca, por lo que un cambio posterior de marca no se puede propagar sin una reimportación completa.

Contrato de autoría de presentaciones de diapositivas

Una presentación de diapositivas de HyperFrames es una composición normal de HyperFrames — escenas, clips, líneas de tiempo GSAP — con un ingrediente adicional: un "JSON island" que declara qué escenas son diapositivas y cómo se conectan. El SlideshowController del reproductor lee el "island" y convierte la línea de tiempo GSAP continua en un deck discreto y navegable.

Lee /hyperframes-core primero para el contrato base de composición (clips, pistas, atributos data-*, reglas de determinismo). Este skill cubre solo lo nuevo: el esquema del "island", reglas de escritura de diapositivas, fragmentos, ramificaciones, validación y el componente envolvente.

Salida — un deck navegable, no un MP4 lineal

La salida de una presentación de diapositivas es el deck en ejecución: sírvelo con hyperframes present <directorio-del-proyecto> (o el modo presentación de Studio) — el SlideshowController del reproductor lee el "island" y gestiona la navegación, fragmentos, ramificaciones y el modo presentador. Consulta Presentación y entrega más abajo.

No uses hyperframes render para convertir una presentación de diapositivas en un solo MP4. Un deck se autoría como varias composiciones de escena de alto nivel (un data-composition-id por diapositiva) sin una composición raíz principal que las envuelva, por lo que render resuelve solo la primera composición y emite un MP4 silenciosamente truncado (por ejemplo, 6 segundos de un deck de 40 segundos). Una exportación lineal principal (solo diapositivas principales, excluyendo secuencias de rama) está aplazada — hasta que se implemente, las salidas compatibles son el deck present en vivo y las imágenes fijas snapshot por diapositiva. Si un usuario necesita un MP4 lineal hoy, muestra esta limitación en lugar de apuntar render al deck.

Confirmación de intención

Si el usuario solicita explícitamente una presentación de diapositivas, slide show o presentación de diapositivas de HyperFrames, procede con este skill. Cuando la solicitud llegó a través de /hyperframes, el triaje de la capa de intención es el dueño de esta confirmación — si se ha enrutado aquí, ya está confirmado, así que no vuelvas a preguntar; las preguntas de forma de ejecución de la capa no aplican (el entregable es un deck, no un video renderizado). Un BRIEF.md, cuando está presente, lleva la intención confirmada — léelo.

Si el skill se activó a partir de una solicitud adyacente como "presentación", "pitch deck", "deck", "deck interactivo" o "convertir esta página", haz una pausa antes de autoría y enmarca la elección antes de pedir confirmación. Explica brevemente que una presentación de diapositivas de HyperFrames significa un deck ejecutable con diapositivas discretas, navegación incorporada y modo presentador, notas del orador editables, manejo de medios compartidos y validación antes de la entrega. Para conversiones de páginas fuente, también menciona que el objetivo es preservar el diseño visual original de la página, las interacciones, el movimiento y el comportamiento de los medios mientras se traduce el movimiento de la página en transiciones entre diapositivas.

Luego haz una breve pregunta de confirmación:

¿Quieres esto como una presentación de diapositivas de HyperFrames?

Usa una interfaz de opción sí/no cuando el entorno la proporcione; de lo contrario, haz la pregunta en texto plano.

No implementes la presentación de diapositivas hasta que el usuario diga que sí. Si dice que no, deja de usar este skill — lee /hyperframes y deja que la capa de intención re-enrute. Esta confirmación es una decisión de enrutamiento, no una compuerta de preferencia — según ../hyperframes/references/brief-contract.md § 1, sobrevive al modo autónomo ("sorpréndeme" no la omite): construir el tipo de entregable incorrecto es un fallo de calidad, no una decisión creativa.


Las dos partes

1. Escenas — declaradas de manera normal

Cada diapositiva está respaldada por una escena. Declara las escenas con data-composition-id, data-start, data-duration y data-label:

<div
  data-composition-id="problem"
  data-start="0"
  data-duration="8"
  data-label="The problem"
  data-width="1920"
  data-height="1080"
>
  <!-- los clips van aquí -->
</div>

Las diapositivas de rama (accesibles solo a través de un hotspot, excluidas de la línea principal) se declaran exactamente de la misma manera — solo aparecen en una entrada slideSequences en el "island", no en el array slides principal.

2. El "JSON island" — un bloque de script por composición

Agrega exactamente un bloque <script type="application/hyperframes-slideshow+json"> al HTML de la composición. Contiene todos los metadatos de la presentación de diapositivas:

<script type="application/hyperframes-slideshow+json">
  {
    "slides": [...],
    "slideSequences": [...]
  }
</script>

El "island" es la única fuente de verdad para el orden de las diapositivas, notas, puntos de retención de fragmentos, hotspots y secuencias de rama. Colócalo cerca del inicio de <body>, antes de los divs de escena, para que sea fácil de encontrar.

No escondas el manifiesto de la presentación de diapositivas detrás de un bloque <script type="application/json"> alternativo más código en tiempo de ejecución que crea el "island". El comando present lee el HTML de la composición estáticamente y espera que el "island" real application/hyperframes-slideshow+json ya esté presente.


Esquema

SlideshowManifest (el objeto "island" de nivel superior)

{
  "slides": [
    /* SlideRef[] — la línea principal, en orden */
  ],
  "slideSequences": [
    /* SlideSequence[] — secuencias de rama fuera de línea */
  ]
}

SlideRef

{
  "sceneId": "problem",
  "notes": "Empieza con el dolor, no con la empresa.",
  "fragments": [3.5, 5.2, 7.0],
  "hotspots": [
    /* SlideHotspot[] */
  ],

  "ttsScript": null,
  "ttsAudioUrl": null,
  "ttsDurationMs": null
}
CampoObligatorioNotas
sceneIdsíDebe coincidir exactamente con el data-composition-id de una escena (o proporcionar explícitamente startTime/endTime). La regla de lint resuelve escenas por data-composition-id.
notesnoTexto solo para el presentador. Nunca se muestra a la audiencia.
fragmentsnoArray de tiempos (segundos) dentro del rango [start, end] de la diapositiva — consulta Fragmentos más abajo.
hotspotsnoSuperposiciones interactivas que activan una rama — consulta Ramificaciones más abajo.
startTimenoOpcional. Sobrescribe los límites de tiempo de la escena coincidente; por defecto, inicio/fin de la escena.
endTimenoOpcional. Sobrescribe los límites de tiempo de la escena coincidente; por defecto, inicio/fin de la escena.
ttsScript, ttsAudioUrl, ttsDurationMsnoReservado. Los campos del esquema existen, pero la reproducción de TTS aún no está conectada. Omitir a menos que estés prellenando para una compilación futura.

SlideHotspot

{
  "id": "h1",
  "label": "¿Cómo calculamos esto?",
  "target": "market-deep-dive",
  "region": { "x": 60, "y": 10, "w": 35, "h": 20 }
}
CampoObligatorioNotas
idsíÚnico dentro de la diapositiva.
labelsíTexto de información sobre herramientas / botón mostrado a la audiencia.
targetsíDebe coincidir con un SlideSequence.id en slideSequences.
regionnoCuadro delimitador en porcentaje de la diapositiva: {x, y, w, h} en 0–100. Omitir para que el hotspot se renderice como un botón etiquetado de diapositiva completa.

SlideSequence

{
  "id": "market-deep-dive",
  "label": "Metodología de dimensionamiento de mercado",
  "slides": [{ "sceneId": "mkt-1" }, { "sceneId": "mkt-2" }]
}

slides dentro de una secuencia usa la misma forma SlideRef que la línea principal. Se permiten fragmentos y hotspots anidados.


Reglas de escritura de diapositivas

Estas son restricciones estrictas, no sugerencias. Una diapositiva que las viole será reemplazada directamente cuando un revisor la vea.

  • El titular es una afirmación de oración completa, no una etiqueta. Escribe "Las PYMES dedican 14 horas/semana a la programación manual" no "Problema de programación". La oración debe tener sentido por sí sola si se ignora el contenido visual.
  • Una idea + un visual por diapositiva. Si te sientes tentado a agregar un segundo grupo de viñetas o un segundo gráfico, divide la diapositiva.
  • Empieza con la conclusión. El punto más fuerte va primero — en la diapositiva y en el orden del deck. Los inversores leen de izquierda a derecha, de arriba a abajo, y se detienen.
  • Solo dimensionamiento de mercado ascendente. Nunca escribas "TAM de $50B" sin mostrar los cálculos. Construye desde la economía unitaria hacia arriba: cuentas × ACV, o transacciones × tasa de captación.
  • Tamaño de fuente mínimo equivalente a 30pt. A 1920×1080, un titular es de 72–96px; el cuerpo del texto es de 48px. Nunca bajes de 40px para cualquier texto que la audiencia deba leer.
  • Busca en el catálogo en vivo antes de construir manualmente cualquier visual con nombre. Para cada aspecto visual, efecto, gráfico, tratamiento o transición que necesite una diapositiva — "líneas de barrido CRT", "glitch", "carrera de gráficos de barras", "barrido de brillo", "ventana de terminal" — ejecuta npx hyperframes catalog --query "<el visual, en inglés simple>" --json y lee los mejores resultados antes de autorizar los clips de la diapositiva. La búsqueda no necesita nada instalado: ningún proyecto, add previo, ni cuenta. Clasifica todo el registro alojado (~400 bloques y componentes) desde cualquier directorio. npx hyperframes add <nombre> coloca la fuente del bloque en el deck, donde lo personalizas en su lugar. Esto aplica con fuerza adicional al portar una página fuente: un bloque real supera a la aproximación simplificada que las reglas de portabilidad siguientes prohíben.

Portabilidad de páginas fuente

Al convertir una página existente en una presentación de diapositivas, la fidelidad a la fuente es parte del contrato. No reemplaces widgets específicos de la fuente con aproximaciones simplificadas a menos que el usuario solicite explícitamente un rediseño.

  • Preserva el diseño visual original de la página, el lenguaje de movimiento, el comportamiento interactivo, el comportamiento de los medios y las capacidades de presentación lo más fielmente posible en la práctica. Cuando el sistema de presentación de diapositivas admita el modo presentador, incluye notas del orador usando el comportamiento compartido de notas editables en lugar de una implementación específica del deck.
  • Porta los elementos visuales mecánicos del DOM/CSS/JS de la fuente con la mayor precisión posible: reproductores personalizados, visualizadores de lienzo, líneas de tiempo, cabezales de reproducción, stems, círculos en expansión, estados de hover y otros detalles interactivos deben sobrevivir a la conversión.
  • Trata los elementos <video> / <audio> nativos como la fuente de verdad para cualquier cromo de medios personalizado, visualizador de lienzo, forma de onda, cuadrícula de ritmo o cabezal de reproducción. Conecta los eventos de medios de la fuente (play, pause, timeupdate, seeking, seeked, ended, ratechange, volumechange) y deriva el estado visual de media.currentTime; no ejecutes un temporizador separado que pueda desviarse de la reproducción real.
  • Cada <video> o <audio> copiado con src debe tener atributos de tiempo de HyperFrames antes del lint: data-start y data-duration, más data-has-audio="true" cuando se deba preservar el audio nativo audible. Usa el rango de tiempo de la escena para medios específicos de la diapositiva; para videos de evidencia controlados por el usuario que puedan reproducirse desde múltiples diapositivas enfocadas, usa un rango de todo el deck. No dejes preload="none" en los medios; usa metadata o auto.
  • Resuelve los tokens de fuente de la fuente antes de la validación. Si preservas fuentes personalizadas de la fuente, agrega reglas @font-face para los archivos de fuente locales/capturados. Si usas alternativas del sistema, reemplaza declaraciones tokenizadas como font-family: var(--f-body) con stacks concretos seguros para renderizado como system-ui, sans-serif o ui-monospace, monospace; no dejes var(...) como valor de la familia de fuente.
  • Audita la fuente en busca de movimientos atípicos de página, especialmente comportamiento impulsado por scroll, wheel, touch, estado hash, resize o un bucle de requestAnimationFrame. Trata los viewports fijos con capas "world" traducidas/escaladas, parallax, paneles fijos, desplazadores horizontales, líneas de tiempo depuradas por scroll, ajuste de secciones y cámaras de zoom a elemento como comportamiento de la fuente. El scroll es a menudo el desencadenante de transición de la fuente, así que preserva la transición extrayendo sus paradas de progreso, easing y estados de cámara/enfoque, luego reubica ese movimiento en la navegación de la presentación de diapositivas a través de posiciones de línea de tiempo, fragmentos o un gancho reutilizable de reproductor/arnés. Los wrappers independientes que saltan a puntos de retención de diapositivas aún necesitan un gancho de transición de cámara de navegación explícito; calcular transformaciones de cámara por diapositiva no es suficiente. No simules una transición literal de desplazamiento hacia abajo dentro de la diapositiva; el espectador debe sentir un viaje/zoom de cámara de un punto focal a otro, no ver una página web siendo desplazada. Mantén cada movimiento de cámara entre diapositivas continuo: evita paradas de ruta intermedias que inviertan la dirección x/y o deshagan el zoom.

… (contenido truncado para traducción)

Individual skills in this repo

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

1999AZZAR/designer-mcp

SOTA animation and physics heuristic guide using motion.dev

1999AZZAR/designer-mcp

Add captions or subtitles to an existing single-subject talking-head video without editing the footage. Use for plain verbatim captions, cinematic captions embedded behind the subject, VFX captions, “炸/特效/酷炫字幕,” or a named identity from the 35-style catalog. Route by visual identity, not by backend engine. The quiet `anchor` rail is the default; embed every word only when the user explicitly wants a fully cinematic treatment. The workflow runs locally end to end, including transcription and subject matting; split multi-shot footage before applying it.

1999AZZAR/designer-mcp

Turn arbitrary text — an article, notes, a topic, a brief — into a faceless explainer video: there is no site or footage to capture, so the visuals are invented per scene (typography, abstract graphics, diagrams, data-viz). Use for topic explainers, concept breakdowns, how-tos, listicles. Not a video built from a website (/product-launch-video — promo or tour). Unclear → /hyperframes.

1999AZZAR/designer-mcp

Import Figma content into a HyperFrames composition — rendered assets, brand tokens, components, storyboard sections → reconstructed motion (frames read as states, not slides) (REST/CLI), connector-assisted motion when available, and shaders from a connector or native export. Use when the user pastes a figma.com link or asks to bring a Figma design, frame, logo, brand, or animation into a video/composition.

1999AZZAR/designer-mcp

Author or edit a custom HyperFrames composition when no specialized workflow fits, or when BRIEF.md sets flow: companion. Use for longer or multi-scene pieces, brand and sizzle reels, montages, static loops, static title cards, footage remixes, and freeform builds. Use motion-graphics instead for a short unnarrated motion-first unit, including an animated title. Route fresh creation through hyperframes before using this skill.

1999AZZAR/designer-mcp

All animation knowledge for HyperFrames — atomic motion rules, multi-phase scene blueprints, scene transitions, broader motion-design techniques, AND the seven runtime adapters (GSAP default, plus Lottie, Three.js, Anime.js, CSS keyframes, Web Animations API, TypeGPU). Use for any motion or animation task: pick 2-4 rules and compose, or load a blueprint, or look up runtime-specific API (e.g. GSAP eases / Lottie player / Three.js mixer). Also covers auditing an existing composition's choreography (animation map) and 24 named text-animation effects. HyperFrames-native: single paused timeline, seek-safe, deterministic.

1999AZZAR/designer-mcp

Use when audio already placed in a HyperFrames composition needs to be mixed: fade-in/fade-out, crossfade, track gain or volume, volume automation, ducking, a music bed that fights a voiceover (voiceover carve), effects on a track (EQ, compressor, limiter, gate, saturation, delay, reverb, chorus, phaser, bitcrush), automation envelopes drawn on a track's volume or any effect parameter, or one submix bus carrying a chain, a fader and an automation clock for several tracks at once (`<hf-audio-group>`). Don't use for sourcing or generating audio — finding BGM, SFX, or making a voiceover is `/media-use`. Don't use for clip timing or track layout, which is `/hyperframes-core`.

1999AZZAR/designer-mcp

Use the HyperFrames CLI development loop: init, add, catalog, capture, lint, check, snapshot, compare, grade-compare, preview, play, present, beats, keyframes, single or batch render, publish, cloud, cloudrun, feedback, lambda, doctor, browser, info, upgrade, skills, compositions, timeline, docs, benchmark, telemetry, transcribe, auth, tts, and remove-background. Also use when diagnosing build or render failures. validate, inspect, and layout are deprecated aliases; use check. Covers local, HeyGen-hosted cloud, AWS Lambda, and Google Cloud Run rendering.

1999AZZAR/designer-mcp

The HyperFrames composition contract — build one renderable project. Use for composition structure, the `data-*` timing attributes, `class="clip"`, tracks, sub-compositions, variables, framework-owned media playback, deterministic-render rules, and validation. Read before writing composition HTML.

1999AZZAR/designer-mcp

Non-animation creative direction for HyperFrames videos. Use for design spec (frame.md / design.md) handling, palettes, typography, narration, beat planning, audio-reactive visuals, composition patterns, and brand / style decisions. For atomic motion patterns and scene blueprints, use `hyperframes-animation`.

1999AZZAR/designer-mcp

Use when a HyperFrames composition needs a punch-in, punch-out, zoom, reframe, Ken Burns treatment, camera move, visual match/whip handoff, or other seek-safe 2D/3D keyframes; also for GSAP, CSS keyframes, Anime.js, WAAPI, FLIP, paths, masks, SVG morph/draw, text trails, 3D depth, or `hyperframes keyframes` diagnostics. Don't use for broad scene strategy, brand design, media sourcing, captions, or general video planning.

1999AZZAR/designer-mcp

Search, install, and wire registry blocks and components into HyperFrames compositions. Use BEFORE hand-building any named visual — whenever a brief, a user, or a storyboard names a look, effect, treatment, or transition such as CRT scanlines, glitch, chromatic aberration, film grain, a shimmer sweep, a chart, a code or terminal window, a map, or a confetti burst — because roughly 400 hosted items already cover many of them and the search ranks all of them with nothing installed, no project, and no account. Also use when running hyperframes add or hyperframes catalog, installing one item or every block matching a tag, wiring an installed item into index.html, or working with hyperframes.json. Covers discovery, install locations, block sub-composition wiring, component snippet merging, and authoring a new block or component to contribute upstream (idea → scaffold → validate → PR).

1999AZZAR/designer-mcp

Mandatory entry point: read this first for any request to make, create, edit, animate, or render a video, animation, or motion graphic, including a promo, explainer, captioned clip, title card, overlay, slideshow or interactive deck, Remotion port, or any HyperFrames HTML composition. Also use it to inspect, diagnose, validate, preview, publish, or batch-render an existing HyperFrames project. Inputs may be a website URL, GitHub PR, Figma design or URL, text or brief, existing footage, or music. It resumes project state, captures intent when applicable, selects and installs the owning workflow, and routes domain capabilities. HyperFrames is the default output framework unless the user explicitly chooses another framework for the deliverable or asks only to record a browser session.

1999AZZAR/designer-mcp

Use when building or editing a HyperFrames project that people open in Studio: how the timeline should be laid out so it reads well (one caption track, one element kind per track, every scene a sub-composition) and where captions and key content may sit (safe zones). Don't use for how to perform an individual edit (split, trim, retime, volume, copy, swap): that is `creator-editing-recipes.md` in `/hyperframes-core`.

1999AZZAR/designer-mcp

Agent Media OS, the single skill for every media need in a HyperFrames project. Resolve BGM, SFX, image, icon, brand logo, voice, color grade, or LUT into a frozen local file or paste-ready block + ledger record (one verb, `resolve`); generate via TTS / music / image models when the catalog misses; produce voiceover, transcription, captions, and background removal through one shared audio engine; operate on media (cut / reframe / transform); and reuse assets across projects. Also use for vague feedback that real footage looks dark, flat, boring, should feel retro/camcorder/print/ASCII, needs privacy, or needs a media reveal.

1999AZZAR/designer-mcp

Turn a music track (an audio file, a video to pull audio from, or a track generated from a mood brief) into a beat-synced video — lyric video, slideshow, or kinetic promo. The music drives all pacing; any user-supplied images/videos are cut onto the same beat grid, and a complete video needs zero assets. Narrated pieces → the input-matched workflow (see /hyperframes). Unclear → /hyperframes.

1999AZZAR/designer-mcp

Turn a GitHub pull request (a PR URL, owner/repo#N, or 'this PR' in a checked-out repo) into a code-change explainer video — changelog, feature reveal, fix, or refactor walkthrough built from the diff, commits, and files: the input is a code change, not a website. Not a product promo (/product-launch-video) or a no-PR topic explainer (/faceless-explainer). Unclear → /hyperframes.

1999AZZAR/designer-mcp

Port an existing Remotion (React) composition''s source to HyperFrames HTML. Use ONLY on an explicit ask to port/convert/migrate/translate a Remotion source — one-way, Remotion-only. A passing Remotion mention, reference-only code, or "make something like my Remotion video" is a fresh build (/general-video). Unclear → /hyperframes.

1999AZZAR/designer-mcp

Package an existing talking-head / interview / podcast video with timed, designed GRAPHIC OVERLAY cards — kinetic titles, lower-thirds, data callouts, quotes, side panels, picture-in-picture — synced to the transcript, on a 16:9 / 9:16 / 4:5 canvas of your choice; the clip plays untouched underneath. Trigger on "graphic overlays", "on-screen graphics", "package / dress up my video". Not plain subtitles (/embedded-captions). Unclear → /hyperframes.

1999AZZAR/designer-mcp

All animation knowledge for HyperFrames — atomic motion rules, multi-phase scene blueprints, scene transitions, broader motion-design techniques, AND the seven runtime adapters (GSAP default, plus Lottie, Three.js, Anime.js, CSS keyframes, Web Animations API, TypeGPU). Use for any motion or animation task: pick 2-4 rules and compose, or load a blueprint, or look up runtime-specific API (e.g. GSAP eases / Lottie player / Three.js mixer). Also covers auditing an existing composition's choreography (animation map) and 24 named text-animation effects. HyperFrames-native: single paused timeline, seek-safe, deterministic.

Skills relacionados