Communitygithub.com

ll-video-progress

Cria barras de progresso transparentes com capítulos para importação no CapCut a partir de legendas SRT. Confirma a abrangência dos capítulos com o usuário, depois abre um Playground para seleção de estilos, suporta personalização de cores e personagens, e entrega um MOV estreito e transparente.

O que é ll-video-progress?

Este skill constrói barras de progresso visuais baseadas em capítulos para vídeos, especificamente projetadas para serem sobrepostas em trilhas de vídeo no CapCut (剪映). O processo começa analisando um arquivo SRT fornecido pelo usuário para sugerir uma divisão lógica de capítulos usando uma tabela. Após a confirmação do usuário sobre os capítulos e a proporção do vídeo, o skill inicia um servidor local 'Playground' (scripts/playground_server.mjs) que gera uma prévia animada interativa. O usuário pode então selecionar um dos estilos de progressão validados (como 'Fundo Branco Suave', 'Personagem Liderando', 'Linha de Pontos'), personalizar a cor RGB e, opcionalmente, adicionar um personagem animado. Por fim, o skill renderiza e valida uma faixa estreita de barra de progresso com canal alfa (ProRes 4444 MOV), pronta para ser colocada sobre o vídeo original. É importante notar que o skill depende estritamente de um arquivo SRT fornecido explicitamente pelo usuário na conversa atual e não pesquisa arquivos em disco. Ele segue regras rigorosas para evitar saídas incorretas, exigindo confirmação do usuário em cada etapa e incluindo verificações automáticas de qualidade. Os estilos são registrados em 'assets/progress/styles.json', e novas personalizações (como personagens) podem ser salvas localmente em 'user-data/characters/'.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/liuliu-66-create/ll-video-progress/tree/main

Perguntar na sua IA favorita

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

Documentação

Barra de Progresso de Capítulos de Vídeo

Fluxo do Usuário

  1. Primeiro, verifique se o usuário já fez o upload de um arquivo SRT na conversa atual, ou se forneceu claramente o caminho para um arquivo SRT a ser usado. Apenas legendas desta fonte podem ser lidas diretamente. Se a conversa atual não tiver um SRT fornecido pelo usuário, você deve responder: "Por favor, faça o upload do arquivo de legenda SRT para este vídeo. Com base na legenda, fornecerei sugestões de divisão em uma tabela e, após sua confirmação, criarei a barra de progresso." Em seguida, aguarde o usuário fornecer o arquivo; não realize pesquisa de arquivos, leitura de legendas, análise de conteúdo ou geração da barra de progresso. Não pesquise no computador local, no espaço de trabalho atual, em projetos anteriores, no diretório de downloads, em outras conversas ou na memória por um SRT, nem escolha uma legenda que pareça adequada. Os arquivos fornecidos pelo usuário na conversa atual podem ser reutilizados; não solicite novamente. Se vários arquivos forem fornecidos sem especificar qual usar, pergunte primeiro. Se o arquivo especificado não puder ser lido, peça ao usuário para fazer upload novamente ou verificar o caminho, não pesquise por arquivos alternativos. Somente se o usuário solicitar explicitamente para ver estilos ou criar uma amostra de duração fixa, você pode usar o conteúdo de amostra embutido; uma declaração como "gere uma barra de progresso para mim" não se enquadra nesta exceção.
  2. Leia o SRT completo e sugira o número de capítulos com base na semântica do conteúdo, nas mudanças de tópico, na duração do vídeo e nas necessidades do usuário, sem definir um limite máximo fixo de segmentos; a divisão especificada pelo usuário tem prioridade. Primeiro, diga "Sugiro dividir em X segmentos" e, em seguida, liste as sugestões de divisão na tabela abaixo. Aguarde a confirmação do usuário antes de prosseguir; se o usuário solicitar mesclagem ou divisão, atualize a tabela inteira e confirme novamente. Não use uma lista de texto simples para substituir a tabela, não peça ao usuário para verificar os códigos de tempo.
  3. Após a confirmação dos segmentos, se a proporção do vídeo ainda não tiver sido claramente definida na sessão atual, você deve perguntar primeiro: "A proporção do seu vídeo é 4:3, 16:9 ou 3:4? Outras proporções também podem ser informadas diretamente." Aguarde a resposta antes de continuar; não presuma a proporção com base na legenda, em amostras antigas ou no tamanho de pré-visualização do Playground. Se a proporção já tiver sido definida ou se o vídeo original estiver disponível para verificar as dimensões, use-as diretamente, sem perguntar novamente.
  4. Execute o scripts/playground_server.mjs deste Skill e abra o progressUrl retornado pela inicialização para mostrar uma amostra dinâmica real. O script de inicialização reutilizará automaticamente o serviço da mesma versão; se a porta estiver ocupada por outro programa ou por uma versão antiga, ele mudará automaticamente a porta. Não considere a ocupação da porta padrão como uma falha de instalação, não reutilize diretamente páginas antigas de versões não verificadas e não encerre processos desconhecidos. Peça ao usuário para responder com o nome do estilo, sem exigir que ele julgue a implementação da animação ou codificação. Estilos já selecionados não precisam ser selecionados novamente.
  5. Somente após o usuário selecionar "Personagem Liderando" ou "Texto Liderando" é que o personagem deve ser processado. Leia o personagem padrão pessoal salvo localmente de acordo com references/characters.md. Se o usuário já especificou um personagem para esta execução, use essa seleção primeiro; caso contrário, se houver um personagem padrão pessoal, use-o diretamente, informe brevemente, sem solicitar ou gerar novamente. Se não houver registro, pergunte se o usuário deseja fornecer uma imagem personalizada; se não, use o personagem embutido. Não responder não significa que não há. Após a confirmação do usuário sobre o efeito de caminhada do novo personagem personalizado, salve-o em user-data/characters/ dentro da instalação do Skill como o novo padrão; se o usuário declarar explicitamente que é apenas para uso único, não altere o padrão. Quando um estilo sem personagem for selecionado, não pergunte, leia ou salve personagens. Imagens pessoais originais, quadros de animação e configurações não devem ser gravados em assets públicos, SKILL.md, commits Git ou GitHub; ao atualizar a instalação, mantenha os user-data locais.
  6. Com base na proporção do vídeo confirmada, nos capítulos e no estilo, siga references/rendering.md para salvar a configuração, fazer dry-run, gerar, verificar e, em seguida, entregar um MOV estreito ProRes 4444. Se as legendas forem adicionadas, removidas ou tiverem a velocidade alterada após a criação, a sincronização precisará ser refeita.

Formato Fixo de Saída para Sugestão de Segmentação

SegmentoTítulo Curto da BarraResumo do ConteúdoFala InicialFala Final
1Nome curto do capítuloSobre o que é este segmentoCitar textualmente do SRT a primeira fala deste segmentoCitar textualmente do SRT a última fala deste segmento

Uma linha por segmento, o título é usado na barra de progresso, o resumo ajuda o usuário a julgar a segmentação, e o intervalo de falas ajuda o usuário a localizar. Após a tabela, peça ao usuário para confirmar se deseja adotar a sugestão ou indicar onde precisa mesclar, dividir ou alterar títulos. As falas não podem ser reescritas como resumos. Se o número de capítulos for muito grande para caber no texto, explique o problema prático de layout e proponha encurtar títulos, ajustar o tamanho da fonte ou outras soluções de layout, deixando a decisão para o usuário; não force a redução para 5 segmentos nem mescle capítulos confirmados sem permissão para se adequar ao estilo.

As informações confirmadas permanecem válidas durante a sessão atual; não solicite novamente. Sem autorização explícita, não altere o texto, modifique as legendas ou corte o vídeo original.

Estilos Validados

  • Fundo Branco Suave (soft-white-green): Barra horizontal retangular, fundo branco semitransparente, texto de capítulo branco e separadores de linha vertical, preenchimento avança conforme o tempo deste segmento.

  • Personagem Liderando (walking-leading): Usa a barra horizontal acima, apenas adiciona um personagem liderando na frente do preenchimento. O personagem tem a mesma altura da barra, o corpo é deslocado para baixo, no máximo metade da altura da barra fica para fora, não andando no topo da barra.

  • Linha de Pontos (dot-line): Linha fina e pontos mudam de cor conforme o progresso do capítulo, espaçamento de 6 px entre texto e pontos.

  • Segmentos Curtos (short-segments): Uma linha curta por capítulo, preenchida conforme o tempo deste capítulo, espaçamento de 6 px entre texto e linha curta.

  • Texto Liderando (text-leading): O texto muda de cor conforme o progresso do capítulo, com um personagem liderando na frente, sem faixa de fundo longa; fonte pequena sem contorno, desenhado com precisão 4x e composição de transparência única.

Todos os cinco podem ter a cor de preenchimento RGB modificada. Os três novos estilos suportam tamanhos de fonte de 18 a 72 px (calculados em pixels de exportação), com padrões de 24, 26 e 25 px respectivamente, e a altura de saída se ajusta automaticamente ao texto. Verde é apenas a cor padrão; os valores de cor selecionados pelo usuário no Playground devem ser gravados na configuração final. Não é permitido visualizar com uma cor diferente e exportar ainda verde.

A fonte oficial das regras é references/confirmed-rules.md, e o registro de estilos está em assets/progress/styles.json. Apenas exiba e gere estilos validados; novos estilos devem ser registrados somente após o usuário visualizar uma amostra real e aprovar.

Aceitação e Entrega

  • O script verifica o intervalo da legenda, layout do título, dimensões, decodificação completa, número de quadros, duração e pixels transparentes. O Agente também deve abrir a folha de contato, quadros exportados reais e a pré-visualização dinâmica para verificar o loop do personagem, corte, transição de capítulo e cor.
  • Fundo Branco Suave 1440×64; Personagem Liderando 1440×96, com altura da barra 64, personagem no máximo 64, parte inferior exposta no máximo 32. Os três novos estilos têm dimensões padrão de 1440×78, 1440×70 e 1440×96 respectivamente; para Texto Liderando, o personagem tem no máximo 64 e a parte inferior exposta no máximo 32. Ao alterar a altura da barra, calcule proporcionalmente; por padrão, não exporte a tela inteira.
  • O download é uma faixa estreita ProRes 4444 MOV. WebM transparente é usado para pré-visualização no navegador; reference-qtrle.mov é usado apenas para verificação interna, não para entrega. Não use MP4 comum para substituir vídeo transparente.
  • Deve ser transparente exceto pela barra e personagem. Cores de fundo de pré-visualização, linhas diagonais ou padrões quadriculados não devem ser incorporados ao arquivo.
  • O usuário já verificou que esta faixa estreita ProRes 4444 funciona no CapCut; novos arquivos ainda precisam ser verificados. Não presuma que o navegador normal ou a existência de canal alfa significa que qualquer versão do CapCut suporta.
  • Retorne o link do produto final com caminho absoluto, explicando que deve ser colocado na trilha acima do vídeo original, alinhado ao início, mantendo a velocidade original, preenchendo a largura e movido para o topo. As amostras devem ter a duração claramente marcada e não podem se passar por uma barra de progresso de duração total do vídeo do usuário.

Para gerar pequenas animações independentes de alguns segundos a partir de texto, use ll-video-motion para transições de capítulo; para narração, legendas completas e edição contínua de clipes, use ll-video-edit.

Habilidades Relacionadas