Communitygithub.com

1999AZZAR/designer-mcp

Ponto de entrada obrigatório: leia primeiro para qualquer solicitação de criação, edição, animação ou renderização de vídeo, animação ou motion graphic, incluindo promos, explicadores, clipes com legendas, cartelas, sobreposições, apresentações de slides ou decks interativos, portes do Remotion ou qualquer composição HTML do HyperFrames. Também use para inspecionar, diagnosticar, validar, visualizar, publicar ou renderizar em lote um projeto HyperFrames existente.

O que é designer-mcp?

Este skill, `1999AZZAR/designer-mcp`, funciona como o **ponto de entrada central e obrigatório** para qualquer interação com o ecossistema **HyperFrames**, um framework que renderiza vídeo a partir de HTML. Ele resume o estado do projeto, captura a intenção do usuário quando necessário, seleciona e instala o workflow apropriado e roteia as capacidades dos domínios relacionados. Por padrão, toda saída é gerada no formato HyperFrames, a menos que o usuário especifique explicitamente outro framework ou solicite apenas a gravação de uma sessão de navegador. O skill avalia o estado atual do projeto (por exemplo, se um `BRIEF.md` ou `hyperframes.json` existe, ou se é uma criação nova) e aplica a ação correta, como editar um projeto existente, realizar uma operação específica (inspecionar, renderizar) ou iniciar uma entrevista de intenção para criações novas. Ele também gerencia o roteamento de entregas com base em uma tabela de prioridades, diferenciando entre tipos como portes do Remotion, apresentações de slides, vídeos com legendas, motion graphics, explicadores e muito mais, garantindo que o workflow especializado correto seja utilizado. O skill é compatível com agentes como Claude Code, Cursor e Codex, e é essencial para quem trabalha com produção de vídeo animado, motion design ou automação de conteúdo visual usando a plataforma HyperFrames.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/1999AZZAR/designer-mcp/tree/HEAD/skills/video/engine/hyperframes

Perguntar na sua IA favorita

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

Documentação

Ponto de entrada HyperFrames

O HyperFrames renderiza vídeo a partir de HTML — uma composição é um arquivo HTML cujo DOM declara temporização com atributos data-*, cuja runtime de animação é buscável e cuja reprodução de mídia é gerenciada pelo framework. O contrato completo de autoria está em /hyperframes-core; leia-o antes de escrever o HTML da composição. Brief, storyboard, revisão, produção, despacho e contratos de frame-worker estão em references/ deste skill.

1. Iniciar a partir do estado do projeto

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

EstadoAção
Porte explícito de fonte Remotion existente para HyperFramesLeia references/routes/remotion-to-hyperframes.md, depois encaminhe diretamente para esse workflow. Pule a camada de intenção.
Operação específica em um projeto HyperFrames existente: inspecionar, diagnosticar, validar, visualizar, renderizar, publicar ou renderizar em loteExecute apenas essa operação. Pule a camada de intenção e o roteamento de workflow; carregue /hyperframes-cli e quaisquer skills de domínio necessários.
Edição específica em um projeto existenteFaça a edição. Não execute a camada de intenção. Para saber o que está na linha do tempo de um projeto (faixas, clipes, inícios, fins, o que é reproduzido), execute npx hyperframes timeline [--json] em vez de ler index.html e todos os arquivos de sub-composição.
BRIEF.md existeLeia workflow e flow. Execute esse workflow; flow: companion sempre executa em /general-video. Não faça perguntas sobre o brief.
Sem brief, mas hyperframes.json ou STORYBOARD.md existeRetome a partir dos arquivos do projeto e preferências registradas. Infira o workflow proprietário a partir dos artefatos existentes. Se não puder ser determinado de forma única, faça uma única pergunta de roteamento; não execute a entrevista de intenção.
Criação novaExecute a camada de intenção — references/intent-interview.md — depois encaminhe uma vez usando a tabela da § 2.

Se uma solicitação nova não identificar o assunto ou a entrada, pergunte sobre o que é o vídeo antes de rotear. Verifique preferências e receitas antes de perguntar qualquer coisa (references/intent-interview.md, passo 1). Uma entrada figma.com ou uma receita nomeada altera a captação, não o roteamento — a seção "Adaptar entradas ortogonais" da entrevista lida com ambos.

Mantenha o CLI do projeto atualizado

Um projeto scaffolding fixa hyperframes@<versão> nos scripts do seu package.json para que as renderizações permaneçam reproduzíveis; a fixação nunca avança por conta própria, e uma execução fixada de um CLI antigo não imprime aviso sobre isso. Ao retomar um projeto cujos scripts carregam uma fixação, verifique uma vez antes do primeiro comando que afete a renderização:

npx hyperframes@latest upgrade --project . --check

A verificação é somente leitura e reporta a fixação em relação ao lançamento mais recente; mantenha o . explícito — em versões mais antigas do CLI, um --project seguido de outra flag consome essa flag como valor de diretório. Quando reportar que o projeto está atrasado — ou se qualquer saída do CLI já mostrar isso (o aviso stderr This project pins hyperframes@… (latest …), ou _meta.updateAvailable: true em um resultado --json de um script fixado) — aplique com npx hyperframes@latest upgrade --project ., depois verifique com npx hyperframes check. Uma verificação bem-sucedida confirma que as composições do projeto ainda validam na nova versão — não que a saída renderizada seja idêntica em quadro à fixação antiga — portanto, uma atualização bem-sucedida nunca é silenciosa: nomeie a versão antiga e a nova no resumo da execução. Um projeto sem composição ainda não precisa de verificação. Se a verificação falhar, reverta a alteração no package.json, continue na versão fixada e reporte em qual versão o projeto permanece e por quê. Aja com base no sinal em vez de repassá-lo ao usuário; nunca deixe uma fixação atualizada sem verificação.

2. Roteamento para criação nova

Use a primeira linha correspondente. Combine a entrega solicitada, não uma palavra ou tipo de arquivo mencionado de passagem.

PrioridadeSolicitaçãoWorkflow
1Porte explicitamente uma fonte Remotion existente/remotion-to-hyperframes
2Crie uma apresentação, pitch deck ou deck interativo navegável/slideshow
3Adicione legendas ou subtítulos simples a um vídeo de cabeça falante existente sem alterá-lo/embedded-captions
4Adicione sobreposições gráficas projetadas a um vídeo de cabeça falante, entrevista ou podcast existente sem alterar o vídeo/talking-head-recut
5Crie um vídeo sincronizado com batida a partir de uma faixa de música, sem narração ou captura de site/music-to-video
6Crie uma unidade explicitamente curta, sem narração, focada em movimento, geralmente abaixo de 10s/motion-graphics
7Explique um pull request ou alteração de código do GitHub a partir de uma referência de PR/pr-to-video
8Mercadeje ou mostre um site, página de produto, aplicativo ou empresa a partir de uma URL ou brief específico do site/product-launch-video
9Explique um tópico, artigo ou anotações com visuais inventados e sem captura de produto ou site/faceless-explainer
10Qualquer outro vídeo ou composição personalizada/general-video

Antes de finalizar o roteamento, leia references/routes/<workflow>.md — um arquivo pequeno por rota: o contrato canônico de entrada/saída/disparador (disponível antes que os skills de workflow instaláveis sob demanda estejam presentes) mais o ponto de entrada de entrevista dessa rota. Se o candidato não satisfizer seu contrato, continue roteando em vez de forçar a correspondência. Leia apenas o arquivo da rota correspondente.

Resolver ambiguidades comuns

  • Uma cartela animada curta, vinheta de logo, hit de estatística, hit de gráfico, hit de mapa ou terço inferior independente é /motion-graphics quando não tem narração e o movimento é a mensagem. Uma cartela estática, sequência narrada, montagem mais longa ou loop personalizado é /general-video.
  • Um motion graphic explicitamente curto pode usar uma URL, tweet, artigo ou captura de tela como material de origem. Uma solicitação genérica "fazer um vídeo a partir deste site" é /product-launch-video.
  • Um vídeo existente com legendas é roteado para /embedded-captions; vídeo com cartões de informação projetados é roteado para /talking-head-recut. Reajuste de tempo, reordenação, recolorização, reenquadramento ou remixagem de vídeo é uma edição personalizada e cai em /general-video.
  • Um arquivo de música seleciona /music-to-video apenas quando sua grade de batida impulsiona a peça. Música usada como fundo não substitui a rota correspondente ao assunto.
  • "Quero um storyboard" altera o processo de revisão, não o workflow. Sem outro sinal de roteamento, use /general-video. Um storyboard.html esboçado confirmado pode ser a própria entrega solicitada; o loop de revisão define esse ponto de parada.
  • Workflows narrativos especializados suportam até cerca de 3 minutos e são mais fortes entre 30–90s. Rotear uma peça claramente mais longa para /general-video. A duração nunca substitui um porte explícito, deck, legenda, sobreposição ou entrega impulsionada por música.

3. Roteie uma vez, depois saia

Para criação nova, a camada de intenção (references/intent-interview.md) executa a conversa completa — memória, triagem, rodada de pitch, itens obrigatórios, formato de execução, hand-off — e termina escrevendo BRIEF.md. O brief é o único artefato de roteamento que o workflow lê; nada posterior reabre este skill ou a entrevista. Responda a qualquer pergunta posterior "o que a rota exigiu?" a partir de BRIEF.md.

4. Instalar e entrar no workflow

Antes de ler o workflow selecionado, instale-o ou atualize-o junto com os skills de domínio principal:

npx hyperframes skills update <nome-do-workflow>

Use o nome simples sem /. Se o comando falhar, mostre o erro; não reconstrua o workflow de memória. Todo o resto sobre instalação — a divisão core vs. sob demanda, o que init atualiza, diagnóstico, opt-out de CI e fallback sem CLI — está em references/skill-lifecycle.md.

5. Carregar skills de domínio sob demanda

NecessidadeSkill
Estrutura de composição, atributos de temporização, faixas, variáveis, determinismo/hyperframes-core
Regras de movimento, blueprints de cena, transições, adaptadores de runtime/hyperframes-animation
GSAP seguro para busca, CSS, Anime.js, WAAPI, FLIP, paths, máscaras, SVG, keyframes 3D ou diagnósticos hyperframes keyframes/hyperframes-keyframes
Especificações de design, conceito, paleta, tipografia, narração, planejamento de batida/hyperframes-creative
Imagens, ícones, logos, áudio, legendas, gradações, LUTs, mídia reutilizável/media-use
Corte de narração, cadeias de efeitos de áudio, envelopes de automação, ou uma cadeia/fader através de várias faixas (barramento submix)/hyperframes-audio
Init, lint, check, snapshots, compare, renderização em lote, Studio, renderizar, publicar ou diagnósticos/hyperframes-cli
Blocos e componentes do Registry/hyperframes-registry
Um look, efeito, tratamento ou transição nomeada — scanlines CRT, glitch, granulação de filme, varredura brilhante, explosão de confete — ANTES de construir manualmente/hyperframes-registry
Assets, tokens, componentes ou quadros de storyboard do Figma como movimento reconstruído/figma

Frase de edição do criador são solicitações de domínio cruzado. Carregue todos os skills nomeados na linha correspondente:

Solicitação do criadorDomínios necessários
"cortar esta filmagem", corte seco, aparar, emendar, reordenar ou usar um intervalo de origem/general-video + /hyperframes-core; core é dono de data-start, data-duration, data-media-start e layout de faixa.
aumentar zoom aqui, punch-in / punch-out, zoom multi-estado suave ou reenquadramento, Ken Burns, ou movimento de câmera/general-video + /hyperframes-core + /hyperframes-keyframes; anime o invólucro visual/corte interno, não o clipe temporizado.
corte correspondente ou transição de câmera whip pan/general-video + /hyperframes-animation + /hyperframes-keyframes + /hyperframes-registry; procure/instale um primitivo de transição antes de autoria manual.
fade, crossfade, ganho de faixa/volume, automação, duck/corte, efeitos de áudio ou um efeito sobre várias faixas/general-video + /hyperframes-core + /hyperframes-audio; core posiciona clipes, áudio mixa faixas posicionadas — incluindo um barramento submix sobre um grupo delas.
Edições de imagem e som que combinam cortes com movimento de câmera ou mixagem/general-video + /hyperframes-core + /hyperframes-animation + /hyperframes-keyframes + /hyperframes-audio (+ registo se uma transição nomeada for aplicada). A combinação de cortes e movimento de câmera geralmente significa que a câmera e a edição são responsabilidades separadas; a câmera pode se mover dentro de um clipe estático.
Texto animado, tipo cinético, letreiro, gerador de caracteres ou animação de título/general-video + /hyperframes-core + /hyperframes-keyframes + /hyperframes-creative.

6. Fechar a alça de revisão

Após completar uma execução, se o usuário revisar e solicitar alterações:

  1. Faça a alteração diretamente no projeto; não retorne à camada de intenção.
  2. Use os comandos de visualização do CLI para feedback iterativo.
  3. Após cada revisão de conteúdo, se o projeto tiver um storyboard, sincronize o storyboard.

Quando a entrega estiver aprovada, ofereça-se para renderizar e publicar. O usuário pode escolher em qualquer lugar do loop — o prompt não precisa esperar a aprovação final.

Renderização: npx hyperframes render Publicar: npx hyperframes publish

A alça de revisão não reabre a rota de criação nem a camada de intenção

Depois que a criação é roteada e executada, toda interação posterior é específica do domínio. Este skill não deve reavaliar o workflow ou iniciar uma nova entrevista de intenção.

7. Anexar provedor de modelo

Este skill não inclui um provedor de LLM. O arquivo skill.json pode referenciar uma configuração externa, mas toda inferência é tratada pela plataforma do agente (Claude Code, Cursor, Codex, etc.).

Individual skills in this repo

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

1999AZZAR/designer-mcp

SOTA animation and physics heuristic guide using motion.dev

1999AZZAR/designer-mcp

Add captions or subtitles to an existing single-subject talking-head video without editing the footage. Use for plain verbatim captions, cinematic captions embedded behind the subject, VFX captions, “炸/特效/酷炫字幕,” or a named identity from the 35-style catalog. Route by visual identity, not by backend engine. The quiet `anchor` rail is the default; embed every word only when the user explicitly wants a fully cinematic treatment. The workflow runs locally end to end, including transcription and subject matting; split multi-shot footage before applying it.

1999AZZAR/designer-mcp

Turn arbitrary text — an article, notes, a topic, a brief — into a faceless explainer video: there is no site or footage to capture, so the visuals are invented per scene (typography, abstract graphics, diagrams, data-viz). Use for topic explainers, concept breakdowns, how-tos, listicles. Not a video built from a website (/product-launch-video — promo or tour). Unclear → /hyperframes.

1999AZZAR/designer-mcp

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.

1999AZZAR/designer-mcp

Author or edit a custom HyperFrames composition when no specialized workflow fits, or when BRIEF.md sets flow: companion. Use for longer or multi-scene pieces, brand and sizzle reels, montages, static loops, static title cards, footage remixes, and freeform builds. Use motion-graphics instead for a short unnarrated motion-first unit, including an animated title. Route fresh creation through hyperframes before using this skill.

1999AZZAR/designer-mcp

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.

1999AZZAR/designer-mcp

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), automation envelopes drawn on a track's volume or any effect parameter, or one submix bus carrying a chain, a fader and an automation clock for several tracks at once (`<hf-audio-group>`). 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`.

1999AZZAR/designer-mcp

Use the HyperFrames CLI development loop: init, add, catalog, capture, lint, check, snapshot, compare, grade-compare, preview, play, present, beats, keyframes, single or batch render, publish, cloud, cloudrun, feedback, lambda, doctor, browser, info, upgrade, skills, compositions, timeline, docs, benchmark, telemetry, transcribe, auth, tts, and remove-background. Also use when diagnosing build or render failures. validate, inspect, and layout are deprecated aliases; use check. Covers local, HeyGen-hosted cloud, AWS Lambda, and Google Cloud Run rendering.

1999AZZAR/designer-mcp

The HyperFrames composition contract — build one renderable project. Use for composition structure, the `data-*` timing attributes, `class="clip"`, tracks, sub-compositions, variables, framework-owned media playback, deterministic-render rules, and validation. Read before writing composition HTML.

1999AZZAR/designer-mcp

Non-animation creative direction for HyperFrames videos. Use for design spec (frame.md / design.md) handling, palettes, typography, narration, beat planning, audio-reactive visuals, composition patterns, and brand / style decisions. For atomic motion patterns and scene blueprints, use `hyperframes-animation`.

1999AZZAR/designer-mcp

Use when a HyperFrames composition needs a punch-in, punch-out, zoom, reframe, Ken Burns treatment, camera move, visual match/whip handoff, or other seek-safe 2D/3D keyframes; also for GSAP, CSS keyframes, Anime.js, WAAPI, FLIP, paths, masks, SVG morph/draw, text trails, 3D depth, or `hyperframes keyframes` diagnostics. Don't use for broad scene strategy, brand design, media sourcing, captions, or general video planning.

1999AZZAR/designer-mcp

Search, install, and wire registry blocks and components into HyperFrames compositions. Use BEFORE hand-building any named visual — whenever a brief, a user, or a storyboard names a look, effect, treatment, or transition such as CRT scanlines, glitch, chromatic aberration, film grain, a shimmer sweep, a chart, a code or terminal window, a map, or a confetti burst — because roughly 400 hosted items already cover many of them and the search ranks all of them with nothing installed, no project, and no account. Also use when running hyperframes add or hyperframes catalog, installing one item or every block matching a tag, wiring an installed item into index.html, or working with hyperframes.json. Covers discovery, install locations, block sub-composition wiring, component snippet merging, and authoring a new block or component to contribute upstream (idea → scaffold → validate → PR).

1999AZZAR/designer-mcp

Use when building or editing a HyperFrames project that people open in Studio: how the timeline should be laid out so it reads well (one caption track, one element kind per track, every scene a sub-composition) and where captions and key content may sit (safe zones). Don't use for how to perform an individual edit (split, trim, retime, volume, copy, swap): that is `creator-editing-recipes.md` in `/hyperframes-core`.

1999AZZAR/designer-mcp

Agent Media OS, the single skill for every media need in a HyperFrames project. Resolve BGM, SFX, image, icon, brand logo, voice, color grade, or LUT into a frozen local file or paste-ready block + ledger record (one verb, `resolve`); generate via TTS / music / image models when the catalog misses; produce voiceover, transcription, captions, and background removal through one shared audio engine; operate on media (cut / reframe / transform); and reuse assets across projects. Also use for vague feedback that real footage looks dark, flat, boring, should feel retro/camcorder/print/ASCII, needs privacy, or needs a media reveal.

1999AZZAR/designer-mcp

Turn a music track (an audio file, a video to pull audio from, or a track generated from a mood brief) into a beat-synced video — lyric video, slideshow, or kinetic promo. The music drives all pacing; any user-supplied images/videos are cut onto the same beat grid, and a complete video needs zero assets. Narrated pieces → the input-matched workflow (see /hyperframes). Unclear → /hyperframes.

1999AZZAR/designer-mcp

Turn a GitHub pull request (a PR URL, owner/repo#N, or 'this PR' in a checked-out repo) into a code-change explainer video — changelog, feature reveal, fix, or refactor walkthrough built from the diff, commits, and files: the input is a code change, not a website. Not a product promo (/product-launch-video) or a no-PR topic explainer (/faceless-explainer). Unclear → /hyperframes.

1999AZZAR/designer-mcp

Port an existing Remotion (React) composition''s source to HyperFrames HTML. Use ONLY on an explicit ask to port/convert/migrate/translate a Remotion source — one-way, Remotion-only. A passing Remotion mention, reference-only code, or "make something like my Remotion video" is a fresh build (/general-video). Unclear → /hyperframes.

1999AZZAR/designer-mcp

Author a HyperFrames slideshow — a presentation, pitch deck, or interactive deck with discrete slides, fragment reveals, branching, hotspot navigation, and built-in presenter mode with speaker notes; also converts an existing page into a deck. Output is a navigable deck, not a rendered MP4. If the user didn't explicitly ask for a slideshow, confirm before authoring. Unclear → /hyperframes.

1999AZZAR/designer-mcp

Package an existing talking-head / interview / podcast video with timed, designed GRAPHIC OVERLAY cards — kinetic titles, lower-thirds, data callouts, quotes, side panels, picture-in-picture — synced to the transcript, on a 16:9 / 9:16 / 4:5 canvas of your choice; the clip plays untouched underneath. Trigger on "graphic overlays", "on-screen graphics", "package / dress up my video". Not plain subtitles (/embedded-captions). Unclear → /hyperframes.

1999AZZAR/designer-mcp

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.

Habilidades Relacionadas