Communitygithub.com

MattiaIppoliti/tia-skills

Crie ou edite composições HyperFrames personalizadas quando nenhum fluxo de trabalho especializado se encaixa, ou quando o BRIEF.md define flow: companion. Ideal para peças longas ou com várias cenas, reels de marca e sizzle, montagens, loops estáticos, cartões de título estáticos, remixes de metragem e construções livres.

O que é tia-skills?

Este skill permite que agentes de IA (como Claude Code, Cursor, Codex) atuem como diretores criativos para produzir vídeos customizados usando o framework HyperFrames. Ele gerencia todo o pipeline: desde a interpretação de um brief, seleção de adaptadores de mídia e Figma, planejamento de narrativa, storyboard, validação de design, até a exportação final. O skill é ativado quando workflows especializados não se aplicam ou quando o fluxo é definido como 'companion' (co-criação com o usuário). Suporta tanto automação total (flow: automation) quanto colaboração dirigida (flow: companion). Embora o contrato HTML legado não esteja mais em uso, o skill fornece diretrizes essenciais de design e ritmo que devem ser expressas através do contrato Remotion/React em `/hyperframes-core`. O skill também gerencia gateways de autenticação para provedores de mídia, aplicação de receitas e gravação de preferências, garantindo que o agente opere de forma determinística e transparente.

Funciona com~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/MattiaIppoliti/tia-skills/tree/HEAD/skills/video/general-video

Perguntar na sua IA favorita

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

Documentação

⚠ Status do contrato: ainda não portado para Remotion

O framework de saída deste stack é Remotion + React (/hyperframes-core). Este skill ainda descreve o pipeline antigo HTML + data-* + timeline GSAP pausada, e seus scripts incluídos ainda emitem index.html nesse contrato.

Até que seja portado:

  • Não execute npx hyperframes <qualquer coisa> — essa CLI foi descontinuada. /hyperframes-cli mapeia cada comando antigo para seu equivalente em Remotion.
  • Não copie sua marcação data-* ou código de timeline GSAP para um projeto Remotion.
  • Faça absorver o conhecimento dele: formato da história, ritmo de corte, design visual, as decisões sobre o que aparece na tela. Essa parte é independente de framework e é o motivo deste skill ainda estar aqui.
  • Faça expressar o resultado através do contrato de /hyperframes-core: <Composition>, <Sequence> e valores derivados de useCurrentFrame().

Diga no seu resumo quando você teve que contornar isso, para que a portabilidade possa ser concluída.

Vídeo geral

Antes de confiar neste fluxo de trabalho, execute:

npx hyperframes skills update general-video

Um no-op bem-sucedido significa que o skill está atualizado. Exiba uma falha de atualização em vez de continuar de memória.

1. Aplicar adaptadores de fonte abrangentes

  • Mídia: Para qualquer necessidade de áudio, imagem, ícone, logotipo, voz, correção de cor, LUT, tratamento/efeito, legenda ou operação de mídia, carregue /media-use e siga ../media-use/references/resolve.md (resolver, adotar, reutilizar) e ../media-use/references/setup-providers.md (provedores, autenticação). Feedback vago de metragem e estilos nomeados usam ../media-use/references/media-treatments.md antes de editar; não improvise efeitos de mídia suportados com CSS/SVG/opacidade. Antes da primeira ação autenticada do provedor, execute npx hyperframes auth status e transmita sua saída literalmente. Se desconectado, aplique a barreira em ../hyperframes-core/references/brief-contract.md: cooperação aguarda login ou uma escolha explícita offline; autônomo informa o status e continua através de um provedor offline disponível. Exiba um bloqueador quando nenhum provedor offline puder satisfazer uma capacidade necessária. A adoção local sozinha não requer uma barreira de autenticação.
  • Figma: Se qualquer entrada for uma URL figma.com, execute /figma primeiro. Construa a partir de seus ativos exportados, tokens, componentes ou quadros de storyboard. Não use chamadas brutas do conector Figma, pois elas ignoram a sanitização de SVG, proveniência de mídia e vinculação de tokens de marca.

Esses adaptadores não alteram o fluxo de trabalho selecionado por /hyperframes.

2. Começar a partir do estado do projeto

Aplique a primeira linha correspondente; não avalie linhas de estado inferiores:

EstadoAção
Edição específicaFaça a edição, preserve as decisões existentes do projeto e reexecute as verificações afetadas. Não reabra a descoberta.
BRIEF.md existeLeia-o. Se workflow nomear outro fluxo de trabalho e flow não for companion, repasse. Não faça perguntas sobre o brief.
Sem brief, mas hyperframes.json ou STORYBOARD.md existeRetome dos arquivos e preferências registradas. Preencha BRIEF.md apenas a partir de fatos conhecidos.
Criação novaExecute /hyperframes e sua camada de intenção. Retorne aqui apenas para workflow: general-video ou flow: companion.

Para um novo projeto, escolha um nome de diretório em kebab-case a partir do brief e crie o esqueleto antes de escrever o brief:

npx hyperframes init "videos/<projeto>" --non-interactive --example=blank --skill=general-video

Em seguida, escreva BRIEF.md na raiz do projeto usando ../hyperframes-core/references/brief-format.md. Em um projeto existente, a raiz é o diretório que contém hyperframes.json. Registre apenas os campos confirmados baseados em preferências nomeados pelo formato do brief, usando node <MEDIA_DIR>/scripts/prefs.mjs record --hyperframes <PROJECT_ROOT>; nunca registre padrões inferidos. Aqui <MEDIA_DIR> é o diretório do skill /media-use instalado e <PROJECT_ROOT> é o diretório que contém hyperframes.json. Se a camada de intenção adotou uma receita, aplique-a agora com node <MEDIA_DIR>/scripts/recipe.mjs use --hyperframes <PROJECT_ROOT> --name <nome> e não pergunte novamente.

3. Interpretar a forma de execução

Use apenas os termos canônicos de ../hyperframes-core/references/brief-contract.md:

CampoSignificadoEfeito
flowQuem dirigeautomation: escolha e execute a rota. companion: cocrie em conversação.
storyboardSe o board é uma superfície de revisãoyes: execute revisão de plano e esboço. no: construa sem o board.
mode derivadoComo os gates de checkpoint se comportamSiga o contrato do brief. Nunca peça ao usuário para nomear um modo.

Não invente sinônimos para esses estados. Um sinal contínuo de "apenas construa" é tratado pela camada de intenção e chega como flow: automation, storyboard: no.

  • Para flow: automation, escolha a rota e declare-a em uma linha na primeira atualização de progresso.
  • Para uma edição específica, faça a edição sem inventar uma nova rota.

Para um corte brusco, corte, emenda ou reordenação de metragem existente, duplique a mesma fonte de vídeo em vários elementos de clipe. Em cada cópia, defina o intervalo de origem com data-media-start mais data-duration, em seguida, defina o posicionamento/ordem autorizado com data-start. O áudio autorizado separadamente segue os mesmos intervalos de clipe e temporização em elementos <audio> correspondentes. /hyperframes-core é o dono dessa edição temporal; use /hyperframes-keyframes apenas para animação de propriedades visuais, como zoom, punch, pan, crop, mask ou clip-path em um wrapper interno. Copie os contratos completos de ../hyperframes-core/references/editing-recipes.md.

Fluxo de companheiro

Quando flow: companion:

  • Leia BRIEF.md e reconcilie ## Assets e ## Customizations aceitos com os artefatos do projeto. Complete o trabalho aceito que ainda está pendente; deixe o trabalho concluído em paz; não ofereça uma capacidade aceita novamente como se fosse nova.
  • Chegue como o diretor, não o contratante. Um usuário que escolheu companheiro escolheu envolvimento e qualidade; a resposta honesta é a melhor versão que você pode projetar, não a menor que você pode defender. O primeiro plano é o tratamento de teto: o arco da história (pegue emprestada a lente de gênero mais próxima — menu § Lentes de gênero), a especificação de design, o tratamento de movimento de cada cena citado pelo nome (§ 5 da disciplina de plano), as transições, a identidade de áudio — música e marcas sonoras, ou silêncio deliberado — o material do usuário colocado, e uma abertura e fechamento projetados. Diga o que cada camada adiciona em uma linha; sinalize as caras (tempo de renderização, login, cobrança) ao nomeá-las. O usuário corta um tratamento; eles nunca devem ter que montar um, aprovação por aprovação.
  • O teto pertence ao conceito, não à caixa de ferramentas. Cada camada deve servir à mensagem do brief — um tratamento que vestiria qualquer vídeo da mesma forma é decoração. O ofício sobe até o teto; o conteúdo nunca ultrapassa o que foi solicitado (§ 6).
  • Entre checkpoints, ../hyperframes/references/capability-menu.md funciona de duas maneiras. Como lista de gatilho: ofereça uma capacidade relevante quando o usuário mencionar sua entrada ou a construção atingir sua necessidade. Como canal de atualização de cada passagem: um checkpoint de plano, esboço ou construção pode carregar uma ou duas ofertas rastreadas apontadas para o material que o usuário está olhando ("a estatística da cena 3 quer o tratamento de contagem"). Leia-o antes de oferecer; nunca despeje o catálogo inteiro.
  • Depois que o usuário aceitar uma capacidade, produza seu artefato e registre a decisão na seção correspondente do corpo de BRIEF.md imediatamente. Reescreva um campo de frontmatter e registre a preferência confirmada apenas quando o usuário a alterar explicitamente.
  • Mantenha os mesmos gates de storyboard, validação, pré-visualização final e aprovação de renderização. Companheiro muda quem dirige, não o que a qualidade exige.

4. Carregar conhecimento necessário antes de cada etapa

Estas leituras são obrigatórias quando sua condição corresponder:

CondiçãoLeia antes de agir
Qualquer HTML de composição ou layout de cena/hyperframes-core; use references/determinism-rules.md para seu contrato de layout
Qualquer criação não trivial ou tratamento visual/hyperframes-creative → references/house-style.md e references/video-composition.md
Qualquer movimento, animação ou transição de cena/hyperframes-animation; siga seu roteamento para as regras, adaptadores, blueprints ou referências de transição correspondentes
storyboard: yes../hyperframes-core/references/storyboard-format.md e ../hyperframes-core/references/review-loop.md
Qualquer ativo ou operação de mídia, incluindo narração, BGM, SFX, legendas, correção de cor ou transformações/media-use; para reprodução e posicionamento do framework, leia também /hyperframes-core → references/media.md
Montagem de várias cenas../hyperframes-core/references/production-loop.md
flow: companion, antes do primeiro plano/hyperframes-creative → references/story-spine.md e references/house-style.md; a lente de gênero mais próxima e o ../hyperframes/references/capability-menu.md completo — o tratamento de teto é projetado a partir destes, não lembrado
Uma oferta de capacidade de companheiro, captura, grade de batida, vídeo generativo, mapa, publicação ou capacidade entre fluxos de trabalho../hyperframes/references/capability-menu.md
Uma especificação de design existe, antes da aprovação final/hyperframes-creative → references/design-adherence.md

Não substitua essas leituras por recordação. A divulgação progressiva economiza contexto apenas quando a referência correspondente é realmente carregada.

5. Executar a composição

Use esta ordem de dependência. Pule uma etapa apenas quando sua entrada estiver ausente.

  1. Plano. Declare o arco do espectador, estrutura, ritmo e driver de duração. Use um arquivo para uma cena única curta; use sub-composições para três ou mais cortes bruscos de cena ou qualquer cena reutilizada. Leia /hyperframes-creative → references/story-spine.md para arcos narrados, references/beat-direction.md para ritmo e /hyperframes-core → references/project-structure.md para estrutura. Para um brief de várias cenas em aberto, expanda o prompt através de /hyperframes-creative → references/prompt-expansion.md. Um plano de várias cenas cita a forma de cada cena: um id de blueprint de /hyperframes-animation → blueprints-index.md quando um se encaixa, ou as regras nomeadas que ele compõe de rules-index.md quando nenhum se encaixa — nomes de movimento vêm desses índices, nunca inventados. A verdade da história decide quais cenas existem; a citação as veste. Um plano de várias cenas também é registrado como o artefato de despacho: um bloco ## Frame N por cena em STORYBOARD.md — status: outline, um src: declarado, a citação de blueprint/regras e o texto da batida — mesmo quando storyboard: no. O bloco é a unidade de despacho; o board é apenas a superfície de revisão.
  2. Revisar o plano quando solicitado. Para storyboard: yes, execute o loop de revisão compartilhado sobre esses blocos. Para storyboard: no, continue sem abrir o board. Quando uma pausa de plano acontecer de qualquer forma,

... [truncado para tradução]

Individual skills in this repo

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

MattiaIppoliti/tia-skills

The technique catalog: five velocity-matched SEAMS (zoom-through, INVERSE zoom-through, cut-the-curve, waterfall cut, rack-focus blur-cut) plus the two in-scene techniques — waterfall ENTRY (staggered arrival cascades for title cards / segment openers) and the nudge curve (slow-fast-slow three-phase group slides). Covers partial-travel (~12% of frame) velocity matching via mirrored power4 eases, the Z scale-sign rule, size-scaled blur (10px text / 18-20px full-frame), word-by-word staggered cuts, cascade pacing by element weight, and the 10/65/25 slide ratio. Read before authoring any transition, text-beat handoff, kinetic text entry, or group reposition. [depth, zoom, inverse-zoom, scale-sign, mirrored-zoom, rack-focus, pacing, velocity, cut-the-curve, waterfall, stagger, cascade, kinetic-text, title-card, segment-opener, nudge, slide, easing, group-motion, z-depth, motion-graphics, cinematic, transition, blur, directional-continuity]

MattiaIppoliti/tia-skills

Import Figma content into a HyperFrames composition — rendered assets, brand tokens, components, storyboard sections → reconstructed motion (frames read as states, not slides) (REST/CLI), connector-assisted motion when available, and shaders from a connector or native export. Use when the user pastes a figma.com link or asks to bring a Figma design, frame, logo, brand, or animation into a video/composition.

MattiaIppoliti/tia-skills

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.

MattiaIppoliti/tia-skills

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), or automation envelopes drawn on a track's volume or any effect parameter. 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`.

MattiaIppoliti/tia-skills

Drive the Remotion CLI development loop: scaffold, studio, type-check, compositions, still probes, single and batch render, bundle, Lambda and Cloud Run rendering, benchmark, versions, upgrade, and GPU checks. Also use when diagnosing a build or render failure, or when looking for a capability the retired HyperFrames CLI used to own.

MattiaIppoliti/tia-skills

The composition contract for building one renderable Remotion project. Use for project structure, `<Composition>` registration, `<Sequence>` timing, layer/track ordering, scene components, props and schemas, framework-owned media playback, deterministic-render rules, and validation. Also covers Tailwind projects and the STORYBOARD.md / SCRIPT.md plan formats. Read before writing composition code.

Habilidades Relacionadas