Communitygithub.com

author-anim

Crie um "anim", um módulo YAML único que anima a letra e as batidas de uma música no navegador (canvas2d, SVG, DOM ou three.js), a partir de um breve resumo. Use quando for solicitado a criar, portar, reformatar ou corrigir um anim / visualizador de letras / módulo de animação de letras. Funciona apenas com essa habilidade; não é necessária uma biblioteca de exemplos ou catálogo.

O que é author-anim?

Esta habilidade capacita um agente de IA a gerar um arquivo YAML autossuficiente, chamado "anim", que anima a letra e as batidas de uma música no navegador. O anim é um módulo que combina JavaScript, CSS e HTML/SVG em um único arquivo, seguindo regras rigorosas de pureza funcional (cada quadro é uma função pura do tempo de reprodução), separação de lógica (metade pura e metade de navegador) e legibilidade acima de efeitos visuais. A habilidade é compatível com backends como Canvas2D, SVG, DOM e Three.js, e oferece um fluxo de trabalho completo: desde a elaboração de um resumo de design, passando pela implementação, validação e verificação contra 13 músicas de teste, até a entrega final do arquivo YAML. Ela é útil para desenvolvedores que precisam criar ou modificar visualizadores de letras musicais de forma consistente, acessível e performática, garantindo que funcionem corretamente em diferentes temas (claro/escuro), dispositivos e estados de reprodução (play, pause, seek).

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Criar um anim

Um anim é um arquivo, <kebab-name>@<major>.<minor>.yaml, com exatamente quatro chaves: t (o literal c), j (um módulo ES), s (CSS), h (HTML/SVG). Um player host o executa com uma API global G que fornece as sílabas, palavras, linhas, seções e batidas da música. Seu trabalho: transformar um resumo em um desses arquivos que seja correto sob seek/pause/redimensionar/tema, legível e bonito. Os caminhos abaixo são relativos a este diretório skill/.

As regras mais importantes

  1. Um quadro é uma função pura do tempo de reprodução. render(t) deve desenhar a mesma imagem quer a reprodução tenha atingido t quer o usuário tenha arrastado até ele. Sem Math.random, Date.now, integração acumulada ou estado "o que aconteceu no último quadro" que um seek pularia. Derive tudo dos dados da música, da semente e de t.
  2. Duas metades. Uma metade pura exportada, livre de DOM (buildPlan, frameAt, helpers; testável por unidade) acima de um comentário de banner, depois uma metade fina de navegador (export default function (G, shadowRoot, config)) que apenas conecta e desenha. Veja guides/architecture.md.
  3. Registre em default, leia dados da música em INIT. G.on / G.off / G.onFrame apenas dentro de default. G.map / forEach / lookup / iterator / relayout apenas depois que INIT for disparado (um manipulador INIT, ou callbacks posteriores como render), nunca no próprio default. Inscreva G.on(G.TYPE.TICK, render) para reprodução; G.onFrame({ render, reset }) cobre SEEK/PLAY/PAUSE/RESIZE e UNINIT.
  4. Limpe com G.dispose / G.listen. Uma função retornada de default é ignorada. Libere WebGL (forceContextLoss), listeners, timers, câmera.
  5. As cores vivem no CSS, não em c.v. Valores claros em :host, substituições escuras em [data-bs-theme=dark] { }; o canvas lê de volta com g-lib cssColors. Ambos os temas devem parecer intencionais.
  6. Nunca implemente manualmente o que g-lib já tem (clamp, lerp, easing, RNG baseado em semente, ajuste de canvas, molas, layout de texto, pools...). Importe do pin de tag exata; consulte pitfalls/dont-hand-roll.md e spec/g-lib.md antes de escrever qualquer helper.
  7. Legibilidade supera o efeito. A sílaba ativa é legível em claro e escuro, no telefone e no laptop, para linhas longas, CJK, RTL e Mianmar. Grandes flashes permanecem abaixo de 3 Hz (guides/accessibility.md).
  8. Poucas opções tipadas. c e cSchema são literais simples; cada opção faz algo visível.

Fluxo de trabalho (com as ferramentas do repositório)

  1. Resumo. Escreva o resumo de design a partir de guides/design-brief.md: uma imagem física forte; o mecanismo; quais eventos impulsionam o quê (o mapa de sincronia); estrutura (estrofe/refrão/batida); plano de legibilidade; opções; armadilhas. Escolha o backend com sua tabela de seleção. Rejeite ideias que não possam permanecer legíveis.
  2. Estrutura. npm run new -- <name> --backend canvas2d|svg|dom|three (ou copie templates/<backend>.yaml manualmente e substitua __NAME__).
  3. Leia uma vez: spec/module-format.md, pitfalls/general.md, a seção do seu backend em pitfalls/backends.md, pitfalls/dont-hand-roll.md. Abra qualquer outra coisa apenas através da tabela de roteamento abaixo.
  4. Implemente primeiro a metade pura (tempo para estado), depois a metade fina do navegador.
  5. Valide. npm run validate -- anims/<file>.yaml. Corrija todos os erros; justifique todos os avisos no docblock ou corrija-os.
  6. Verifique. npm run check -- anims/<file>.yaml monta 13 músicas de borda headlessly, pontua a tabela de conformidade e escreve PNGs em out/<name>/. Abra os PNGs (telefone/laptop, claro/escuro). Uma tabela verde sobre um quadro feio ou ilegível é uma falha. Um WARN em uma linha de pureza de seek significa que a imagem depende do histórico: corrija ou justifique no docblock (uma simulação deliberada).
  7. Pré-visualize (opcional). npm run preview -- anims/<file>.yaml para reproduzir, arrastar, alternar tema e ajustar opções.
  8. Revise contra guides/quality-rubric.md (20 perguntas), depois entregue o único arquivo YAML e um breve relatório (nome do arquivo, tabela de verificação final, decisões que o resumo deixou em aberto, o que você deliberadamente não fez). Não envie out/ ou o harness.

Modo sem ferramentas (modelos de chat, sem shell)

Pule as etapas 2, 5-7. Comece pelo texto do modelo correspondente, escreva o resumo de design em seu raciocínio, depois percorra pitfalls/general.md, a seção do backend e a rubrica de 20 perguntas linha por linha em relação ao seu próprio código antes de responder. Produza apenas o arquivo YAML em um bloco com cerca, e mencione quais itens da rubrica você não pôde verificar sem executá-lo (pureza de seek, inversão de tema, redimensionamento).

Tabela de roteamento: abra um documento apenas quando seu gatilho se aplicar

Quando você estiver prestes a...Leia
decidir o que construir; escolher um backendguides/design-brief.md
organizar o arquivo; nomear estágios; escrever o docblockguides/architecture.md
usar qualquer chamada G.*, opção de evento ou intervalo de idspec/events.md, spec/event-shapes.md, spec/g.d.ts
adicionar opções, cores, temasspec/config.md
usar utilitários de tempo, medição de texto, helpers de canvas, ciclo de vidaspec/utilities.md
dividir linhas em linhas de exibição, quebrar textospec/relayout.md, guides/patterns-text.md
acionar coisas em sílabas/linhas/batidas; pré-criar; pausar; molasguides/patterns-timing.md
ajustar, destacar ou estilizar texto; scripts não latinosguides/patterns-text.md
escrever código de renderização (DOM, SVG, canvas, three, simulação, camadas)guides/patterns-render.md, pitfalls/backends.md
câmera, terreno, enxames, empacotamento, 3D proceduralguides/techniques.md, pitfalls/techniques.md
usar uma foto ou câmeraspec/image-input.md
construir um jogo (autoPlay false, pontuação, estados)guides/games.md
usar qualquer helper g-libspec/g-lib.md
sentir dúvidas sobre flash, movimento, contrasteguides/accessibility.md
terminarguides/quality-rubric.md

Forma mínima (não envie isto; comece a partir de um modelo)

"t": |-
  c
"j": |
  import { hash01 } from 'https://cdn.jsdelivr.net/gh/prjctg/[email protected]/index.js';
  /* [email protected]: <uma linha>
   * 1. <reivindicação de design numerada: o mecanismo e a resposta errada tentadora que ele rejeita> */
  export function frameAt(plan, t) { /* puro */ }
  /* Metade do navegador. Tudo acima desta linha é intencionalmente livre de DOM. */
  export default function (G, shadowRoot, config) {
    const cfg = G.cfg(config, { channel: G.cfg.int(0) });
    let ready = false;
    const render = (t) => { if (!ready) return; /* desenha frameAt(plan, t) */ };
    G.on(G.TYPE.INIT, () => { ready = true; /* G.map(...) é válido aqui */ });
    G.on(G.TYPE.TICK, render);
    G.onFrame({ render, reset() { ready = false; } });
  }
  export const c = { v: { fadeMs: 150 }, m: [{ s: 'fadeMs', t: 'fadeMs' }] };
  export const cSchema = [{ i: 'fadeMs', n: 'Fade (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 contêm texto bruto (nunca envolvido em crases ou aspas). t usa |-. O nome do arquivo carrega a versão; nunca edite uma versão publicada no local.

Habilidades Relacionadas