media-use (uso de medios)
El sistema operativo multimedia para HyperFrames: resolver · generar · operar · recordar — cada tipo de medio, un solo skill, sin ruido de contexto.
Primera ejecución: instalar e iniciar sesión en la CLI de heygen (ruta de uso gratuito), luego verificar con node <SKILL_DIR>/scripts/resolve.mjs --doctor. Configuración y proveedores: references/setup-providers.md.
Resolver — el único verbo
node <SKILL_DIR>/scripts/resolve.mjs --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.
| Tipo | Intención en una línea |
|---|---|
bgm | música de fondo (catálogo HeyGen, 10k+ pistas) |
sfx | efectos de sonido (biblioteca empaquetada de 19 archivos + catálogo) |
image | fotos, fondos (búsqueda de activos HeyGen, 75k+ vectores) |
icon | iconos, símbolos (transparentes) |
logo | marcas oficiales (svgl → simple-icons → avatar de GitHub → favicon; nunca redibujado) |
voice | locución TTS (ruta gratuita de HeyGen; Kokoro local opcional) |
grade | candidato de corrección medido; el pulido/estilización amplio sigue los Tratamientos de Medios |
lut | archivo .cube validado, proporcionado por el usuario o explícitamente elegido y reutilizable |
Antes de resolver algo nuevo, lista los candidatos reutilizables con --candidates y juzga tú mismo la idoneidad — 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 de medio
Cuando un usuario pida explícitamente arreglar, pulir, estilizar, ocultar, enfatizar o
revelar medios fotográficos, lee references/media-treatments.md incluso si no
menciona gradación de color o un efecto. Inspecciona la <img>/<video> real,
elige una intención primaria, 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 arma un tratamiento personalizado a partir de
controles canónicos. Nunca cargues --all para autoría ordinaria. Un tratamiento puede
componer corrección, un preset, acabado, efectos de shader compatibles, fotogramas clave
soportados y superposiciones opcionales del Registro. Añade solo ajustes acotados
justificados por la fuente y partes compatibles, nunca efectos solo para que el resultado
se vea más sofisticado. Persiste la carga final combinada con
hyperframes media-treatment.
Usa un flujo de trabajo progresivamente escalable. Para video, inspecciona una hoja de contacto etiquetada de inicio/medio/final en lugar de leer fotogramas por separado. Aplica un candidato e inspecciona una hoja posterior para corrección o pulido ordinarios. 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 ordinarios, persiste el JSON de preset/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
soportados con superposiciones CSS/SVG; eso pasa por alto los controles de Studio y la
ruta canónica de previsualización/renderizado de shaders.
Sé proactivo — realiza una pasada de oportunidades multimedia
El humano normalmente no puede saber qué medio mejoraría la pieza. Tú puedes. Cuando construyas o revises una composición, haz un escaneo fundamentado y luego pregunta una vez — no añadas en silencio, y no molestes por cada activo.
Ofrece una oportunidad solo cuando haya una señal concreta:
| Señal detectada | Ofrece |
|---|---|
| Texto en pantalla / un guión sin locución | Locución TTS (motor de audio) |
Emoji o un <div> estilizado como icono | Resolver icons reales |
| Imagen que es un marcador de posición, pequeña o con aspecto de escalada | Una image mejor (y/o escalar — ver references/operations.md) |
| Cortes bruscos / transiciones sin sonido | sfx de transición |
| Una pieza de más de ~10s sin cama musical | bgm |
| Metraje que se ve sub/sobre-expuesto o con dominante de color | Una gradación correctiva (inspecciónalo con hyperframes media-treatment --selector '#hero' --analyze --json) |
| Medios fotográficos que se ven visualmente planos o fuera de tema | Un preset o tratamiento personalizado específico y apropiado para la fuente, con el objetivo previsto nombrado |
| Una entrada/revelación de medio significativa que se siente estática | Una animación de tratamiento compatible con seek-safe; conserva el color a menos que la solicitud justifique también un preset |
Reglas que mantienen esto como una ayuda, no como molestia: fundamentado, no genérico (sin señal → sin sugerencia); con opinión + 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 mutación silenciosa (especialmente las gradaciones de color: 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
| Tarea | Lee |
|---|---|
| resolver / reutilizar / adoptar / ingerir, banderas, cascada, inventario | references/resolve.md |
gradación de color, LUTs, gradación inteligente (--for), comparación de gradación | references/grading.md |
| locución / TTS, música, SFX, subtítulos, transcripción (motor de audio) | references/audio.md |
| cortar / reencuadrar / transformar medios existentes, difusión de error exacta, HEVC | references/operations.md |
| tratamientos creativos sensibles a la fuente, efectos en tiempo real, superposiciones, revelaciones | references/media-treatments.md |
instalación + autenticación, tabla de proveedores, escaleras de RAM, --local-only, --provider | references/setup-providers.md |
| preferencias recordadas + recetas congeladas (memoria del usuario) | references/memory.md |
| matriz de propiedad, estadísticas de uso, telemetría, privacidad (orientado al mantenedor) | references/meta.md |