# 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.

- Skill: `naubergois/roteiro-videoaula` (Agent Skill)
- Install (CLI): `npx skillmds@latest add naubergois/roteiro-videoaula`
- Raw SKILL.md: https://api.skillmd.com/api/skills/naubergois/roteiro-videoaula/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: naubergois (https://skillmd.com/u/naubergois)
- Updated: 2026-09-21
- Page: https://skillmd.com/skills/naubergois/roteiro-videoaula

---


# 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

1. **Gancho (0–15s)** — pergunta/problema que prende atenção
2. **Promessa** — o que o espectador vai aprender
3. **Desenvolvimento** — blocos curtos, um conceito por vez
4. **Exemplo/demonstração**
5. **Resumo** — recapitulação dos pontos
6. **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 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.