How do I install the Roteiro Videoaula skill?

Run npx skillmds@latest add naubergois/roteiro-videoaula in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Roteiro Videoaula safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Roteiro Videoaula?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Roteiro Videoaula free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Roteiro Videoaula?

naubergois (@naubergois) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Roteiro Videoaula by naubergois — Agent Skill

Name: Roteiro Videoaula
Author: naubergois

Roteiro Videoaula

Transforma uma aula ou conteúdo em roteiro de vídeo-aula pronto para gravação: gancho, narração falada (locução), marcações de tela/slide, B-roll, tempos e CTA. Saída em Markdown (PT-BR), pronta para teleprompter e integração com heygen-screens. Use quando o usuário quiser criar roteiro de vídeo, script de aula gravada, locução, narração para slides, roteiro para avatar/HeyGen, ou converter conteúdo em vídeo. Triggers: roteiro de vídeo, script de aula, narração, locução, roteiro de vídeo-aula, teleprompter, roteiro para gravação, roteiro heygen.

naubergois Updated Sep 21, 2026

File contents

Roteiro de Vídeo-Aula — Script para Gravação

Converte uma aula/conteúdo em roteiro de vídeo pronto para gravar: locução falada + marcações visuais + tempos. Saída em Markdown.

Quando usar

✅ Use quando	❌ Não use quando
Escrever o que será falado no vídeo	Planejar o curso → use `curso-builder`
Roteiro para teleprompter / avatar	Gerar os slides → use `slides-material`
Locução para acompanhar slides	Produzir o vídeo no HeyGen → use `heygen-screens`

Skills relacionadas

curso-builder / slides-material — fonte do conteúdo
heygen-screens — produz o vídeo com avatar a partir deste roteiro
publicacao-formatacao — empacota roteiros para entrega

Fluxo de Execução

1. Briefing

Confirme:

Aula / tópico de origem (ou conteúdo bruto / notas dos slides)
Duração-alvo do vídeo (ex.: 5, 10, 20 min)
Formato: apresentador real, avatar (HeyGen), voz + slides, screencast
Tom: didático, dinâmico, formal
Ritmo de fala: use ~130–150 palavras/min para estimar tempos

2. Arco do roteiro

Gancho (0–15s) — pergunta/problema que prende atenção
Promessa — o que o espectador vai aprender
Desenvolvimento — blocos curtos, um conceito por vez
Exemplo/demonstração
Resumo — recapitulação dos pontos
CTA — próximo passo (próxima aula, exercício, inscrição)

3. Formato de saída (roteiro de duas colunas em Markdown)

Gere roteiros/<slug>.md com blocos assim:

## Bloco 1 — Introdução  ⏱️ ~0:30

**🎙️ Locução:**
> Você já se perguntou como...? Nesta aula você vai aprender X, Y e Z.

**🖥️ Tela / Slide:** Slide 1 (capa) → Slide 2 (agenda)
**🎬 B-roll / visual:** animação do título
**📝 Nota de direção:** falar com energia, pausa após a pergunta

Regras:

Locução em texto corrido, falável (frases curtas, sem jargão escrito).
Marque tela/slide alinhada a cada bloco (sincroniza com slides-material).
Indique tempo por bloco e some o total ao final.
Escreva números/símbolos por extenso quando for falado ("vinte por cento", não "20%").

4. Versão teleprompter

Gere também, se pedido, uma versão só com a locução corrida (*-teleprompter.md) — sem marcações — para leitura direta.

5. Integração HeyGen

Se o destino for avatar, formate a locução em blocos curtos (1 ideia por parágrafo) e ofereça acionar heygen-screens para gerar o vídeo.

6. Áudio (ElevenLabs + música) — quando enriquecer

Se a aula/vídeo ficar claramente melhor com voz ou trilha, ofereça ou execute (não espere o pedido):

Objetivo	Ferramenta / skill
Locução MP3	`qclaw_elevenlabs_narrate` · `qclaw-elevenlabs-voice`
Narração por slide	`qclaw_slides_narration` → depois ElevenLabs
Trilha / intro musical	`qclaw_suno_music_generate` ou `qclaw_gemini_music_generate`
Música no projeto de vídeo	`qclaw_generate_video_music`

Não force áudio se o utilizador pediu só o roteiro em texto.

Princípios de qualidade

Falável, não lido: escreva como se fala, não como se escreve.
Gancho forte nos primeiros 15 segundos.
Sincronia locução ↔ slide ↔ tempo.
Blocos curtos (15–45s) para manter ritmo.
Escreva em PT-BR salvo pedido contrário.

---name: roteiro-videoauladescription: Transforma uma aula ou conteúdo em roteiro de vídeo-aula pronto para gravação: gancho, narração falada (locução), marcações de tela/slide, B-roll, tempos e CTA. Saída em Markdown (PT-BR), pronta para teleprompter e integração com heygen-screens. Use quando o usuário quiser criar roteiro de vídeo, script de aula gravada, locução, narração para slides, roteiro para avatar/HeyGen, ou converter conteúdo em vídeo. Triggers: roteiro de vídeo, script de aula, narração, locução, roteiro de vídeo-aula, teleprompter, roteiro para gravação, roteiro heygen.---# Roteiro de Vídeo-Aula — Script para GravaçãoConverte uma aula/conteúdo em **roteiro de vídeo** pronto para gravar: locução falada + marcações visuais + tempos. Saída em Markdown.## Quando usar| ✅ Use quando | ❌ Não use quando ||---|---|| Escrever o que será falado no vídeo | Planejar o curso → use `curso-builder` || Roteiro para teleprompter / avatar | Gerar os slides → use `slides-material` || Locução para acompanhar slides | Produzir o vídeo no HeyGen → use `heygen-screens` |## Skills relacionadas- `curso-builder` / `slides-material` — fonte do conteúdo- `heygen-screens` — produz o vídeo com avatar a partir deste roteiro- `publicacao-formatacao` — empacota roteiros para entrega---## Fluxo de Execução### 1. BriefingConfirme:- **Aula / tópico** de origem (ou conteúdo bruto / notas dos slides)- **Duração-alvo** do vídeo (ex.: 5, 10, 20 min)- **Formato**: apresentador real, avatar (HeyGen), voz + slides, screencast- **Tom**: didático, dinâmico, formal- **Ritmo de fala**: use ~130–150 palavras/min para estimar tempos### 2. Arco do roteiro1. **Gancho (0–15s)** — pergunta/problema que prende atenção2. **Promessa** — o que o espectador vai aprender3. **Desenvolvimento** — blocos curtos, um conceito por vez4. **Exemplo/demonstração**5. **Resumo** — recapitulação dos pontos6. **CTA** — próximo passo (próxima aula, exercício, inscrição)### 3. Formato de saída (roteiro de duas colunas em Markdown)Gere `roteiros/<slug>.md` com blocos assim:```markdown## Bloco 1 — Introdução ⏱️ ~0:30**🎙️ Locução:**> Você já se perguntou como...? Nesta aula você vai aprender X, Y e Z.**🖥️ Tela / Slide:** Slide 1 (capa) → Slide 2 (agenda)**🎬 B-roll / visual:** animação do título**📝 Nota de direção:** falar com energia, pausa após a pergunta```Regras:- **Locução** em texto corrido, falável (frases curtas, sem jargão escrito).- Marque **tela/slide** alinhada a cada bloco (sincroniza com `slides-material`).- Indique **tempo** por bloco e some o total ao final.- Escreva números/símbolos por extenso quando for falado ("vinte por cento", não "20%").### 4. Versão teleprompterGere também, se pedido, uma versão só com a locução corrida (`*-teleprompter.md`) — sem marcações — para leitura direta.### 5. Integração HeyGenSe o destino for avatar, formate a locução em blocos curtos (1 ideia por parágrafo) e ofereça acionar `heygen-screens` para gerar o vídeo.### 6. Áudio (ElevenLabs + música) — quando enriquecerSe a aula/vídeo ficar claramente melhor com voz ou trilha, **ofereça ou execute** (não espere o pedido):| Objetivo | Ferramenta / skill ||---|---|| Locução MP3 | `qclaw_elevenlabs_narrate` · `qclaw-elevenlabs-voice` || Narração por slide | `qclaw_slides_narration` → depois ElevenLabs || Trilha / intro musical | `qclaw_suno_music_generate` ou `qclaw_gemini_music_generate` || Música no projeto de vídeo | `qclaw_generate_video_music` |Não force áudio se o utilizador pediu só o roteiro em texto.## Princípios de qualidade- **Falável, não lido**: escreva como se fala, não como se escreve.- **Gancho forte** nos primeiros 15 segundos.- **Sincronia** locução ↔ slide ↔ tempo.- **Blocos curtos** (15–45s) para manter ritmo.- Escreva em **PT-BR** salvo pedido contrário.

Frequently asked questions