Communitygithub.com

Zuhair-01/claude-skills-and-systems

Crie ou edite uma composição HyperFrames personalizada quando nenhum workflow especializado se encaixa, ou quando BRIEF.md define flow: companion. Use para peças longas ou com múltiplas cenas, reels de marca e sizzle, montagens, loops estáticos, cartões de título estáticos, remixes de filmagens e construções livres. Use motion-graphics para uma unidade curta e sem narração focada em movimento, incluindo um título animado. Crie novas peças através de hyperframes antes de usar esta skill.

O que é claude-skills-and-systems?

Esta skill para agentes de IA (como Claude Code, Cursor, ou Codex) gerencia a criação e edição de composições HyperFrames personalizadas quando nenhum workflow especializado se aplica. Ela suporta tanto fluxo autônomo (automation) quanto colaborativo (companion), com base no arquivo BRIEF.md. A skill orienta o agente através de um pipeline completo: desde a verificação de atualizações, carregamento de adaptadores de mídia e Figma, interpretação do estado do projeto (brief, storyboard, ou criação nova), até a execução da composição com planos, design de movimento e revisões. Ela é ideal para projetos que exigem flexibilidade total, como montagens, reels, loops animados ou edições específicas, garantindo que o agente siga as regras de contrato e use as referências corretas para cada etapa.

Funciona com✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/Zuhair-01/claude-skills-and-systems/tree/HEAD/skills/general-video

Perguntar na sua IA favorita

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

Documentação

Vídeo geral

Antes de confiar neste workflow, execute:

npx hyperframes skills update general-video

Um no-op bem-sucedido significa que a skill está atualizada. Relate uma falha de atualização em vez de continuar com base na memória.

1. Aplicar adaptadores de fonte transversais

  • Mídia: Para qualquer necessidade de áudio, imagem, ícone, logotipo, voz, grade, 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 filmagens 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 o bloqueio em ../hyperframes/references/brief-contract.md: colaborativo aguarda login ou uma escolha explícita de offline; autônomo informa o status e continua através de um provedor offline disponível. Relate um bloqueio quando nenhum provedor offline puder satisfazer uma capacidade obrigatória. A adoção local sozinha não requer bloqueio 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 SVG, a proveniência de mídia e a vinculação de tokens de marca.

Estes adaptadores não alteram o workflow 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 workflow e flow não for companion, passe adiante. 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 com 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 faça o scaffold 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/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 da skill /media-use instalada 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 da execução

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

CampoSignificadoEfeito
flowQuem dirigeautomation: escolha e execute a rota. companion: cocrie em conversa.
storyboardPlanejar, esboçar e revisar antes da construçãoyes: execute o plano e a revisão do esboço (storyboard.html). no: construa sem ele.
mode derivadoComo os portões de checkpoint se comportamSiga o contrato do brief. Nunca peça ao usuário para nomear um modo.

Não invente sinônimos para estes 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 duro, corte, emenda ou reordenação de filmagens existentes, 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 e, em seguida, defina a colocação/ordem de autoria com data-start. Áudio com autoria separada segue os intervalos de clipe idênticos e o tempo em elementos <audio> correspondentes. /hyperframes-core é dono desta edição temporal; use /hyperframes-keyframes apenas para animação de propriedade visual, como zoom, soco, panorâmica, corte, máscara ou clip-path em um wrapper interno. Copie os contratos completos de ../hyperframes-core/references/creator-editing-recipes.md.

Fluxo companion

Quando flow: companion:

  • Leia BRIEF.md e reconcilie os ## 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 como o empreiteiro. Um usuário que escolheu companion 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 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 do plano), as transições, a identidade do á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, faturamento) ao nomeá-las. O usuário reduz 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 maneira é decoração. O ofício sobe ao teto; o conteúdo nunca cresce além do que foi pedido (§ 6).
  • Entre checkpoints, ../hyperframes/references/capability-menu.md funciona de duas maneiras. Como a lista de gatilhos: ofereça uma capacidade relevante quando o usuário mencionar sua entrada ou a construção atingir sua necessidade. Como o canal de atualização de cada passagem: um plano, esboço ou checkpoint de 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 completo.
  • 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 portões de storyboard, validação, pré-visualização final e aprovação de renderização. Companion 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 corresponde:

CondiçãoLeitura 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/references/storyboard-format.md e ../hyperframes/references/review-loop.md
Qualquer ativo ou operação de mídia, incluindo narração, BGM, SFX, legendas, classificação ou transformações/media-use; para reprodução e posicionamento no framework, leia também /hyperframes-core → references/variables-and-media.md
Montagem de múltiplas cenas../hyperframes/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 completo ../hyperframes/references/capability-menu.md — o tratamento teto é projetado a partir destes, não lembrado
Uma oferta de capacidade companion, captura, grade de batida, vídeo generativo, mapa, publicação ou capacidade de cross-workflow../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 estas leituras por lembranças. 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 curta única; use sub-composições para três ou mais cortes duros 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/composition-patterns.md para estrutura. Para um brief de múltiplas cenas aberto, expanda o prompt através de /hyperframes-creative → references/prompt-expansion.md. Um plano de múltiplas 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 compõe de rules-index.md quando nenhum se encaixa — os nomes de movimento vêm desses índices, nunca inventados. A verdade da história decide quais cenas existem; a citação as veste. Pesquise o catálogo ativo antes de planejar construir qualquer visual nomeado por conta própria: para cada visual, efeito, tratamento ou transição que o brief nomeia — "scanlines CRT", "glitch", "grão de filme", "varredura cintilante", "explosão de confete" — execute npx hyperframes catalog --query "<o visual, em inglês simples>" --json e leia os principais resultados antes que o plano nomeie como esse visual será construído. A pesquisa não precisa de nada instalado: nenhum projeto, nenhum add anterior, nenhuma conta. Ela classifica todo o registro hospedado (~400 blocos e componentes) de qualquer diretório, portanto, também se aplica a um visual que o usuário pede no meio da construção. Blocos que o plano nomeia são instalados no estágio 3; crie manualmente um visual apenas após uma pesquisa por ele retornar nada que se encaixe. Um plano de múltiplas cenas também é registrado como o artefato de despacho: um bloco ## Quadro 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; a folha de storyboard é apenas a superfície de revisão.
  2. Revisar o plano quando solicitado. Para storyboard: yes, execute o loop de revisão compartilhada sobre esses blocos. Para storyboard: no, continue sem uma pausa de plano ou folha de esboço. Quando uma pausa de plano acontecer de qualquer forma, incorpore a concessão de delegação de subagente (necessária pelo codex para o despacho da etapa 4) nessa pausa, em vez de parar novamente mais tarde.
  3. Resolver dependências. Instale blocos de registro antes do trabalho paralelo. Prepare ativos do usuário, adote existentes...

... [truncado para tradução]

Individual skills in this repo

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

Zuhair-01/claude-skills-and-systems

Create AI avatar videos with precise control over avatars, voices, scripts, scenes, and backgrounds using HeyGen's v2 API. Use when: (1) Choosing a specific avatar and voice for a video, (2) Writing exact scripts for an avatar to speak, (3) Building multi-scene videos with different backgrounds per scene, (4) Creating transparent WebM videos for compositing, (5) Using talking photos as video presenters, (6) Integrating HeyGen avatars with Remotion, (7) Batch video generation with exact specs, (8) Brand-consistent production videos with precise control.

Zuhair-01/claude-skills-and-systems

Generate Mandarin and multilingual narration with Volcengine Doubao Speech 2.0. Use when creating Chinese voiceovers, when the user prefers Doubao/Volcengine/火山引擎/豆包 TTS, or when narration needs character-level timestamp metadata for subtitles.

Zuhair-01/claude-skills-and-systems

Edit existing videos using AI — remix style, upscale, remove background, and add audio via fal.ai's hosted video models.

Zuhair-01/claude-skills-and-systems

Video and audio processing with FFmpeg. Use for format conversion, resizing, compression, audio extraction, and preparing assets for Remotion. Triggers include converting GIF to MP4, resizing video, extracting audio, compressing files, or any media transformation task.

Zuhair-01/claude-skills-and-systems

Read-only queue dashboard for workspace-aware ship. (gstack)

Zuhair-01/claude-skills-and-systems

Generate HeyGen presenter videos via the v3 Video Agent pipeline — handles Frame Check (aspect ratio correction), prompt engineering, avatar resolution, and voice selection. Required for any HeyGen video generation. Replaces deprecated endpoints with v3. Use when: (1) generating any HeyGen video (via API or otherwise), (2) sending a personalized video message (outreach, update, announcement, pitch, knowledge), (3) creating a HeyGen presenter-led explainer, tutorial, or product demo with a human face, (4) "make a video of me saying...", "send a video to my leads", "record an update for my team", "create a video pitch", "make a loom-style message", "I want to appear in this video", "generate a HeyGen video", "make a talking head video". Accepts avatar_id from heygen-avatar for identity-first HeyGen videos, or uses a stock presenter. Returns video share URL + HeyGen session URL for iteration. Chain signal: when the user wants to create/design an avatar AND make a video in the same request, run heygen-avatar f...

Zuhair-01/claude-skills-and-systems

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.

Zuhair-01/claude-skills-and-systems

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.

Zuhair-01/claude-skills-and-systems

Generates high-converting Next.js/React landing pages with Tailwind CSS. Uses PAS, AIDA, and BAB frameworks for optimized copy/components (Heroes, Features, Pricing). Focuses on Core Web Vitals/SEO.

Habilidades Relacionadas