Communitygithub.com

christiansalazar-wk/ai-lore

Contrato de composição HyperFrames — estrutura HTML, atributos data-*, clipes e trilhas. A referência oficial para escrever HTML HyperFrames válido.

O que é ai-lore?

Este skill define o contrato de composição central do HyperFrames, um sistema baseado em HTML para criar animações e composições audiovisuais. Ele descreve a estrutura HTML obrigatória, incluindo a tag `<html>` com o atributo `data-hf-version`, e as meta tags `<meta name="hf:*">` que configuram o canvas, FPS, duração e cor de fundo. O skill detalha os atributos `data-hf-*` para cenas, trilhas e clipes, que controlam desde a duração e transições até animações, volume e loop. Exemplos de clipes de mídia (vídeo, imagem, áudio, TTS) e o formato de tempo (CSS-style) são fornecidos, junto com um comando de validação via `npx hyperframes lint`. Útil para desenvolvedores que usam agentes de IA como Claude Code ou Cursor para gerar HTML HyperFrames válido, garantindo que a saída siga o padrão esperado pelo interpretador HyperFrames.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/christiansalazar-wk/ai-lore/tree/HEAD/skills/hyperframes-core

Perguntar na sua IA favorita

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

Prévia

Do README da skill

ai-lore preview

Documentação

HyperFrames Core — Contrato de Composição

Esqueleto HTML

<!DOCTYPE html>
<html data-hf-version="1">
<head>
  <meta charset="UTF-8" />
  <meta name="hf:canvas-width" content="1920" />
  <meta name="hf:canvas-height" content="1080" />
  <meta name="hf:fps" content="30" />
  <meta name="hf:duration" content="auto" />
</head>
<body>
  <div data-hf-scene="intro" data-hf-duration="5s">
    <div data-hf-track="background">
      <div data-hf-clip data-hf-start="0s" data-hf-duration="5s"
           style="background:#111;width:100%;height:100%;position:absolute;"></div>
    </div>
    <div data-hf-track="title">
      <div data-hf-clip data-hf-start="0.5s" data-hf-duration="4s"
           data-hf-animate="fade-in">
        <h1>Hello World</h1>
      </div>
    </div>
  </div>
</body>
</html>

Meta Tags do Canvas

TagPadrãoObservações
hf:canvas-width1920pixels
hf:canvas-height1080pixels
hf:fps30quadros por segundo
hf:durationautototal; ou explícito, por ex. 60s
hf:bg-color#000fundo da cena padrão

Atributos de Cena (data-hf-scene)

AtributoTipoDescrição
data-hf-scenestringnome/id da cena
data-hf-durationtempo5s, 10s, auto
data-hf-transitionstringcut, fade, slide-left, slide-right, zoom
data-hf-transition-durationtempopadrão 0.5s
data-hf-bgurl ou corfundo da cena

Atributos de Trilha (data-hf-track)

AtributoTipoDescrição
data-hf-trackstringnome da trilha
data-hf-znúmeroempilhamento z-index
data-hf-mutebooleanosilenciar áudio nesta trilha

Atributos de Clipe (data-hf-clip)

AtributoTipoDescrição
data-hf-clip—marca o elemento como um clipe
data-hf-starttempodeslocamento de início dentro da cena
data-hf-durationtempoduração do clipe; auto = duração do conteúdo
data-hf-endtempoalternativa à duração
data-hf-animatestringpredefinição de animação abreviada
data-hf-instringanimação de entrada
data-hf-outstringanimação de saída
data-hf-volume0–1volume do áudio
data-hf-speednúmeromultiplicador de velocidade de reprodução
data-hf-loopbooleanorepetir mídia
data-hf-trim-starttempocortar mídia do início
data-hf-trim-endtempocortar mídia no final

Clipes de Mídia

<!-- Vídeo -->
<video data-hf-clip data-hf-start="0s" src="assets/hero.mp4" />

<!-- Imagem (estática, mantida pela duração) -->
<img data-hf-clip data-hf-start="0s" data-hf-duration="3s" src="assets/logo.png" />

<!-- Áudio -->
<audio data-hf-clip data-hf-start="0s" src="assets/music.mp3" data-hf-volume="0.4" />

<!-- Narração TTS -->
<div data-hf-clip data-hf-tts="Olá, bem-vindo à demonstração." data-hf-start="1s" />

Formato de Tempo

Todos os valores de tempo usam notação CSS-style: 0s, 1.5s, 2000ms. Segundos fracionados são permitidos.

Validação

npx hyperframes lint index.html

Individual skills in this repo

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

Habilidades Relacionadas