Communitygithub.com

Fallonwong/piano-remotion

Crie vídeos de partituras de piano com saltos originais de duas mãos, rastros brilhantes e câmera. Revise revisões de notação, reutilize ferramentas de áudio amostradas e pare para aprovação da partitura, depois para aprovação real de keyframe/audição antes de exportar.

O que é piano-remotion?

Esta skill permite criar vídeos de partituras de piano animados, preservando os movimentos originais das duas mãos, rastros de brilho e movimentos de câmera. Ela é projetada para uso com agentes de IA como Claude Code, Cursor ou Codex, e se integra ao framework Remotion para renderização. A skill impõe um processo rigoroso de duas etapas de aprovação: primeiro, a notação musical deve ser revisada e aprovada pelo usuário; em seguida, os keyframes e a audição do áudio devem ser aprovados antes da exportação final. Ela suporta reconhecimento de partituras a partir de PDFs, imagens ou arquivos MusicXML/MIDI, e usa ferramentas como MuseScore Basic para sintetizar áudio. A skill prioriza a reutilização de ambientes existentes e dá ênfase à transparência, exigindo que o agente solicite permissão do usuário antes de instalar novos softwares ou baixar arquivos grandes, e que documente todas as evidências e correções realizadas durante o processo.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add Fallonwong/piano-remotion

Perguntar na sua IA favorita

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

Documentação

Piano Remotion — V1.0.0

Leia primeiro as remotion-best-practices oficiais instaladas. Reutilize ambientes autorizados compatíveis; Python/OMR são opcionais. Primeiras instalações ou grandes downloads exigem caminhos, versões, conteúdo, tamanho/motivo e permissão do usuário. Preserve fontes privadas, overlays pessoais desativados, visuais originais de ScoreNoteLeap/PianoScoreScene. Nenhuma licença foi atribuída.

Use node <skill>/scripts/piano.mjs. Leia o fluxo de trabalho de áudio e reconhecimento para áudio ou PDF/imagens; o fluxo de trabalho de geometria e renderização documenta geometria e mecânicas de palco existentes. Para reutilização e instalação em tempo de execução, veja configuração do ambiente. Use evidências de produção e argumentos de auditoria de notação com esses comandos. Não use chamadas Demo legadas como conclusão de música verificada.

Execute a tarefa com duas paradas de revisão de conteúdo

  1. Descobrir/classificar. Reutilize o projeto atual e ferramentas compatíveis explicitamente autorizadas. PATH ausente ou tempo limite de sonda não é evidência de ausência. MusicXML/MIDI confiáveis têm prioridade sobre o reconhecimento repetido. Imagens de pauta/PDF preferem OMR profissional instalado; ferramentas ausentes produzem opções, não transcrição inventada. Jianpu requer interpretação explícita de tom/oitava/ritmo. Nunca escreva silenciosamente um reconhecedor por música ou simplifique vozes.
  2. Preparar e revisar a notação. Retenha MusicXML editável, semântica real de altura/duração/métrica/pausa/acorde/voz/pauta/barra/ligação/legato. Verifique cortes originais/refeitos para cada compasso; barras balanceadas não são correção. notation-audit adiciona diferenças de revisão, compassos piloto densos/conectados/polifônicos e dúvidas baseadas em evidências. Use --previous após correções e --expected-measures quando um usuário identificar uma alteração limitada. Mostre alterações inesperadas; não redefina música já correta para edições de câmera. Novo score-request para PDF/imagem requer --notation-audit. Mostre cortes/diferenças/dúvidas, retorne WAITING_FOR_SCORE_APPROVAL e ENCERRE O TURNO. A auto-revisão do agente não pode aprovar.
  3. Registrar consentimento real do usuário. Cite as palavras reais do usuário com o requestId/mensagem de referência exibidos ou use a resposta da página de revisão deles. Nunca fabrique ator=usuário ou aprovação. A resposta da partitura registra fornecido/sintetizado/silencioso; a escolha de áudio gerado não aprova timbre não visto. JSON local vincula versões, não identidade humana.
  4. Produzir a música/áudio aprovado. Preserve a animação original e a geometria SVG nativa. Ligações de mesma altura soam uma vez durante toda a duração; alturas ligadas por legato permanecem separadas; barras não são ligações. Descubra com audio-plan: gravação do usuário primeiro, depois mecanismo/fonte amostrados existentes. audio-render exporta o XML aprovado completo através do MuseScore Basic verificado; audio-master grava ganho/padding global explícito e protege caudas de liberação audíveis. Novo bind verificado precisa de --audio-evidence. Não registre formas de onda geradas pelo agente como gravações de usuário. O synthesize --preview-only integrado é apenas um rascunho de calibração; nunca substitua áudio de produção por osciladores personalizados apenas para passar no alinhamento.
  5. Mostrar keyframes reais e audição. Use o mesmo master/props/job final da música completa para visualização/exportação. keyframes gera quadros reais e um clipe curto de audição/movimento. Mostre fonte de áudio/perfil/mix mais ambas as mãos/acordes/mudanças de linha/conexões/câmera. Retorne WAITING_FOR_KEYFRAME_APPROVAL e ENCERRE O TURNO. A audição opcional antecipada de timbre é útil, não um terceiro portão obrigatório. Um trecho de 10–15s não pode substituir o master da música completa. Alterações de áudio/mecanismo/mix invalidam esta revisão.
  6. Exportar após ambas as aprovações. render --approval ... --confirmed usa o job congelado. --confirmed sozinho não pode ignorar a revisão. Verifique streams decodificados, audibilidade, duração, fps/tamanho e ataques sonoros amostrados. Um pico de energia ausente é inconclusivo para música densa/legato: preserve o som e retorne needs_review; nunca encurte decaimento ou mude notas para satisfazer o detector. Não invente um relatório de aprovação. Retenha comandos, entradas e resultados reais.

Qualidade e limites do reconhecimento

Inspecione qualidade de digitalização, proveniência da página/corte, acidentes/tom/clave/oitava, pontos/barras/quíntuplas, pausas, contagem de acordes, vozes/mãos e ligação vs legato. Inicie partituras longas difíceis com um piloto representativo de 3–5 compassos; faça verificação cruzada com um segundo método existente quando útil. Uma leitura dupla de um modelo não é verdade fundamental independente. Nunca afirme uma porcentagem de precisão sem um benchmark corrigido por humanos. Mantenha evidências de incerteza por compasso e explique cada correção.

Duas falhas em um caminho exigem diagnóstico/alternativas. Se nenhum resultado revisável existir após aproximadamente dez minutos, reporte bloqueadores; não execute silenciosamente por uma hora. Complete o trabalho rotineiro autonomamente dentro de cada etapa; não peça micro-permissão para passos reversíveis comuns ou ajustes de mix autorizados.

Use um adaptador OMR profissional instalado quando disponível. Julgue a notação contra a fonte original; sucesso na gravação ou exportação de vídeo não substitui a revisão da fonte. Veja uso e prompts. Preserve jobs legados para inspeção; reassocie novo trabalho com evidências V1.0.0 em vez de sobrescrever artefatos concluídos.

Habilidades Relacionadas