usage-monitor-social-video
Skill19 starsChanged 50 days agoMITView on GitHub
Generate social videos about any theme (text, facts or images) in the approved Usage Monitor look, with voice, soundtrack, captions and post copy for TikTok, YouTube Shorts, LinkedIn, X and YouTube long form. Use for "vídeo sobre", "vídeo para as redes", "vídeo para TikTok/Shorts/LinkedIn/X/YouTube" when the subject is not a release; releases use usage-monitor-release-video.
- Reads credentials
In this repository13 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- orchestrateSkill
- usage-monitor-commit-pushSkill
- usage-monitor-designSkill
- usage-monitor-nsis-installerSkill
- usage-monitor-release-betaSkill
- usage-monitor-releaseSkill
- usage-monitor-release-videoSkill
- usage-monitor-test-reportSkill
- usage-monitor-token-cleanupSkill
- usage-monitor-visual-optionsSkill
- usage-monitor-workflowSkill
The file
Files
Usage Monitor — vídeos para redes a partir de um tema
Entrada: um tema, com informações, imagens ou só texto, e uma chave temporária da OpenRouter. Saída: 6 vídeos, legendas e descrições. O padrão foi aprovado pelo dono no #540 e não muda por tema:
| Item | Padrão |
| Visual | Modelo 01 Horizonte de eventos (assets/scene.js), design system do projeto |
| Voz | elevenlabs/eleven-v4: matilda (PT), george (EN), pela OpenRouter, via harness do opencode |
| Trilha | Pulso de sonda, sintetizada em scripts/audio.py, sem amostra de terceiros |
| Plataformas | TikTok e Shorts (PT, 9:16, 1 min), LinkedIn (PT, 16:9, 1 min), X (EN, 16:9, 1 min), YouTube (PT e EN, 16:9, 5 min) |
Vídeo novo é dado, não código: só muda o video.json (contrato em references/video-spec.md).
Pedido de outro visual, voz ou trilha é mudança da skill, com protótipos antes; nunca ajuste no meio de um vídeo.
Todo o trabalho segue o fluxo do CLAUDE.md. Versionado: docs/planos/video-<slug>/ (video.json, roteiro.md, social.md,
imagens). Mídia fica fora: build/social-video/<slug>/ e ~/Videos/usage-monitor/<slug>/. A skill não publica nada.
Passo a passo
- Material. Tema e fontes. Número, nome ou afirmação só entra com origem: o que o dono mandou ou o que você mediu com comando. Se faltar dado, pergunte; nunca complete. Olhe cada imagem: credencial, e-mail ou dado pessoal visível bloqueia o uso.
- Roteiro. Escreva
video.jsone, a partir dele,roteiro.mdcom as duas versões. Um roteiro que só cita etapas foi recusado pelo dono: cada etapa diz o que acontece e como, com o artefato real em tela.- Curto: teto medido de 630 caracteres por idioma (12,2 caracteres/s); cada fala tem uma ação e um porquê.
- Longo: até 3400 caracteres, no máximo 15 etapas, cada uma com 2 a 4 frases, abrindo com o contexto e fechando com um caso real.
- Fala curta, sem jargão desnecessário;
factslista todo número usado.
- Conferência.
node <skill>/scripts/make.mjs check <video.json>. Erro de teto se resolve cortando texto, nunca acelerando voz. - Prévia, sem gastar API.
node <skill>/scripts/make.mjs preview <video.json>: gera linha do tempo estimada e quadros embuild/social-video/<slug>/qa/, com folha de contatosheet.jpg. Olhe a folha você mesmo: texto cortado, sobreposição, imagem ilegível ou faixa de legenda invadida voltam para ovideo.json. - Parada obrigatória. Mande
roteiro.mde a folha ao dono e espere o ok. Nada de voz nem render antes: render longo custa cerca de 14 minutos por idioma, e o dono já recusou roteiro depois do visual aprovado. - Chave. Peça a chave só agora, se não veio. Grave em arquivo temporário fora do repositório e passe por variável de ambiente.
Nunca em comando impresso, log,
video.jsonou commit. Ao terminar, apague o arquivo e diga ao dono para revogar. Voz. Pelo harness do opencode, com a entrada fechada; sem
</dev/nullo processo fica parado sem saída:OPENROUTER_API_KEY="$(cat <arquivo>)" opencode run --format json -m openrouter/anthropic/claude-haiku-5.5 \ "Rode node <skill>/scripts/make.mjs voice <video.json> e devolva a saída. Nunca imprima a chave." </dev/null > <scratch>/voice.jsonlRode em segundo plano. Depois confirme que a saída não contém
sk-or-. O relatório diz o custo aproximado e as falas medidas; se ogapficar abaixo de 0,8 s, corte texto e refaça só os segmentos alterados.- Render.
node <skill>/scripts/make.mjs render <video.json>em segundo plano (--only <variante>para refazer uma). Medido: 3 minutos por vídeo de 60 s e 14 minutos por vídeo longo, com dois em paralelo. - Validação com evidência própria.
ffprobe(resolução, 30 fps, duração),ebur128(cerca de −14 LUFS, pico abaixo de −1 dBTP) e quadros extraídos do MP4 final, nos dois formatos e idiomas. Relatório de agente não conta. - Descrições.
docs/planos/video-<slug>/social.md, uma seção por rede, no formato dedocs/planos/video-fluxo-540/social.md: capítulos do YouTube pelos tempos reais debuild/social-video/<slug>/long-*.js, X até 280 caracteres (link conta 23), TikTok com "Link na bio". Texto publicado sai na voz do dono: sem opinião ou resultado que ele não afirmou. - Entrega, em até 15 linhas: caminho dos arquivos, duração, custo real, o que não foi verificado. Sempre diga que ninguém ouviu o resultado: pronúncia e qualidade da voz dependem da escuta do dono.
Regras aprendidas
| Regra | Por quê |
| Velocidade da voz nunca muda | Pedido do dono no #503 e no #540; o conserto é cortar texto |
| Sigla escrita ≠ falada | say e toSpoken cuidam da voz; a legenda usa o texto escrito |
| Sem nome de filme, compositor ou logotipo de terceiro | Direitos autorais; prompt de trilha é descritivo |
Dado na cena vem de facts | Número inventado em vídeo público não tem conserto depois de postado |
| Imagem de terceiro só com licença clara | O vídeo é público |
| Teste curto antes de render longo | make.mjs render <video.json> --silent --to 3 prova trilha, cena e encode sem voz nem API; grava em smoke/ |
drawtext do ffmpeg não é usado | Falhou com Segmentation fault nesta máquina (fontconfig) |
Testes: node --test ".claude/skills/usage-monitor-social-video/scripts/test/*.test.mjs". O CI não os roda.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

