usage-monitor-release-video
Skill19 starsChanged 50 days agoMITView on GitHub
Release video (vertical, PT/EN, voice, captions) and post text for X/Instagram/TikTok, plus the 16:9 tour of the whole app. Use for "vídeo da release", "vídeo de lançamento", "vídeo para o insta/tiktok", "descrição para X/Instagram/TikTok", "tour em vídeo".
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-social-videoSkill
- usage-monitor-test-reportSkill
- usage-monitor-token-cleanupSkill
- usage-monitor-visual-optionsSkill
- usage-monitor-workflowSkill
The file
Files
Usage Monitor — vídeo de lançamento
Gera, para uma versão estável, dois vídeos verticais (PT e EN), as legendas .srt e as descrições para X,
Instagram e TikTok. O combinado com o dono (issue #503) é regra, não sugestão:
| Regra | Como é garantida |
| Vertical 1080×1920, 30 fps, H.264 + AAC | render.mjs |
| Voz sintética nos dois idiomas | Piper, en_US-ryan-high e pt_BR-faber-medium (aprovadas na 41.11), synthesize.py |
| Sem pressa | timeline.mjs falha acima de 15 caracteres/s por fala ou de 90 s no total; 1,2 s de respiro depois de cada fala e 0,35 s entre frases. O conserto é cortar texto, nunca acelerar a voz |
| Legenda | queimada (2 linhas × 26 caracteres, área segura das redes) e .srt; entra 150 ms antes da fala, sai 300 ms depois |
| Todas as mudanças da versão | cada issue de collect-changes.mjs tem cena ou item; nada além do que está nos commits |
| Tema do app | tokens de docs/design-system/tokens/, Plex Mono/Sans do app, anel Gargantua só na abertura e no fechamento |
| Descrições | social.mjs recusa X acima de 280 (link = 23, emoji = 2) ou sem o link da release, link em Instagram/TikTok (não é clicável) e mais de 5 hashtags |
A skill não publica nada nas redes e não abre o vídeo para o dono aprovar quadro a quadro: ela entrega os arquivos e diz onde estão.
Passo a passo
Todo o trabalho segue o fluxo do CLAUDE.md (issue, worktree, PR): o roteiro, as cenas e as descrições são
versionados em docs/planos/video-v<maior>-<menor>/.
- Versão. A pedida, ou a última estável (
git tag --list 'v*'sem-beta). - O que mudou.
node .claude/skills/usage-monitor-release-video/scripts/collect-changes.mjs vX.Y.Z— feat/fix agrupados por issue e os sem issue (loose). Leia o corpo da release (gh release view vX.Y.Z) e o plano de cada issue emdocs/planos/para entender o que a pessoa vê; não descreva o que não está lá. - Imagens reais. Procure capturas da versão:
img/*.gif|png(oimg/terminal.gif/terminal-pt.gifsão do próprio código de terminal),docs/planos/prints-*,docs/design-system/screenshots/. Prefira par EN/PT; GIF entra emsourcese vira quadrosNNN.png(ffprobe -show_entries frame=duration_timeacha os quadros parados). Funcionalidade sem captura vira cenasteps,listoucommandscom os rótulos reais do app (procure o texto nos*Labels.kt/CommandLineHelp.kt), nunca número inventado. - Cenas. Escreva
docs/planos/video-v<M>-<m>/scenes.json(formato abaixo): abertura, uma cena por assunto, umalist"E mais" para o miúdo, fechamento com o link do GitHub. Fala curta, uma ideia por cena. Número escrito na legenda (42) e por extenso nosay("quarenta e dois"); comando com--idem. - Quadros de conferência.
node .claude/skills/usage-monitor-release-video/scripts/make-video.mjs vX.Y.Z --stills. Na primeira vez numa máquina, instala Piper, vozes (~185 MB) e puppeteer-core em%LOCALAPPDATA%\usage-monitor-video(setup-tools.mjs). Se a linha do tempo recusar, corte o texto da cena apontada e rode de novo. Depois olhe os PNG debuild/release-video/vX.Y.Z/check/(monte uma folha comffmpeg … xstackpara ver todos de uma vez): texto da captura legível, nada encostando na legenda, recorte (crop) sem cortar coluna pela metade. - Descrições.
docs/planos/video-v<M>-<m>/social.json(PT e EN parax,instagram,tiktok): o X leva o link da release; Instagram e TikTok dizem "link na bio" / "link in bio"; até 5 hashtags. Licença e plataformas só como estão no repositório (LICENSE, artefatos da release). - Vídeos.
node .claude/skills/usage-monitor-release-video/scripts/make-video.mjs vX.Y.Z(≈ 10 min nos dois idiomas). Saída em~/Videos/usage-monitor/vX.Y.Z/:usage-monitor-<label>-{en,pt}.mp4,.srtesocial.md. Confira offprobeque o script imprime (1080×1920, h264 + aac, duração) e extraia 2–3 quadros do MP4 final. - Roteiro.
docs/planos/video-v<M>-<m>/roteiro.md: fonte (faixa de tags e issues), parâmetros medidos (duração, caracteres/s mais alto) e a tabela de cenas EN/PT — o mesmo formato devideo-v41-11/roteiro.md. - Entrega ao dono (≤ 15 linhas): caminho dos arquivos, duração, e o texto de cada rede está no
social.md.
Tour em vídeo 16:9 (#505)
O tour de todas as funcionalidades é outro alvo da mesma skill, com regras próprias: roteiro em
docs/planos/video-tour/scenes.json, saída em ~/Videos/usage-monitor/tour/usage-monitor-tour-{en,pt}.mp4 + .srt.
| Regra | Como é garantida |
| 1920×1080, 30 fps, 5 a 10 min | TOUR_PACING (timeline.mjs) falha abaixo de 300 s ou acima de 600 s |
| Sem pressa | ≤ 14 caracteres/s, 1,4 s de respiro; conserto é cortar texto ou baixar voice.speed, nunca acelerar |
| Voz | Kokoro pf_dora (PT) e am_michael (EN), escolhidas pelo dono ouvindo amostras; voice no roteiro |
| Capturas reais nos dois idiomas | as demos da ajuda a 2× em PNG: gradlew.bat generateVideoMedia -PvideoMediaLanguage=en (o make-tour.mjs roda sozinho se faltar build/video-media/<idioma>) |
| Trilha e efeitos | soundtrack.py, sintetizados (sem amostra de terceiros), semente fixa; efeitos nos instantes de soundEvents; trilha abaixa sob a fala (sidechain) |
| Transições do tema | lente gravitacional + cartão do capítulo, deslize de captura, foco com contorno azul, digitação; anel Gargantua só na abertura e no fechamento |
node .claude/skills/usage-monitor-release-video/scripts/make-tour.mjs --stills # conferência (~2 min)
node .claude/skills/usage-monitor-release-video/scripts/make-tour.mjs --only en # um idioma (~20 min)
node .claude/skills/usage-monitor-release-video/scripts/make-tour.mjs --remix # só o áudio, sobre o vídeo mudoMixagem com ganhos fixos e loudnorm linear em duas passadas: o de uma passada é dinâmico e levantou a trilha nos
respiros até o nível da fala (medido no #505). Roteiro e medições: docs/planos/video-tour/roteiro.md.
Cena screen do tour: media: [{ "media": "<mediaId da ajuda>", "bar", "focus": [x, y, l, a], "crop": [x, y, l, a] }], em dp da cena
de 1000×420 da ajuda; várias capturas dividem o capítulo. steps e commands como no vídeo de release.
Formato do scenes.json
{
"version": "v42.0.0",
"label": "42.0",
"sources": { "terminal-en": { "gif": "img/terminal.gif" }, "shots": { "files": ["docs/…/a.png"] } },
"scenes": [
{ "id": "title", "kind": "title", "headline": { "en": "…", "pt": "…" },
"lines": { "en": { "text": "Usage Monitor 42 is here.", "say": "Usage Monitor forty-two is here." }, "pt": { "text": "…" } } },
{ "id": "status", "kind": "screen", "tag": "#439", "kicker": { "en": "terminal", "pt": "terminal" },
"headline": { "en": "…", "pt": "…" }, "image": { "en": "terminal-en/022.png", "pt": "terminal-pt/022.png" },
"crop": [x, y, largura, altura], "chips": ["usage-monitor status"], "lines": { … } },
{ "id": "scripts", "kind": "commands", "commands": [ { "cmd": "…" | {"en","pt"}, "out": { "en", "pt" } } ], "pause": 0.5, … },
{ "id": "team", "kind": "steps", "steps": [ { "label": {…}, "state": "ok|fail|pending", "why": {…} } ], … },
{ "id": "more", "kind": "list", "items": [ { "en": "…", "pt": "…" } ], "stagger": 1.2, … },
{ "id": "closing", "kind": "closing", "headline": {…}, "link": "github.com/edilsonvilarinho/usage-monitor", … }
]
}screen: a imagem cabe em 876 × 544 px; recorte menor = texto maior. Captura de terminal a 880 px de largura só fica
legível no celular com escala ≥ 1,2 (recorte de até ~720 px). commands: digita a 30 caracteres/s a partir da fala.
Onde mexer
| Arquivo | Papel |
scripts/collect-changes.mjs | commits entre tags estáveis, por issue (testado) |
scripts/timeline.mjs | ritmo, tempos das cenas, blocos de legenda, SRT (testado) |
scripts/social.mjs | limites das redes e social.md (testado) |
scripts/synthesize.py | Piper: escala por idioma (EN 1,4 · PT 1,5; a faber é mais rápida) e pausa entre frases |
assets/video.html | renderizador: renderFrame(t) puro, sem relógio nem transição CSS |
scripts/render.mjs | Chrome sem tela → JPEG → ffmpeg; --stills |
scripts/make-video.mjs | orquestra; áudio: falas no instante da cena + drone 55/82 Hz a −16 dB, loudnorm −16 LUFS |
scripts/make-tour.mjs | orquestra o tour 16:9: capturas, falas, trilha, render e mixagem com ducking |
assets/tour.html | renderizador do tour: renderFrame(t) puro, espera decodificar a captura nova |
scripts/soundtrack.py | trilha espacial e efeitos sonoros do tour, sintetizados |
scripts/setup-tools.mjs | instala as ferramentas fora de build/ (o gradlew clean apagou o pipeline da 41.11) |
Testes: node --test .claude/skills/usage-monitor-release-video/scripts/test/*.test.mjs.
O Piper sorteia a duração: duas sínteses do mesmo texto variam alguns décimos por fala e até ~1,7 s no total (v42.0.0:
88,9 s numa execução, 90,6 s na seguinte). Por isso o synthesize.py reaproveita o WAV enquanto texto, escala e
pausa não mudam (assinatura em <cena>.txt): o vídeo final tem exatamente a fala que o --stills conferiu. Mudou o
texto, a fala é sorteada de novo — deixe folga (≤ 14 caracteres/s, ≤ 88 s) em vez de parar no limite.
Ao rodar com saída filtrada (| tail, | grep), use set -o pipefail: sem ele a recusa da linha do tempo sai com 0.
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.

