Communitygithub.com

atilla777/omr

Use ao implementar ou revisar um vídeo OMR a partir de um roteiro e gerar out/video.mp4: montar, renderizar ou exportar o clipe no Remotion, Manim ou híbrido, preparar mídia e verificar o vídeo final. Não é para entrevistas de requisitos, pesquisa de conteúdo, solicitações apenas de roteiro, perguntas genéricas de mídia ou desenvolvimento do OMR em si.

O que é omr?

Este skill automatiza a produção de vídeos do projeto OMR (Open Music Research ou similar), combinando motores como Remotion e Manim para criar animações e renderizações de alta qualidade. Ele gerencia todo o fluxo de trabalho, desde a preparação de recursos de mídia (imagens, áudio, vídeos) até a renderização final em MP4, garantindo que o resultado siga o roteiro e as especificações técnicas (resolução, FPS, duração). O skill depende de dependências técnicas como `remotion-best-practices`, `manim` e `manim-local`, e exige que essas sejam carregadas antes de qualquer operação. Ele também realiza verificações rigorosas no vídeo final, usando ferramentas como ffprobe para confirmar codecs, resolução e sincronização de áudio, e extrai frames para inspeção visual, corrigindo quaisquer defeitos de implementação antes da entrega. É suportado principalmente em plataformas que usam skills do Claude Code ou similares, operando dentro de contextos de projetos OMR.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/atilla777/omr/tree/HEAD/.opencode/skills/omr-render

Perguntar na sua IA favorita

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

Documentação

Produção do Vídeo OMR

Você é responsável pelo resultado da produção do projeto selecionado: fontes dos mecanismos, recursos preparados e out/video.mp4. Comunique-se no idioma do usuário. A chamada /omr-render é uma instrução explícita para obter um MP4, e não apenas abrir uma prévia. Corrija de forma independente os defeitos de implementação dentro do roteiro.

Projeto e Suficiência

No início do trabalho, carregue omr-dialogue através de skill, se ele ainda não estiver carregado no contexto atual, e aplique-o a todos os esclarecimentos. Se a dependência não estiver disponível, informe e alinhe a conexão; sob a liderança, retorne o bloqueador para ele.

Se houver reviews/render.md, leia-o e considere os problemas descritos na produção ou correção. Se o arquivo não existir, não há comentários anteriores de revisão. Não inicie a revisão por conta própria e não altere seu relatório: é uma operação separada. Sob a liderança, retorne as questões significativas para ele, não inicie uma entrevista separada.

  1. Leia os AGENTS.md aplicáveis, a solicitação, requirements.md, script.md, content/index.md e os materiais necessários pelos links. Estude o código existente, configuração e recursos antes das alterações. A subpasta atual do vídeo ou o projeto explicitamente selecionado define o local de trabalho. A raiz da área é determinada pelas regras e estrutura, não apenas pelo .git. Na raiz sem um projeto selecionado, primeiro pergunte sobre a subpasta. Não crie um vídeo na raiz do OMR, um projeto aninhado dentro do selecionado ou um novo .git.
  2. Verifique o modo acordado, tamanho, FPS, duração/número de quadros, cenas, textos, estilo, transições, som/voz, recursos e acordo de inserções híbridas. Materiais equivalentes suficientes são aceitáveis em vez de documentos separados; registre quais entradas foram usadas. Na estrutura padrão, o índice é obrigatório. Não invente conteúdo significativo, design, voz ou modo para o usuário.
  3. Em caso de lacuna/contradição significativa, nomeie-a e esclareça o necessário. Se o resultado anterior estiver ausente, sugira o /omr-requirements, /omr-content ou /omr-script existente correspondente, verificando a presença do comando. Não inicie a etapa anterior e não reescreva seus documentos por conta própria. Não é necessária uma aprovação separada dos documentos atuais suficientes.

Dependências Técnicas Obrigatórias

Antes de criar, modificar, depurar ou renderizar, carregue através de skill:

  • Remotion: remotion-best-practices; leia os guias incorporados sobre criação, marcação, composições e renderização, depois os necessários para as cenas (linha do tempo, mídia, som etc.).
  • Manim: juntos manim e manim-local; o skill local esclarece o ambiente real e substitui conselhos gerais de instalação inadequados. Verifique os caminhos atuais, versão, fontes e disponibilidade de Typst/TeX; não transfira caminhos pessoais para o projeto.
  • Híbrido: ambos os grupos. Você combina seus resultados e verifica a montagem final.

Um skill obrigatório indisponível é um bloqueador do trabalho correspondente: informe e alinhe a conexão. A simples leitura do nome ou arquivo não deve ser apresentada como carregamento via skill. Não substitua a ausência de dependência mudando silenciosamente para outro mecanismo.

Ambiente do Projeto

  • Execute instalações, desenvolvimento e renderização a partir da pasta do vídeo. Crie apenas os diretórios necessários public/, src/remotion/, src/manim/, renders/, out/ e configuração.
  • Instale o Remotion localmente no projeto Remotion e híbrido: versões exatas compatíveis dos pacotes e arquivo lock. Não use node_modules da raiz ou vizinho. Mantenha manifestos/arquivos lock existentes e modifique conforme necessário. Entradas Markdown tornam a pasta não vazia: não execute um modelo que as sobrescreva ou crie uma subpasta extra do vídeo; prepare um projeto mínimo no local.
  • Para Manim puro, use o ambiente existente adequado (na máquina atual, descrito em manim-local, uv tool). Dependências/versão especiais exigem um ambiente local do projeto. Não altere o ambiente geral sem consentimento. Não adicione Remotion, package.json, node_modules para renderização/combinação de som do Manim.
  • Verifique a disponibilidade das CLIs necessárias, codecs, navegador, fontes e mídia. Uma ferramenta ausente deve ser nomeada; alinhe a instalação/acesso, se necessário. Não continue tentativas infinitas de uma operação indisponível. Preserve um resultado útil independente e o comando/erro exato do bloqueador, não declare o MP4 como pronto.

Mídia e Som

Primeiro, liste os recursos das cenas: fornecidos, necessidade de busca, geração ou gravação. Verifique os arquivos reais: tipo, tamanho, duração, orientação, canal alfa, frequência de áudio. Não considere um caminho do roteiro como um arquivo existente.

  • Use os recursos fornecidos. Para imagens externas, vídeos, músicas e efeitos, encontre páginas/diretórios adequados por busca disponível ou webfetch em endereços conhecidos, verifique a fonte e as condições, baixe o arquivo necessário em public/. A mera presença de webfetch não significa que os resultados da pesquisa ou download estão disponíveis. Verifique a resposta real: HTML/erro em vez de imagem não é um recurso pronto.
  • Gere gráficos/som/vídeo com meios locais disponíveis ou serviço conectado dentro da tarefa. SVG programático, desenho, tom e TTS são capacidades diferentes; não prometa geração de imagens/fala apenas porque você sabe escrever código.
  • Para narração pronta, meça a gravação e sincronize as falas com as ações. Para TTS, verifique a ferramenta real, voz/idioma acordados, acesso e custo antes da solicitação. Chaves ausentes/serviço pago devem ser acordados; não grave segredos nos fontes/relatório. Não substitua a voz definida por outra, fala por tom, e mídia obrigatória por espaço reservado.
  • Mantenha em public/assets.md (ou registro existente) os caminhos, finalidade, origem/URL, autor e condições de uso dos arquivos externos; para geração — ferramenta, parâmetros/tarefa e comando de reprodução, quando aplicável. Não apresente recursos de terceiros como MIT OMR, marque condições desconhecidas e esclareça a adequação.
  • Verifique volume, corte, pausas e sincronização. Não estique a fala e não altere textos/duração significativos sem discussão. Para vídeo mudo, não adicione música. Em caso de recurso obrigatório indisponível, informe o bloqueador exato e solicite o arquivo/acesso ou alinhamento de substituição; a implementação independente pode ser explicitamente parcial.

Implementação

Siga o roteiro; detalhes técnicos devem ser especificados dentro do design aceito. Antes de correções, considere as alterações do usuário. A execução repetida altera apenas o resultado solicitado; não atualize automaticamente os requisitos, conteúdo ou roteiro.

Remotion

Implemente a composição e as cenas em src/remotion/ com o tamanho, FPS e quadros definidos. As animações devem depender do quadro, e não de relógios/animações CSS. Use os guias técnicos para composição, linha do tempo, mídia e som. Forneça mídia de public/ via API suportada; aguarde o carregamento de fontes/recursos. Verifique a compilação e prévia, onde disponível; indique a ausência de visualização no navegador. Exporte MP4 para out/video.mp4, não termine apenas no Studio. Registre o comando exato para nova renderização.

Manim CE Independente

Implemente a Scene em src/manim/; compare as durações de play/wait com os quadros do roteiro. Use o mecanismo de texto/matemática funcional dos skills carregados. Primeiro, renderize e visualize PNGs característicos/um rascunho curto, depois o vídeo completo com os parâmetros necessários, definindo explicitamente FPS/tamanho em vez de predefinições de qualidade inadequadas. Direcione os arquivos intermediários para renders/. Copie/combine o resultado final em out/video.mp4. Adicione som por meio do Manim ou combinação disponível, por exemplo FFmpeg, sem Remotion. Não use -shortest de forma a cortar invisivelmente a duração definida do vídeo.

Híbrido

Primeiro, obtenha as inserções do Manim em renders/ e verifique seus parâmetros e quadros. Prepare cópias disponíveis para compilação em public/; depois monte o resultado no Remotion. Verifique a correspondência dos quadros locais da inserção com a linha do tempo global, FPS, tamanho, proporções/corte, cor de fundo ou suporte real de transparência pelo formato. H.264 MP4 comum não tem alfa. Não estique a inserção, não duplique som/legendas. Em caso de incompatibilidade, corrija a implementação dentro do acordo; mudança significativa de conteúdo, design ou modo deve ser discutida, e não introduzida silenciosamente.

Verificação e Entrega

Codificação bem-sucedida é apenas parte da verificação. Use as ferramentas disponíveis, e não resultados de visualização fictícios. Registre em renders/verification.md (ou relatório de projeto existente) as entradas, versões, comandos, parâmetros, pontos de visualização, correções e verificações não realizadas.

  1. Verifique a compilação/renderização e decodificação do MP4 final; meça codecs, resolução, FPS, duração/quadros e fluxos de áudio, por exemplo via ffprobe. Compare com o roteiro, considere a duração dos pacotes de áudio separadamente dos quadros de vídeo.
  2. Extraia quadros reais do MP4 final: início, ações/textos principais, fim, quadros antes/depois de cada emenda e dentro das transições. Abra o PNG com uma ferramenta de visualização de imagens disponível, verifique legibilidade, fórmulas, campos, corte, sobreposições, mídia ausente e saltos de cor. Uma folha de contato ajuda a cobrir a linha do tempo; para movimento, visualize a sequência/vídeo, se disponível. PNG de uma renderização still separada não substitui a verificação do MP4 final e suas emendas.
  3. Se o som for previsto, verifique não apenas o fluxo: duração, intervalos de sinal/ silêncio, níveis e correspondência de eventos com as cenas. Ouça o resultado por um meio disponível. Se a audição não estiver disponível, indique isso explicitamente, separando a sincronização/níveis medidos da inteligibilidade e qualidade não verificadas de ouvido. Para vídeo mudo, verifique a ausência de som não previsto.
  4. Corrija os defeitos de implementação encontrados e repita as verificações afetadas. Alterações significativas no roteiro/modo exigem decisão do usuário. Não declare o resultado como completamente verificado se a verificação obrigatória não estiver disponível; liste o que foi feito e o restante/bloqueador específico.

Informe o caminho real para out/video.mp4, fontes e relatório, o comando para nova renderização, os principais parâmetros e limitações. Em caso de falha na gravação, forneça o resultado explicitamente não salvo; em caso de bloqueador, o status parcial exato; não apresente MP4 antigo como novo. Pare após a produção e verificação. Não publique, não faça commit/push e não inicie outras etapas sem instrução separada.

Individual skills in this repo

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

Habilidades Relacionadas