Communitygithub.com

author-anim

Crea un "anim", un módulo YAML único que anima las letras y los tiempos de una canción en el navegador (canvas2d, SVG, DOM o three.js) a partir de una breve descripción. Úsalo cuando te pidan hacer, portar, cambiar el estilo o arreglar un anim / visualizador de letras / módulo de animación lírica. Funciona solo con esta habilidad; no se necesita una biblioteca de ejemplos o catálogo.

¿Qué es author-anim?

Esta habilidad permite a un agente de IA (como Claude Code, Cursor o Codex) generar un "anim" a partir de una breve descripción: un archivo YAML autocontenido que anima las letras y los tiempos de una canción en el navegador. El anim es un solo archivo con cuatro claves (`t`, `j`, `s`, `h`) que define una animación pura en función del tiempo de reproducción, sin efectos secundarios ni estado acumulado. El agente puede trabajar tanto con herramientas de línea de comandos (scaffolding, validación, revisión visual) como sin ellas (modo de solo chat, generando el YAML directamente). La habilidad es compatible con múltiples backends (canvas2d, SVG, DOM, three.js) y proporciona reglas estrictas sobre accesibilidad, legibilidad, tema claro/oscuro y pureza de búsqueda. Es útil para desarrolladores que necesitan crear, modificar o depurar visualizadores de letras de canciones interactivos y responsivos.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/prjctg/animr-skill/tree/HEAD/skill

Preguntar en tu IA favorita

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

Documentación

Crear un anim

Un anim es un archivo, <nombre-en-kebab>@<major>.<minor>.yaml, con exactamente cuatro claves: t (el literal c), j (un módulo ES), s (CSS), h (HTML/SVG). Un reproductor anfitrión lo ejecuta con una API global G que proporciona las sílabas, palabras, líneas, secciones y tiempos de la canción. Tu trabajo: convertir una breve descripción en un archivo que sea correcto bajo búsqueda/pausa/redimensión/tema, legible y hermoso. Las rutas a continuación son relativas a este directorio skill/.

Las reglas más importantes

  1. Un fotograma es una función pura del tiempo de reproducción. render(t) debe dibujar la misma imagen tanto si la reproducción llegó a t como si el usuario se desplazó hasta él. Sin Math.random, Date.now, integración acumulada o estado de "lo que pasó en el fotograma anterior" que un salto omitiría. Deriva todo de los datos de la canción, la semilla y t.
  2. Dos mitades. Una mitad pura exportada, sin DOM (buildPlan, frameAt, ayudantes; comprobable mediante pruebas unitarias) encima de un comentario de banner, luego una mitad fina para el navegador (export default function (G, shadowRoot, config)) que solo conecta y dibuja. Consulta guides/architecture.md.
  3. Regístrate en default, lee los datos de la canción en INIT. G.on / G.off / G.onFrame solo dentro de default. G.map / forEach / lookup / iterator / relayout solo una vez que se haya disparado INIT (un manejador de INIT, o devoluciones de llamada posteriores como render), nunca en el propio default. Suscríbete G.on(G.TYPE.TICK, render) para la reproducción; G.onFrame({ render, reset }) cubre SEEK/PLAY/PAUSE/RESIZE y UNINIT.
  4. Limpia con G.dispose / G.listen. Una función devuelta por default se ignora. Libera WebGL (forceContextLoss), oyentes, temporizadores, cámara.
  5. Los colores viven en CSS, no en c.v. Valores claros en :host, anulaciones oscuras en [data-bs-theme=dark] { }; el lienzo los lee con la librería g-lib cssColors. Ambos temas deben verse intencionales.
  6. Nunca implementes manualmente lo que g-lib ya tiene (clamp, lerp, easing, RNG con semilla, ajuste de lienzo, resortes, diseño de texto, grupos...). Importa desde el pin de etiqueta exacta; consulta pitfalls/dont-hand-roll.md y spec/g-lib.md antes de escribir cualquier ayudante.
  7. La legibilidad prima sobre el efecto. La sílaba activa es legible en claro y oscuro, en teléfono y portátil, para líneas largas, CJK, RTL y Myanmar. Los destellos grandes se mantienen por debajo de 3 Hz (guides/accessibility.md).
  8. Pocas opciones escritas. c y cSchema son literales simples; cada opción hace algo visible.

Flujo de trabajo (con las herramientas del repositorio)

  1. Descripción. Escribe la descripción de diseño a partir de guides/design-brief.md: una imagen física fuerte; el mecanismo; qué eventos impulsan qué (el mapa de sincronización); la estructura (estrofa/estribillo/ritmo); el plan de legibilidad; las opciones; las trampas. Elige el backend con su tabla de selección. Rechaza ideas que no puedan mantenerse legibles.
  2. Andamiaje. npm run new -- <nombre> --backend canvas2d|svg|dom|three (o copia templates/<backend>.yaml manualmente y reemplaza __NAME__).
  3. Lee una vez: spec/module-format.md, pitfalls/general.md, la sección de tu backend en pitfalls/backends.md, pitfalls/dont-hand-roll.md. Abre cualquier otra cosa solo a través de la tabla de enrutamiento a continuación.
  4. Implementa primero la mitad pura (de tiempo a estado), luego la mitad fina del navegador.
  5. Valida. npm run validate -- anims/<archivo>.yaml. Corrige cada error; justifica cada advertencia en el bloque de documentación o corrígelo.
  6. Verifica. npm run check -- anims/<archivo>.yaml monta 13 canciones de casos extremos sin cabeza, puntúa la tabla de conformidad y escribe PNG en out/<nombre>/. Abre los PNG (teléfono/portátil, claro/oscuro). Una tabla verde sobre un fotograma feo o ilegible es un fallo. Una ADVERTENCIA en una fila de pureza de búsqueda significa que la imagen depende del historial: corrígelo o justifícalo en el bloque de documentación (una simulación deliberada).
  7. Vista previa (opcional). npm run preview -- anims/<archivo>.yaml para reproducir, desplazarse, cambiar de tema y ajustar opciones.
  8. Revisa contra guides/quality-rubric.md (20 preguntas), luego entrega el único archivo YAML y un informe breve (nombre del archivo, tabla de verificación final, decisiones que la descripción dejó abiertas, qué hiciste deliberadamente no hacer). No envíes out/ o el arnés.

Modo sin herramientas (modelos de chat, sin shell)

Omite los pasos 2, 5-7. Comienza desde el texto de la plantilla correspondiente, escribe la descripción de diseño en tu razonamiento, luego revisa pitfalls/general.md, la sección del backend y la rúbrica de 20 preguntas línea por línea contra tu propio código antes de responder. Genera solo el archivo YAML en un bloque delimitado, y menciona qué elementos de la rúbrica no pudiste verificar sin ejecutarlo (pureza de búsqueda, cambio de tema, redimensión).

Tabla de enrutamiento: abre un documento solo cuando su desencadenante aplica

Cuando estés a punto de...Lee
decidir qué construir; elegir un backendguides/design-brief.md
diseñar el archivo; nombrar etapas; escribir el bloque de documentaciónguides/architecture.md
usar cualquier llamada G.*, opción de evento o rango de idspec/events.md, spec/event-shapes.md, spec/g.d.ts
añadir opciones, colores, temasspec/config.md
usar utilidades de tiempo, medición de texto, ayudantes de lienzo, ciclo de vidaspec/utilities.md
dividir líneas en líneas de visualización, ajustar textospec/relayout.md, guides/patterns-text.md
activar cosas en sílabas/líneas/ritmos; pre-generar; pausa; resortesguides/patterns-timing.md
ajustar, resaltar o estilizar texto; escrituras no latinasguides/patterns-text.md
escribir código de renderizado (DOM, SVG, canvas, three, simulación, capas)guides/patterns-render.md, pitfalls/backends.md
cámara, terreno, enjambres, empaquetado, 3D proceduralguides/techniques.md, pitfalls/techniques.md
usar una foto o cámaraspec/image-input.md
construir un juego (autoPlay falso, puntuación, estados)guides/games.md
usar cualquier ayudante de g-libspec/g-lib.md
sentirte inseguro sobre destellos, movimiento, contrasteguides/accessibility.md
terminarguides/quality-rubric.md

Forma mínima (no envíes esto; comienza desde una plantilla)

"t": |-
  c
"j": |
  import { hash01 } from 'https://cdn.jsdelivr.net/gh/prjctg/[email protected]/index.js';
  /* [email protected]: <una línea>
   * 1. <afirmación de diseño numerada: el mecanismo y la respuesta incorrecta tentadora que rechaza> */
  export function frameAt(plan, t) { /* puro */ }
  /* Mitad del navegador. Todo lo que está encima de esta línea no tiene DOM a propósito. */
  export default function (G, shadowRoot, config) {
    const cfg = G.cfg(config, { canal: G.cfg.int(0) });
    let listo = falso;
    const render = (t) => { si (!listo) return; /* dibuja frameAt(plan, t) */ };
    G.on(G.TYPE.INIT, () => { listo = verdadero; /* G.map(...) es válido aquí */ });
    G.on(G.TYPE.TICK, render);
    G.onFrame({ render, reset() { listo = falso; } });
  }
  export const c = { v: { fadeMs: 150 }, m: [{ s: 'fadeMs', t: 'fadeMs' }] };
  export const cSchema = [{ i: 'fadeMs', n: 'Fundido (ms)', t: 'int', mn: 0, mx: 2000 }];
"s": |
  :host { display: block; --ink: var(--inkColor, #111); }
  [data-bs-theme=dark] { --ink: var(--inkColor, #eee); }
"h": |
  <canvas id="c"></canvas>

j, s, h contienen texto sin formato (nunca envuelto en comillas invertidas o comillas). t usa |-. El nombre del archivo lleva la versión; nunca edites una versión publicada en su lugar.

Skills relacionados