Communitygithub.com

Manavv007/S.A.R.A.L.-Camada-de-Acesso-Recuperação-Análise-e-Lay…

Fluxo de trabalho fallback para criar composições de vídeo HyperFrames personalizadas em qualquer duração ou formato — peças longas ou com várias cenas, reels de marca/sizzle, montagens, cartões de título, loops estáticos e composições livres. Agnóstico a entrada e duração. Se um workflow especializado se encaixar claramente na entrada — um produto comercializado, um site, um explicador de tópico, um PR do GitHub, filmagem existente, um motion graphic curto ou uma portabilidade do Remotion — prefira-o (veja /hyperframes); use este apenas como fallback geral quando nenhum se encaixar.

O que é S.A.R.A.L.-Camada-de-Acesso-Recuperação-Análise-e-Lay…?

Este skill, S.A.R.A.L., é o workflow fallback geral para autorar composições de vídeo HyperFrames quando nenhum workflow especializado se aplica. Ele lida com qualquer formato de vídeo — peças longas ou com várias cenas, reels de marca, montagens, cartões de título, loops estáticos e composições livres — e é agnóstico ao tipo de entrada e duração. O fluxo de trabalho prioriza a compreensão da intenção do usuário, definindo um sistema de design e um ângulo conceitual antes de codificar, seguindo uma abordagem estruturada de 'layout antes da animação' para evitar problemas de sobreposição. Ele também gerencia áudio (TTS, BGM, SFX) através de um motor unificado, garantindo que o resultado final seja um vídeo coeso e polido. A habilidade é compatível com todas as plataformas que suportam HyperFrames (agentes de IA como Claude Code, Cursor, Codex) e se integra profundamente com skills auxiliares como hyperframes-creative, hyperframes-animation e hyperframes-media. Sua força está em fornecer um processo consistente e orientado por design para projetos de vídeo arbitrários, evitando decisões ad-hoc e garantindo resultados com aparência profissional.

Funciona com~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/Manavv007/S.A.R.A.L.-Scheme-Access-Retrieval-Analysis-Layer-/tree/HEAD/.agents/skills/general-video

Perguntar na sua IA favorita

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

Documentação

media-use: Antes de buscar áudio/imagens, chame /media-use para resolver BGM/SFX/imagens do catálogo HeyGen. Execute --adopt primeiro para registrar ativos existentes. Veja o skill /media-use.

geral-video — workflow geral de vídeo

Confirme a rota antes de construir. Este é o fallback para criação de composição personalizada. Se a entrada claramente se encaixa em um workflow especializado, prefira-o: produto comercializado → /product-launch-video; site geral → /website-to-video; explicador de tópico → /faceless-explainer; PR do GitHub → /pr-to-video; filmagem existente → /embedded-captions · /talking-head-recut; motion graphic curto sem narração → /motion-graphics; portabilidade Remotion → /remotion-to-hyperframes. Fora do escopo: dados ao vivo / em tempo de renderização, edição estilo NLE de um vídeo finalizado ou produção de filmagens que o HyperFrames não pode capturar. Não tem certeza? Leia /hyperframes primeiro.

Construa exatamente o que foi pedido. Um cartão de título é um cartão de título — não um cartão de título + três cenas de suporte + música ambiente + legendas. Se cenas ou elementos extras realmente melhorariam a peça, proponha-os; não os adicione silenciosamente. Para pequenas edições (corrigir uma cor, ajustar uma duração, adicionar um elemento), pule as etapas de planejamento e vá direto para a construção.

Abordagem

Descoberta — apenas solicitações abertas

Para solicitações vagas e exploratórias ("faça algo para nossa marca", "uma introdução legal") — entenda a intenção antes de escolher cores:

  • Público — quem assiste? desenvolvedores / executivos / consumidores em geral?
  • Plataforma — onde é reproduzido? social (15s) / hero do site / demonstração de produto / interno?
  • Prioridade — o que importa mais? qualidade do movimento / precisão do conteúdo / fidelidade à marca / velocidade?
  • Variações — uma melhor versão ou 2-3 opções significativamente diferentes (ritmo, energia ou estrutura diferentes — não apenas trocas de cor)?

Para solicitações específicas ("adicione um cartão de título", "corrija o tempo na cena 3"), pule a descoberta.

Etapa 1 — Sistema de design → hyperframes-creative

Estabeleça a identidade visual primeiro. Se o projeto tem uma especificação de design, leia-a (precedência frame.md → design.md → DESIGN.md; trate-a como verdade da marca — cores exatas, fontes, restrições).

Se não houver especificação, você DEVE ler AMBOS hyperframes-creative/references/house-style.md E hyperframes-creative/references/video-composition.md antes de escolher qualquer cor ou fonte. house-style.md fornece a abertura "interprete o prompt / gere conteúdo real", lista de padrões preguiçosos e receita de camadas; video-composition.md fornece a densidade / escala / detalhamento de primeiro plano (barras de dados, marcas de registro, metadados monoespaçados, "8-10 elementos, dois que o usuário não pediu") que separa "produzido" de "gerado." Ler apenas um é o erro mais comum — video-composition.md é o que os agentes pulam, e é exatamente o que impede saída plana, centralizada e com aparência de página da web. Não invente uma paleta e pule estes; cruzar para hyperframes-creative é obrigatório aqui, não uma ramificação opcional. A partir daí, também puxe um estilo/clima nomeado → references/visual-styles.md, ou o seletor interativo → references/design-picker.md, conforme necessário. A especificação/estilo define a marca, não as regras de composição.

Encontre o ângulo (briefing vago, sem especificação): antes de escolher cores, escreva UMA frase — o que este nome/palavra/tópico evoca, e qual mundo visual (metáfora, cenário, instrumento, motivo) o expressa? Ex.: uma ferramenta de cibersegurança → portas de cofre / linhas de varredura de perímetro / cilindros de fechadura; um app de meditação → maré, respiração, lenta explosão de luz. Leia o significado do assunto, não apenas suas letras; escolha um ângulo concreto em vez de uma reformulação literal. Este é o substituto barato para a expansão de prompt (Etapa 2) em peças de cena única, onde a expansão é corretamente pulada — e é a diferença entre um conceito projetado e um logotipo genérico sobre um gradiente.

Etapa 2 — Expansão de prompt → hyperframes-creative

Execute para toda composição com várias cenas (pule para peças de cena única e edições triviais). Fundamente a solicitação contra a especificação de design + estilo da casa em um intermediário consistente que o trabalho downstream leia da mesma forma. Veja hyperframes-creative/references/prompt-expansion.md.

Etapa 3 — Plano

Antes de escrever HTML, pense em alto nível:

  1. O quê — a experiência do espectador: arco narrativo, momentos-chave, batidas emocionais.
  2. Estrutura — quantas composições, sub-comp vs inline, quais trilhas carregam vídeo / áudio / sobreposições / legendas. Para a decisão de arquivo monolítico vs sub-comp modular, veja hyperframes-core/references/composition-patterns.md § Duas Arquiteturas (regra prática: ≥3 cortes de cena fortes, ou qualquer cena reutilizada → modularize; uma peça curta de cena única permanece em um arquivo).
  3. Ritmo — nomeie o padrão antes de implementar (ex.: fast-fast-SLOW-SHADER-hold); veja hyperframes-creative/references/beat-direction.md.
  4. Tempo — quais clipes determinam a duração, onde as transições ocorrem, o ritmo.
  5. Layout — construa o estado final primeiro (veja abaixo).
  6. Animar — depois adicione movimento via hyperframes-animation.

Layout Antes da Animação

Posicione cada elemento onde ele fica em seu momento mais visível — totalmente entrado, colocado corretamente, ainda não saindo. Escreva isso como HTML + CSS estático primeiro. Ainda sem GSAP.

Por quê: se você posicionar elementos em seu estado inicial animado (fora da tela, escalados para 0, opacidade 0) e animar para onde acha que eles vão parar, você está adivinhando o layout final — sobreposições permanecem invisíveis até a renderização. Construa o estado final primeiro e você vê e corrige problemas de layout antes de adicionar movimento.

  1. Identifique o quadro herói para cada cena — o momento em que o maior número de elementos está simultaneamente visível. Esse é o layout que você constrói.
  2. Escreva CSS estático para esse quadro. O contêiner de conteúdo deve preencher a cena com preenchimento, não deslocamentos absolutos:
.scene-content {
  display: flex;
  flex-direction: column;
  justify-content: center;
  width: 100%;
  height: 100%;
  padding: 120px 160px; /* preenchimento posiciona o conteúdo; preenche qualquer tamanho de cena */
  gap: 24px;
  box-sizing: border-box;
}

Nunca use position: absolute; top: Npx em um contêiner de conteúdo — ele transborda quando o conteúdo é mais alto que o espaço. Reserve o posicionamento absoluto para elementos decorativos.

⚠ O width/height: 100% acima só resolve se todo ancestral tiver uma altura resolvida. O <div data-composition-id> raiz e qualquer wrapper entre ele e .scene-content devem ser dimensionados (position: relative; width: 1920px; height: 1080px na raiz — veja hyperframes-core → "A raiz deve ser dimensionada"). Pule isso e o contêiner flexível colapsa para ~0, o conteúdo se acumula no canto superior esquerdo, e o primeiro glifo corta em x=0 — enquanto lint/inspect ainda relatam 0 problemas. E sempre mantenha o padding (≥80px) em .scene-content: é a margem de segurança do título. Nunca o substitua por gap puro.

  1. Adicione entradas — anime DE fora da tela/invisível PARA a posição CSS com gsap.from() (em sub-composições prefira gsap.fromTo() para que o estado inicial seja explícito; veja hyperframes-core/references/sub-compositions.md). A posição CSS é a verdade fundamental; a animação é a jornada até ela.
  2. Saídas são tratadas por transição — de acordo com as regras de transição de cena em hyperframes-animation/transitions/, apenas a cena final anima os elementos para fora; entre cenas a transição É a saída.

Espaço compartilhado ao longo do tempo: se o elemento A sai antes do elemento B entrar na mesma área, ambos ainda precisam de posições CSS corretas para seus respectivos quadros herói — a ordenação da linha do tempo impede que coexistam, e a etapa de layout detecta sobreposição acidental. Brilhos/sombras em camadas e profundidade empilhada em z são sobreposição intencional; a etapa é detectar colisões não intencionais (dois títulos um em cima do outro, conteúdo vazando para fora do quadro).

Construir — delegar para os skills de domínio

Isso mapeia a superfície completa do skill (veja a description) para suas referências — não exaustivo; quando uma intenção não estiver listada, encaminhe através de hyperframes-creative (aparência/conceito), hyperframes-animation (movimento), hyperframes-core (contrato), hyperframes-media (áudio/legendas). A primeira linha é ADITIVA — leia-a E sua linha de intenção, não uma ou outra.

Construindo…Leia primeiro (em ordem)
SEMPRE — toda peça não trivial, além da sua linha de intenção abaixohyperframes-creative/references/house-style.md + references/video-composition.md (também verificado na Etapa 1 / HARD-GATE; o detalhamento de primeiro plano "produzido, não gerado")
Tipografia cinética / foco em textohyperframes-animation/techniques.md (tipo cinético) + adapters/gsap-easing-and-stagger.md + rules/kinetic-beat-slam.md
Cartão de título / terço inferior / sobreposição / PiP / texto atrás do sujeitohyperframes-creative/references/composition-patterns.md + (para o quadro centralizado/dimensionado) hyperframes-core → "A raiz deve ser dimensionada"
Revelação de logotipo / marcahyperframes-animation/rules/svg-path-draw.md (desenho) + rules/3d-text-depth-layers.md + rules/scale-swap-transition.md
Dados / estatísticas / númeroshyperframes-animation/rules/counting-dynamic-scale.md + rules/stat-bars-and-fills.md + hyperframes-creative/references/data-in-motion.md
Produto / app / demonstração de UIhyperframes-animation/rules/3d-page-scroll.md + rules/cursor-click-ripple.md + rules/press-release-spring.md
Áudio-reativo / conduzido por músicahyperframes-creative/references/audio-reactive.md (pré-extrair bandas; mapear para movimento)
Narrado / voz sobreposta / música / SFX / legendashyperframes-media → o motor de áudio compartilhado scripts/audio.mjs (uma chamada = TTS + BGM + SFX → audio_meta.json); criação de legendas + posicionamento de ativos via hyperframes-core. Veja Áudio abaixo.
Várias cenas / transiçõeshyperframes-animation/transitions/overview.md depois transitions/catalog.md (você não terminou após a visão geral — a receita GSAP está no catálogo)
Modular / sub-composiçõeshyperframes-core/references/composition-patterns.md + references/sub-compositions.md

Áudio: um motor (TTS · BGM · SFX)

Apenas quando a peça exigir (de acordo com "construa exatamente o que foi pedido" — sem música ambiente em um cartão de título). Não crie TTS manualmente ou use uma cópia de terceiros: escreva um audio_request.json neutro e chame o motor compartilhado em hyperframes-media. Ele se degrada automaticamente em um switch — credencial HeyGen presente → TTS HeyGen + recuperação de música/SFX; ausente → TTS ElevenLabs/Kokoro, geração de BGM Lyria/MusicGen e a biblioteca SFX agrupada. Lista completa de flags + esquema de requisição/meta: o comentário de cabeçalho de hyperframes-media/scripts/audio.mjs.

// audio_request.json — uma linha por segmento narrado; `id` é seu (junta audio_meta de volta)
{
  "lines": [
    { "id": "s1", "text": "Sua linha de abertura.", "sfx": ["whoosh"] },
    { "id": "s2", "text": "A próxima batida." },
  ],
  "bgm": { "query": "calm cinematic underscore" }, // omita "mode" → auto (recuperar se HeyGen, senão gerar); "none" para desabilitar
}
# <MEDIA_DIR> = o diretório do skill hyperframes-media instalado (irmão deste skill)
node <MEDIA_DIR>/scripts/audio.mjs --request ./audio_request.json --hyperframes . --out ./audio_meta.json

Em seguida, leia audio_meta.json: monte cada voices[].path + (bgm.path, sfx[]) como trilhas <audio> e use voices[].words para legendas, tudo de acordo com hyperframes-core (trilhas de áudio + criação de legendas). Se o BGM seguiu o caminho de geração (bgm_pending: true), execute hyperframes-media/scripts/wait-bgm.mjs antes da renderização final.

Lista de verificação de saída → hyperframes-cli

Individual skills in this repo

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

Manavv007/S.A.R.A.L.-Scheme-Access-Retrieval-Analysis-Layer-

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). HyperFrames-native: single paused timeline, seek-safe, deterministic.

Manavv007/S.A.R.A.L.-Scheme-Access-Retrieval-Analysis-Layer-

HyperFrames CLI dev loop. Use when running npx hyperframes init, add, catalog, capture, lint, validate, inspect, layout, snapshot, preview, play, render, publish, lambda, doctor, browser, info, upgrade, skills, compositions, docs, benchmark, telemetry, transcribe, tts, or remove-background, or when troubleshooting the HyperFrames build/render environment. Entry point for AWS Lambda cloud rendering (`hyperframes lambda deploy / render / progress / destroy / policies`).

Manavv007/S.A.R.A.L.-Scheme-Access-Retrieval-Analysis-Layer-

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.

Manavv007/S.A.R.A.L.-Scheme-Access-Retrieval-Analysis-Layer-

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`.

Manavv007/S.A.R.A.L.-Scheme-Access-Retrieval-Analysis-Layer-

Capture a general website/URL and turn it into a HyperFrames video (site tour, showcase, or social clip from the site's own visuals). Uses headless Chrome screenshots + brand assets. Use when intent is general — portfolio/blog/landing-page showcase or social clip from the site. NOT for: product/SaaS launch or promo (→ /product-launch-video, even from a URL); topic explainer with no site (→ /faceless-explainer); GitHub PR (→ /pr-to-video); adding captions to existing video (→ /embedded-captions); short unnarrated page-highlight motion graphic (→ /motion-graphics). Unclear launch-vs-general-site? Ask one question or start at /hyperframes.

Manavv007/S.A.R.A.L.-Scheme-Access-Retrieval-Analysis-Layer-

Audio and media assets for HyperFrames compositions, produced by one shared audio engine (`scripts/audio.mjs`) — multi-provider TTS (HeyGen / ElevenLabs / Kokoro local), background music + sound effects (HeyGen audio-library retrieval by default, with local Lyria / MusicGen BGM generation and a bundled SFX library as the no-credential fallback), Whisper transcription, background removal, and caption authoring. Use for voiceover / TTS, BGM, SFX / sound effects, transcription, captions / subtitles / lyrics / karaoke / per-word styling, voice + provider selection, and music-mood prompting.

Manavv007/S.A.R.A.L.-Scheme-Access-Retrieval-Analysis-Layer-

S.A.R.A.L. is an advanced AI-powered platform designed to bridge the "information gap" between rural Indian citizens and government welfare. While thousands of schemes exist, the complex language of official PDFs often makes them inaccessible to the common man.

Habilidades Relacionadas