Communitygithub.com

hyperframes-instruct

Sistema operativo multimedia para HyperFrames: resuelve, genera, opera y recuerda todos los tipos de medios con un solo comando, sin ruido de contexto.

¿Qué es hyperframes-instruct?

Este skill actúa como un sistema operativo multimedia completo para proyectos HyperFrames, unificando la resolución, generación, operación y reutilización de activos multimedia bajo un único comando `resolve`. Soporta tipos como música de fondo (BGM), efectos de sonido (SFX), imágenes, iconos, logotipos, voces mediante TTS, gradación de color y LUTs. Cuando un activo no está en el catálogo, puede generarlo usando modelos de TTS, música o imagen. Además, permite operaciones como cortar, reencuadrar o transformar medios, y ofrece un motor de audio compartido para voiceovers, transcripciones, subtítulos y eliminación de fondos. El skill también incluye un enfoque proactivo para sugerir mejoras multimedia basadas en señales concretas del proyecto, como agregar voiceover a un guion sin voz o sugerir corrección de color en metraje subexpuesto. Funciona en entornos de línea de comandos con Node.js y se integra con servicios como HeyGen, proporcionando una ruta de uso gratuito para TTS y videos de avatar, mientras que las claves API consumen créditos facturables. El diseño modular permite cargar solo la documentación relevante para la tarea actual, minimizando el ruido cognitivo.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/sandeshrajbhandari/hyperframes-instruct/tree/HEAD/.agents/skills/media-use

Preguntar en tu IA favorita

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

Documentación

Instalación del plugin: Antes de ejecutar comandos de configuración o actualización, sigue las reglas de ejecución de plugins cuando este skill esté dentro de un plugin de HyperFrames. Las instalaciones independientes mantienen las instrucciones de actualización a continuación.

media-use

El sistema operativo multimedia para HyperFrames: resuelve · genera · opera · recuerda — cada tipo de medio, un solo skill, cero ruido de contexto.

Primera ejecución: instala e inicia sesión en la CLI de heygen (la ruta de uso gratuito), luego verifica con npx hyperframes media-use resolve --doctor. Configuración y proveedores: references/setup-providers.md.

Antes de generar un voiceover o un video de avatar, informa a la persona: iniciar sesión en la CLI de heygen con OAuth (heygen auth login --oauth) proporciona una asignación gratuita para voiceover TTS y videos de avatar, mientras que una clave API factura créditos de API.

Resolve — el único verbo

npx hyperframes media-use resolve --type <tipo> --intent "<descripción>" --project <directorio>

Devuelve una línea: resolved <id> → <ruta> (<tipo>, <metadatos>). Todo el ruido de búsqueda permanece en el disco.

TipoIntención de una línea
bgmmúsica de fondo (catálogo de HeyGen, 10k+ pistas)
sfxefectos de sonido (biblioteca empaquetada de 19 archivos + catálogo)
imagefotos, fondos (búsqueda de activos de HeyGen, 75k+ vectores)
iconiconos, símbolos (transparentes)
logomarcas oficiales (theSVG → avatar de GitHub → favicon; nunca redibujado)
voicevoiceover TTS (ruta de uso gratuito de HeyGen; Kokoro local opcional)
gradecandidato de corrección medido; pulido/estilización amplia sigue Tratamientos
lutarchivo .cube reutilizable validado proporcionado por el usuario o elegido

Antes de resolver algo nuevo, lista candidatos reutilizables con --candidates y juzga tú mismo el ajuste — las reglas de reutilización, todas las banderas, ingesta (--from) y adopción están en references/resolve.md.

Tratar comentarios visuales amplios como intención multimedia

Cuando un usuario pide explícitamente arreglar, pulir, estilizar, oscurecer, enfatizar o revelar medios fotográficos, lee references/media-treatments.md incluso si no menciona gradación de color ni un efecto. Inspecciona el <img>/<video> real, elige una intención principal, luego usa persistencia y verificación deterministas. Usa una receta coincidente como semilla probada opcional, o inspecciona hyperframes media-treatment --capabilities --json, luego solicita una familia/efecto relevante con --capability <id> y ensambla un tratamiento personalizado a partir de controles canónicos. Nunca cargues --all para una autoría ordinaria. Un tratamiento puede componer corrección, un preajuste, acabado, efectos de sombreado compatibles, fotogramas clave admitidos y superposiciones de Registry opcionales. Añade solo ajustes limitados justificados por la fuente y partes compatibles, nunca efectos solo para que el resultado se vea más sofisticado. Persiste la carga útil final combinada con hyperframes media-treatment.

Usa un flujo de trabajo progresivo. Para video, inspecciona una hoja de contactos etiquetada de principio/medio/final en lugar de leer fotogramas por separado. Aplica un candidato e inspecciona una hoja posterior para corrección o pulido ordinario. Escala a fotogramas individuales o evidencia de borrador en movimiento solo cuando el resultado sea ambiguo, temporal, estilizado, basado en LUT, sensible a HDR/LOG, privado o crítico para la marca.

Para corrección o pulido ordinario, persiste el JSON de preajuste/ajuste del tratamiento final. No generes un LUT .cube solo para codificar exposición, sombras, contraste o calidez. Usa un LUT solo cuando el usuario lo proporcione o el tratamiento seleccionado lo posea explícitamente. resolve --type grade --for ... --analyze es evidencia de medición, no permiso para reemplazar el tratamiento elegido con un LUT generado. No recrees efectos de viñeta, grano, desenfoque, pixelado, color o tratamiento compatibles con superposiciones CSS/SVG; eso evade los controles de Studio y la ruta canónica de previsualización/renderizado del sombreador.

Sé proactivo — realiza un pase de oportunidades multimedia

El humano generalmente no sabe qué medio mejoraría la pieza. Tú sí. Cuando construyes o revisas una composición, haz un escaneo fundamentado y luego pregunta una vez — no añadas en silencio, y no insistas por cada activo.

Ofrece una oportunidad solo cuando haya una señal concreta presente:

Señal detectadaOferta
Texto en pantalla / un guion sin voiceoverVoiceover TTS (motor de audio)
Emoji o un <div> estilizado como iconoResolver icon reales
Imagen que es un marcador de posición, pequeña o con upscalingUna mejor image (y/o upscaling — ver references/operations.md)
Cortes de escena duros / transiciones sin sonidosfx de transición
Una pieza de más de ~10s sin base musicalbgm
Metraje que parece subexpuesto, sobreexpuesto o con dominanteUna gradación correctiva (inspecciona con hyperframes media-treatment --selector '#hero' --analyze --json)
Medios fotográficos que se sienten visualmente planos o fuera de temaUn preajuste específico apropiado para la fuente o un tratamiento personalizado, nombrando el objetivo
Una entrada/revelación de medios significativa que se siente estáticaUna animación de tratamiento compatible con búsqueda segura; preserva el color a menos que la solicitud también justifique un preajuste

Reglas que mantienen esto como una ayuda, no como una molestia: fundamentado, no genérico (sin señal → sin sugerencia); opinado + concreto (propón la solución específica con valores predeterminados elegidos — el humano aprueba todo / algo / nada); una vez por proyecto (una pregunta consolidada; respeta "déjalo así"); superficie, nunca mutar en silencio (gradaciones de color especialmente: propón y previsualiza — una "corrección" de mundo gris arruina una puesta de sol intencional o un aspecto neón).

Dónde mirar — lee solo el archivo que tu tarea necesita

TareaLee
resolver / reutilizar / adoptar / ingerir, banderas, cascada, inventarioreferences/resolve.md
gradación de color, LUTs, gradación inteligente (--for), comparaciónreferences/grading.md
voiceover / TTS, música, SFX, subtítulos, transcripción (motor de audio)references/audio.md
cortar / reencuadrar / transformar medios existentes, difusión de error, HEVCreferences/operations.md
tratamientos creativos conscientes de la fuente, efectos en tiempo realreferences/media-treatments.md
instalación + autenticación, tabla de proveedores, escaleras de RAMreferences/setup-providers.md
preferencias recordadas + recetas congeladas (memoria del usuario)references/memory.md
matriz de propiedad, estadísticas de uso, telemetría, privacidadreferences/meta.md

Individual skills in this repo

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

sandeshrajbhandari/hyperframes-instruct

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.

sandeshrajbhandari/hyperframes-instruct

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.

sandeshrajbhandari/hyperframes-instruct

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`.

sandeshrajbhandari/hyperframes-instruct

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, history, clean, 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.

sandeshrajbhandari/hyperframes-instruct

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.

sandeshrajbhandari/hyperframes-instruct

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`.

sandeshrajbhandari/hyperframes-instruct

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.

sandeshrajbhandari/hyperframes-instruct

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).

sandeshrajbhandari/hyperframes-instruct

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.

sandeshrajbhandari/hyperframes-instruct

Use when working with a person on a HyperFrames project in Studio: first, whether their message asks for a change at all (questions, loose ideas and "don't change anything" get an answer and a plan, not an edit); for a new film, the plan, storyboard and build order that the HyperFrames launch films follow; and 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`.

sandeshrajbhandari/hyperframes-instruct

A short, design-led motion graphic where motion is the message — kinetic typography, stat count-up, chart/data-viz hit, logo sting / brand lockup, lower-third / callout / social overlay, animated map (highlight regions, connect places, zoom to a location), animated tweet / news-article / headline, webpage / UI animation (scroll, cursor, callouts), or fusing a real image's geometry into a chart. Usually under 10s (up to ~30s), no narration or live-action subject; renders to MP4 or transparent overlay. Longer / narrated / multi-scene → /general-video. Unclear → /hyperframes.

Skills relacionados