monta-curso - SKILL.md Agent Skill

name: monta-curso description: Monta um curso completo no formato de imersão (até 2h de consumo) a partir do conteúdo de um ou mais PDFs — livros, apostilas, artigos ou textos complementares sobre um assunto. Entrega um material em Markdown estruturado em módulos e aulas, didático e autoexplicativo para o aluno estudar sozinho, baseado nas fontes mas complementado quando há lacunas (marcando claramente o que veio do PDF e o que é complemento). Use sempre que o usuário pedir "monta um curso", "cria um curso", "transforma esse PDF/livro em curso", "monta uma imersão", "vira aula isso aqui", "estrutura um treinamento", "cria um material de estudo a partir desse PDF", ou passar um ou mais arquivos .pdf pedindo para virar curso, aula, imersão ou material didático.

/monta-curso

Transforma um ou mais PDFs (livros, apostilas, artigos) em um curso pronto para o aluno estudar sozinho — no formato de uma imersão de até 2 horas. A saída é um arquivo Markdown organizado em módulos e aulas, didático e autoexplicativo, com exercícios e referências de volta à fonte.

A ideia não é resumir o livro. É redesenhar o conteúdo como experiência de aprendizado: sequenciar por dificuldade, explicar com exemplos, dar prática e fechar com aplicação. O livro é a matéria-prima; o curso é o produto.

Filosofia (por que cada passo importa)

Fonte como espinha dorsal, complemento como tempero. O curso nasce do que está nos PDFs. Mas livro não é curso: muitas vezes falta um exemplo concreto, uma analogia, um exercício. Aí você complementa — e marca o que é complemento, porque a Vera vai revisar e precisa saber o que conferir.
2 horas é um orçamento, não um detalhe. Um aluno consegue manter foco numa imersão de ~2h. Se você jogar o livro inteiro, vira uma maratona que ninguém termina. Então você escolhe: o que entra, o que vira leitura opcional, o que fica de fora. Curadoria é metade do trabalho.
Aluno está sozinho. Não há professor pra tirar dúvida no meio. Cada aula precisa se sustentar: conceito → exemplo → prática. Se uma aula depende de algo que não foi explicado antes, o aluno trava.

Fluxo

Passo 1 — Receber e extrair os PDFs

O usuário passa o caminho de um ou mais arquivos .pdf. Se chamar a skill sem anexar nada, peça os arquivos antes de prosseguir.

Livros inteiros estouram o limite de leitura direta, então extraia o texto completo primeiro com o script empacotado:

python3 ~/.claude/skills/monta-curso/scripts/extrair_pdf.py \
  /tmp/curso_fonte.txt "caminho/livro1.pdf" "caminho/livro2.pdf"

O script avisa se o PDF for escaneado (só imagem, sem texto extraível). Se for o caso, rode a skill /etl-ocr nesses arquivos antes — sem texto não há curso.

Depois leia o .txt gerado para conhecer o material de verdade. Se forem vários PDFs, entenda o papel de cada um: qual é a fonte principal e quais são complementares.

Passo 2 — Alinhar o recorte (rápido, sem burocracia)

Antes de escrever, confirme com o usuário em 1 mensagem curta — proponha valores padrão pra ele só validar ou ajustar, não faça um interrogatório:

Título e promessa do curso (qual transformação o aluno leva).
Para quem é e nível (iniciante / intermediário / avançado) — isso muda profundidade e vocabulário.
Ângulo, quando o livro for amplo: um livro de 400 páginas pode virar dez cursos diferentes. Confirme qual fatia vira ESTA imersão de 2h.

Se o usuário já deu tudo isso no pedido, pule a pergunta e siga.

Passo 3 — Desenhar o esqueleto (cabendo em 2h)

Monte primeiro a estrutura, não o texto. Distribua o tempo:

4 a 6 módulos, cada um com 2 a 4 aulas curtas.
Cada aula carrega um tempo estimado; a soma de tudo (aulas + exercícios) fica ≤ 120 minutos. Heurística: uma aula de autoestudo de ~600–900 palavras + 1 exercício gasta ~8–12 min do aluno. Logo, ~10–14 aulas enchem uma imersão de 2h. Use isso pra calibrar quanto cabe.
Ordene por dependência: o que precisa ser entendido primeiro vem primeiro.
O que é rico mas não cabe vira "leitura opcional" no fim, com a página do livro — não jogue fora, sinalize.

Mostre o esqueleto pro usuário antes de redigir tudo, se o curso for grande ou o recorte ainda estiver incerto. Pra pedidos diretos, pode seguir direto pra escrita.

Passo 4 — Escrever o curso

Redija em Markdown seguindo a estrutura abaixo. Tom de quem ensina alguém que está sozinho: claro, com exemplos, sem encheção. Cada conceito tirado da fonte deve ser didatizado, não copiado — explique com suas palavras e ancore na fonte (capítulo/página) pra dar autoridade e permitir aprofundamento.

Sempre que adicionar algo que não está nos PDFs, marque com > 🟡 Complemento: para a Vera revisar. Não invente fatos, dados, números ou citações como se fossem da fonte — isso quebra a confiança no material.

Passo 5 — Salvar e entregar

Salve o curso numa pasta dedicada (crie se não existir), por padrão ao lado dos PDFs de origem ou em ~/Documents/Projetos/Cursos/<slug-do-curso>/curso.md. No chat, entregue o caminho do arquivo e um resumo de 3–4 linhas: módulos, tempo total estimado, e quantos pontos de complemento ela precisa revisar.

Estrutura do curso (template)

Use este formato. Adapte os títulos ao assunto, mas mantenha os blocos:

# [Título do curso]

> **Imersão de [X] min** · Nível: [iniciante/intermediário/avançado]
> **Para quem é:** [público]
> **O que você vai sair sabendo:** [3–5 resultados concretos]
> **Pré-requisitos:** [o que precisa saber antes, ou "nenhum"]
> **Fontes:** [livro(s) que originaram o curso]

## Mapa do curso
1. Módulo 1 — [nome] (~[min])
2. Módulo 2 — [nome] (~[min])
...

---

## Módulo 1 — [Nome]
**Objetivo:** ao fim deste módulo você consegue [resultado].

### Aula 1.1 — [Título] · ~[min]
[Explicação didática do conceito, em suas palavras.]

**Exemplo:** [exemplo concreto e específico.]

📖 *Fonte: [Livro], cap. X / pág. Y.*

**Pratique:** [exercício, reflexão ou pergunta de fixação.]

### Aula 1.2 — ...

> **Fecho do módulo 1 — leve daqui:**
> - [takeaway 1]
> - [takeaway 2]

---

## Módulo 2 — ...

---

## Projeto final
[Uma tarefa que faz o aluno aplicar o curso inteiro num resultado real.]

## Para ir além (leitura opcional)
- [Tema que não coube] — *[Livro], cap./pág.*

Exemplo

Cenário

Usuário diz: "monta um curso com esse PDF aqui /Users/vera/Downloads/persuasao.pdf — uma imersão pra quem cria conteúdo e quer escrever melhor"

Ações:

Extrair o texto do PDF com extrair_pdf.py → ler o .txt.
Confirmar recorte: título "Escrita Persuasiva para Criadores", nível iniciante, ângulo = aplicar os gatilhos do livro em legendas e roteiros.
Desenhar esqueleto: 5 módulos, ~13 aulas, total ~110 min.
Escrever o curso em Markdown, ancorando cada gatilho na página do livro e marcando os exemplos de Instagram que não estão na fonte como > 🟡 Complemento.
Salvar em ~/Documents/Projetos/Cursos/escrita-persuasiva/curso.md e entregar o caminho + resumo.

Resumo entregue no chat:

Curso pronto: Escrita Persuasiva para Criadores — 5 módulos, 13 aulas, ~~110 min de imersão. Baseado em persuasao.pdf (cap. 1–6). Marquei 4 complementos meus (exemplos de legenda do Instagram) pra você revisar. Arquivo: `~~/Documents/Projetos/Cursos/escrita-persuasiva/curso.md`