aula
Skill0 starsChanged 3 months agoMITView on GitHub
Transforma UMA aula em nota final no segundo cérebro do Dantas. Use quando ele rodar /aula, ou disser "processa essa aula", "faz a nota dessa aula", "transcreve e anota isso", ou apontar uma pasta de entrada/, um arquivo de vídeo/áudio, ou um link do YouTube. Cobre o pipeline inteiro: normalizar as fontes, analisar, rotear no PARA, escrever no formato certo e commitar.
- Commits and pushes
1 other project uses a version of this.
Adopted by
Most recently taken up by
- sorenlouv/aula-clitheir own version, first seen Sep 23, 2026
Other versions1 project uses a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 1
- sorenlouv/aula-cli★ 0same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository8 other files it gives its agents.
- CLAUDE.mdCLAUDE.md
- moverSkill
- organizarSkill
- planejarSkill
- processar-filaSkill
- proximaSkill
- revisar-semanaSkill
- setupSkill
The file
We split this skill into the rules it gives an agent
2 rules. About 0 are common, 0 are distinctive, and 2 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈0
Distinctive · estimate
This author's own choices. Worth a look.
2
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 232
Reporte a decisão: no bloco final, sempre: Nota nova ou Enriqueceu <nota> (continuação de <tema>).
- Very specific: line 333
No Inbox, cuidado: nem toda nota solta é desta aula.
≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
/aula — uma aula vira nota
Argumento: pasta em entrada/, caminho de arquivo, ou URL do YouTube.
Sem argumento: pergunte qual, listando o que há em entrada/.
Leia primeiro, se ainda não leu nesta sessão:
referencias/regras-do-vault.md, referencias/criterios-de-formato.md.
Fase 1 — Normalizar
Monte a pasta da aula em entrada/ se ainda não existir:
- Pasta de
entrada/→ use direto Arquivo solto →
mkdir -p "entrada/<nome>"e mova o arquivo pra lá.⚠️ Gravação de celular quase sempre tem nome inútil —
Nova gravação 3.m4a,Gravação 12.m4a,IMG_4821.mov. Esse nome vira a camada 1 do roteamento, então pergunte o nome da aula antes de criar a pasta. Uma pergunta agora evita a nota cair no Inbox depois:Recebi "Nova gravação 3.m4a" (1h07min). Qual aula é essa? (ex: "N+ 2.7 - Wireless", "Modelagem - Método de Euler")Só pule a pergunta se o dossiê depois identificar a disciplina com confiança alta — mas aí ainda confirme o título antes de escrever.
- URL →
mkdir -p "entrada/<nome>"e escreva a URL emfonte.txt
Depois:
scripts/ingerir.sh "entrada/<nome da aula>"O script imprime o caminho de trabalho/<slug>/ na última linha. Ele é
idempotente — rodar de novo não reprocessa o que já está pronto.
Se ele falhar em uma fonte mas processar outras, siga em frente e registre a perda. Se falhar em todas, pare e diga o que houve.
Se a saída trouxer AVISO-QUALIDADE, a nota final precisa declarar baixa
confiança.
Fase 1b — Esse material dá mais de uma nota?
Ele não escolhe mais entre processar-fila e planejar. Joga tudo em
entrada/ e manda processar. Julgar se o material é extenso demais para uma
nota só é seu trabalho, aqui — antes de gastar a análise, porque mandar um
slidão de semestre pro escriba-analista como se fosse uma aula é usar a
ferramenta errada.
Transcrição nunca conta. Uma gravação é uma aula — ele gravou de uma sentada. Áudio de 1h rende 9 mil palavras e continua sendo uma nota. Material publicado é que pode ser o semestre inteiro.
for f in "entrada/<aula>"/*.pdf; do
[[ -e "$f" ]] || continue
printf '%s: %s páginas\n' "$(basename "$f")" \
"$(pdfinfo "$f" 2>/dev/null | awk '/^Pages:/{print $2}')"
done40 páginas ou mais num único material → pare e sugira. É o mesmo teto do
extrair-materiais.sh, e pela mesma razão: acima disso não é documento de uma
aula.
📚 "estatistica-2026-2.pdf" tem 180 páginas — material de semestre, não de aula.
Posso mapear o conteúdo inteiro em unidades temáticas primeiro, e depois
escrever nota por nota conforme você avança. A organização sai por assunto,
com o panorama completo — tema cortado entre duas aulas vira uma nota só.
1. Mapear primeiro (/planejar) — recomendado
2. Uma nota só com o material todo
3. Deixa quieto, processa só o resto da pasta
Qual?Espere a resposta. Escolheu 2 ou 3 → siga normalmente. Aprovou o 1 →
siga a skill planejar com o material extenso, e o que acontece depois
depende do que mais tem na pasta:
- Só o material → o
planejartermina o trabalho. Pare aaulaaqui. - Material e gravação juntos (o caso comum da faculdade) → mapeie o PDF
primeiro e volte para cá, seguindo a
aulanormalmente para o áudio. A Fase 3c vai achar a unidade que o plano acabou de criar e a gravação entra enriquecendo ela, em vez de virar nota solta.
Nunca abandone a gravação por causa do PDF, e nunca peça pro Dantas separar os arquivos: ele joga tudo na mesma pasta de propósito, e resolver isso é seu.
Abaixo de 40 páginas: não pergunte nada. Sugestão que aparece toda vez vira ruído, e ele passa a aprovar no automático.
Fase 2 — Analisar
Chame o subagente escriba-analista com o caminho de trabalho/<slug>/.
Nunca leia a transcrição bruta você mesmo. São 10–15 mil palavras; é exatamente o que o subagente existe para absorver. Você trabalha a partir do dossiê que ele devolve.
Fase 3 — Rotear
scripts/indexar-vault.sh > trabalho/<slug>/indice-vault.mdDecida o destino pela cascata, parando na primeira camada que resolver:
- O que ele disse ao pedir — "processa a fila, é uma aula de Neurociência". Vence tudo: ele sabe de que curso é a aula, e nenhuma dedução
sua sobre nome de pasta ou conteúdo é melhor que isso. É o modo que ele
usa na prática — joga o material na
entrada/sem cuidar do nome e diz o curso na mensagem. - Nome da pasta de
entrada/—N+ 2.6 - …já entrega a disciplina - Mapa do
config.md— a tabela "Mapa de roteamento", incluindo apelidos - Inferência — a disciplina do dossiê contra as pastas reais do índice
A camada 0 diz o curso, não o título da nota nem a unidade — esses ainda saem do dossiê. E ela vale só para o que ele nomeou: disse "é uma aula de Neurociência" com três aulas na fila? Vale para a de Neurociência; as outras seguem a cascata normal, e se não der pra saber qual é qual, pergunte.
Ambíguo entre duas pastas plausíveis → pergunte, uma vez, e depois
adicione a regra ao config.md para não perguntar de novo.
Sem confiança nenhuma → 00 - Inbox/, com este bloco logo abaixo do H1:
> [!todo] Escriba não soube rotear
> Considerei: `<pasta A>`, `<pasta B>`. Nenhuma bateu com confiança.
> Me diga o destino certo e eu movo (e aprendo a regra).Subpasta temática. Se a disciplina de destino tiver subpastas por assunto, escolha a que casa com o conteúdo da nota — não com a data nem com o número da aula. Nenhuma serve e o tema justifica um grupo novo? Crie a subpasta e registre isso no relatório final.
Disciplina nova no topo de 02 - Areas/Estudos/ → pergunte antes.
Nomeie o arquivo pela convenção da pasta de destino — veja
referencias/regras-do-vault.md e, na dúvida, imite os arquivos vizinhos.
Fase 3b — Você pode escrever nesse destino?
Confira antes de qualquer trabalho:
scripts/posso-escrever.sh "<caminho relativo no vault>" # 0 = pode · 1 = nãoEle aplica a lista de permissões (regra 7) e o bloqueio de outros agentes (regra 8). Bloqueado → pare. Não escreva, não crie subpasta, não mova nada:
⛔ Esta aula é de Network+, que pertence ao agente tutor-cybersec.
Não vou escrever no vault. O material segue em entrada/ — leve para:
~/Documents/AGENTES/ATIVOS/tutor-cybersec/
(a transcrição já pronta está em trabalho/<slug>/, se ajudar)Ler essas pastas continua permitido — para validar [[links]] e imitar
formato. O que não pode é escrever.
Fase 3c — Nota nova, ou continuação de uma que já existe?
A pergunta que faz "organizar por conteúdo" funcionar. Sem ela, cada aula que entra vira uma nota, e a pasta acaba organizada por aula — que é exatamente o que ele não quer.
Aula cortada no meio pelo horário e retomada na seguinte é um assunto. O professor dividiu por relógio; a nota se divide por tema.
Levante o que a pasta já tem — só os conceitos-chave, não as notas inteiras:
for f in "$VAULT/<pasta de destino>"/*.md; do
[[ -e "$f" ]] || continue
printf '\n── %s\n' "$(basename "$f" .md)"
awk '/^## Conceitos-Chave/,/^---$/' "$f" | grep '^- ' | cut -c1-110
doneCompare com o dossiê desta aula e decida:
| Situação | O que fazer |
| Retoma ou aprofunda o mesmo conceito de uma nota existente | Enriquece aquela nota (siga a Fase 4b, caminho "enriquecer") |
| Tema vizinho, mas que se sustenta sozinho | Nota nova + [[link]] entre as duas |
| Nada relacionado | Nota nova |
O teste, para não fundir demais: existe um título que cubra as duas sem ficar mais vago que cada uma? "Sistemas lineares" cobre eliminação de Gauss e fatoração LU sem perder precisão → mesma nota. "Biologia" cobriria dopamina e sono, mas só por ser genérico → notas separadas.
Fundir demais é pior que separar demais: nota inchada esconde conteúdo, e
desfazer exige reler tudo. Na dúvida, duas notas ligadas por [[link]].
Existe plano em planos/ para este curso? Ele decide sobre a comparação
acima — foi feito com o material inteiro à vista, e esta comparação só enxerga
o que já virou nota:
ls planos/ 2>/dev/nullAchou o curso? Leia o plano, ache a unidade que cobre esta aula, e siga o que ele diz. Não tem plano — o caso normal em curso de vídeo, onde não existe material pra planejar — decida pela comparação e siga em frente.
Reporte a decisão no bloco final, sempre: Nota nova ou
Enriqueceu <nota> (continuação de <tema>).
Fase 4 — Escolher o formato
Aplique referencias/criterios-de-formato.md e anote qual regra decidiu —
ela vai no relatório final.
Leia o arquivo de formato correspondente antes de escrever:
referencias/formato-aula.md ou referencias/formato-referencia.md.
Fase 4b — Colisão de nome (verifique SEMPRE, antes de escrever)
test -e "$VAULT/<caminho da nota>" && echo COLIDEJá existe nota nesse caminho? Pare. Nunca sobrescreva — é o segundo cérebro
dele, e uma nota perdida não volta (o git revert só ajuda se ela já tinha sido
commitada).
Antes de oferecer as saídas, descubra de quem é a nota:
scripts/nota-e-minha.sh "<caminho relativo no vault>"Enriquecer é o padrão nos dois casos — a nota está num curso seu, e melhorar o que ele escreveu é o trabalho. A autoria muda só o cuidado:
- É sua → enriqueça direto.
- É dele → enriqueça também, mas preserve integralmente a
## Anotação Pessoalse estiver preenchida, e liste no relatório o que você mudou. Commit próprio.
Nota curta e solta que ele escreveu durante a aula (do tipo "anotações rápidas", sem estrutura) é matéria-prima, não nota pronta: reestruture no formato do vault, incorpore a transcrição, e mantenha a ênfase dele.
Antes de perguntar, leia a nota existente e diga em uma linha o que ela cobre. Ofereça as três saídas:
⚠️ Já existe: 02 - Areas/Estudos/Network+/Section 2 (...)/2.3 - Spanning Tree Protocol.md
(nota de 2026-07-31, fonte AI-TUTOR, cobre broadcast storm + bloqueio lógico)
Esta aula traz também: <o que é novo no dossiê>
1. Enriquecer a existente — acrescento o que é novo e reestruturo,
preservando a Anotação Pessoal (recomendado)
2. Criar ao lado — "<título> (2).md"
3. Não escrever — deixo o material em entrada/ e você decide
Qual?Enriquecer é o padrão a recomendar. É o que preserva o trabalho dele. Ao enriquecer:
- Nunca toque na
## Anotação Pessoal— mesmo que ele já a tenha preenchido. Principalmente nesse caso. - Acrescente conceitos-chave novos; não reescreva os que já existem
- Marque dúvidas que a aula nova resolveu, em vez de apagá-las
- Mensagem de commit:
escriba: enriquece <título> (<disciplina>)
Fase 4c — Ele já anotou algo sobre esta aula?
Ele anota durante a aula pra fixar, e conta com você pra transformar aquilo na nota definitiva. Procure em dois lugares — e ele não precisa te avisar, achar isso é seu trabalho.
O critério é estrutural, não de tamanho: anotação rápida não tem frontmatter nem as seções do template. Nota curta e bem formatada não é matéria-prima.
solta() {
for f in "$1"/*.md; do
[[ -e "$f" ]] || continue
[[ "$(basename "$f")" == README.md ]] && continue
head -1 "$f" | grep -q '^---$' && continue # tem frontmatter
grep -q '^## ' "$f" && continue # tem seções
# Despejo de anexos/links é nota legítima sem estrutura, não rascunho.
# Se metade das linhas é ![[...]] ou http, não é anotação de aula.
L=$(grep -c . "$f"); A=$(grep -cE '!\[\[|https?://' "$f")
(( L > 0 && A * 2 >= L )) && continue
printf '%s\n' "$f"
done
}
solta "$VAULT/<pasta de destino>" # 1. na pasta do curso
solta "$VAULT/00 - Inbox" # 2. no InboxO filtro de links existe por um caso real: Exercicios para a AP2.md não tem
frontmatter nem seções, mas é uma lista de PDFs de exercício — nota legítima.
Tratá-la como matéria-prima faria você reescrevê-la.
O Inbox é o caso mais provável. O GUIA-DO-SISTEMA.md dele manda, para
aula em vídeo: "Não para o vídeo para anotar. Anota só gatilhos no Inbox."
No Inbox, cuidado: nem toda nota solta é desta aula. Gastos.md e
Lista de desejos princesa.md moram lá. Confirme pelo assunto antes de
incorporar, e na dúvida pergunte:
Achei "00 - Inbox/DHCP e DNS.md" — 6 linhas soltas, parece ser desta aula.
Incorporo na nota e removo do Inbox? (o Inbox deve terminar vazio,
pelo seu guia)Incorporou uma nota do Inbox? Ofereça mover ou apagar — o guia dele diz que o Inbox deve ser processado até esvaziar. Deixar a anotação lá depois de absorvida cria duplicata.
Achou? Ela é matéria-prima, não concorrente. O certo é enriquecê-la até virar a nota definitiva — não criar uma segunda nota ao lado e deixar a dele órfã. Incorpore a ênfase dela: o que ele anotou no calor da aula é o que ele achou importante.
Fase 5 — Escrever
Escreva a nota em português do Brasil, mesmo se a aula for em inglês — e mesmo se o material for em português de Portugal, que é caso real: o slide de Segurança Cibernética do IBMEC diz "utilizadores", "sistema operativo", "encriptação". Traduza para o vocabulário dele (usuários, sistema operacional, criptografia). Copiar o termo do material deixa a nota com cara de fonte estrangeira dentro de um vault que é todo pt-BR.
Regras que não se negociam:
## Anotação Pessoal: em nota nova, nasce vazia — blockquote da pergunta e linhas em branco, nada mais. Em nota que ele já preencheu, você pode polir (typo, clareza, ritmo) desde que preserve a ideia dele, na primeira pessoa e no vocabulário dele, sem inflar o tamanho. Ideia errada: polir e acrescentar o callout de correção. Ver regra 1 doCLAUDE.md.- Todo
[[link]]aponta pra arquivo que existe. Valide contratrabalho/<slug>/indice-vault.md. Link para nota inexistente só assim:[[Nome]] *(nota ainda não criada)* - Não invente conteúdo para cobrir lacuna do dossiê. Fonte ruim →
nota mais curta, com aviso honesto logo abaixo do H1:
> [!warning] Transcrição de baixa qualidade > O áudio rendeu pouco. Esta nota cobre <o que deu>; falta <o que não deu>. - Incorpore a ênfase do Dantas quando houver
GATILHOS.md— o que ele marcou vira seção própria ou ganha destaque, não fica diluído. - Imprecisões detectadas pelo dossiê entram corrigidas, com a correção sinalizada. As notas dele são "corrigidas onde necessário", não fiéis ao erro.
Se a pasta de destino tiver 00 - Índice.md, acrescente a linha nova na
tabela — sem reescrever o resto do arquivo.
Fase 5b — A nota tem o tamanho que o conteúdo pedia?
scripts/medir-nota.sh "$VAULT/<caminho da nota>"Ele põe a nota ao lado das irmãs da pasta e mostra total, Conceitos-Chave,
palavras por conceito e o tamanho de cada subseção. Não dá veredito de
propósito: as notas dele vão de 304 a 1285 palavras, de 13 a 54 palavras por
conceito, e uma delas tem subseções de 146·145·171·225·186. Envelope largo
assim não sustenta limiar — a primeira versão deste script cortava por número
e acusava 16 notas dele como excesso.
Leia os números contra a faixa das irmãs, e contra a fonte:
- Fora da faixa das irmãs não é erro, mas exige motivo. Aula longa e densa justifica nota maior; abertura motivacional de 6 minutos não.
- Pasta sem irmãs → compare com o grupo cuja fonte se parece (vídeo curto, aula de 1h40, várias aulas juntas), não com o vault inteiro.
- Subseções todas do mesmo tamanho costuma ser ritmo, não conteúdo: assunto tem peso diferente. Mas veja o contraexemplo acima antes de mexer — pode ser um caso em que cada tópico realmente pesa igual.
Achou excesso? Corrija antes de commitar: funda subseção que só existe por
simetria. Nunca compense fonte magra com estrutura — a regra 2 do CLAUDE.md
vale também para inventar volume.
Fase 5c — A estrutura do curso ainda serve?
Checagem barata, depois de escrever. Se a pasta do curso passou de 15 notas sem nenhuma subpasta, ou se um grupo já concentra mais de 60% delas, mencione — uma linha, sem interromper:
💡 Engenharia de dados chegou a 17 notas, todas soltas. Quer que eu agrupe
por assunto? (/organizar)Sugira, não faça. E não repita a cada aula — se ele disser não, respeite até a pasta crescer bem mais.
Fase 6 — Commitar
Só se config.md → commit_automatico: true.
VAULT="$(grep '^vault:' config.md | sed 's/^vault: //')"
NOTA="<caminho relativo da nota no vault>"
for i in 1 2 3 4 5; do
if git -C "$VAULT" add "$NOTA" 2>/dev/null; then break; fi
sleep 2 # o plugin Obsidian Git pode estar segurando o index.lock
done
git -C "$VAULT" commit -m "escriba: <título> (<disciplina>)" -- "$NOTA" \
|| git -C "$VAULT" log -1 --oneline -- "$NOTA"-- "$NOTA"não é opcional. Sem o pathspec o commit varre tudo que o Dantas tiver aberto e sujo no Obsidian.nothing to commitsignifica que o plugin ganhou a corrida e já engoliu a nota numvault backup. Reporte isso, não trate como erro.- Nunca
git push. O push é dele.
Depois: mv "entrada/<nome>" "arquivo/<nome>". Mantenha trabalho/<slug>/.
Fase 7 — Registrar a fricção
Antes do relatório, some o que travou nesta execução e anote:
scripts/anotar.sh "<uma linha>" <op|bug|regra|?|+>Anote se você perguntou algo, hesitou entre dois destinos ou formatos, uma fonte falhou, ou um caminho foi bloqueado. Nada travou? Não anote — diário cheio de "correu bem" esconde o que importa.
Relatório final — obrigatório, sempre
Termine toda execução com este bloco. Nunca enterrado no meio de um texto longo, nunca omitido porque a confiança era alta:
✅ Nota salva
📁 <pasta de destino>
📄 <nome do arquivo>.md
Formato: <formato> (<qual regra decidiu>)
Roteado por: <camada 0 | 1 | 2 | 3 | fallback do Inbox> — <o que decidiu>
Nota: <nova | enriqueceu "<título>", continuação de <tema>>
Confiança: <alta | média | baixa>
Commit: <mensagem> [não enviado ao GitHub]
Errado? Diga "move pra <pasta>" — eu corrijo o arquivo, os links e a regra.Logo depois do bloco, sempre, o inventário do que mudou no vault:
scripts/o-que-mudei.sh <sha do commit>Cole a saída inteira. Ela vem do git diff, não da sua memória — e é onde ele
confere se você respeitou a ## Anotação Pessoal dele.
A linha Roteado por é o que permite ele consertar a causa e não só o
sintoma. Nunca a omita.
Abaixo do bloco, em duas ou três linhas: conceitos-chave registrados, links criados, dúvidas em aberto, imprecisões corrigidas, e o que ficou de fora.
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.

