agentleFS
dantas6773dantas6773/escriba/.claude/skills/aula/SKILL.md

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

  • Other versions1 project uses a version of this.

    Word for word · 0

    None found.

    Edited · 0

    None found.

    Wrote their own version · 1

    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.

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
  1. Very specific:

    Reporte a decisão: no bloco final, sempre: Nota nova ou Enriqueceu <nota> (continuação de <tema>).

    line 232
  2. Very specific:

    No Inbox, cuidado: nem toda nota solta é desta aula.

    line 333

≈ “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.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

/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 em fonte.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}')"
done

40 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 planejar termina o trabalho. Pare a aula aqui.
  • Material e gravação juntos (o caso comum da faculdade) → mapeie o PDF primeiro e volte para cá, seguindo a aula normalmente 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.md

Decida o destino pela cascata, parando na primeira camada que resolver:

  1. 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.
  2. Nome da pasta de entrada/ — N+ 2.6 - … já entrega a disciplina
  3. Mapa do config.md — a tabela "Mapa de roteamento", incluindo apelidos
  4. 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ão

Ele 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
done

Compare com o dossiê desta aula e decida:

SituaçãoO que fazer
Retoma ou aprofunda o mesmo conceito de uma nota existenteEnriquece aquela nota (siga a Fase 4b, caminho "enriquecer")
Tema vizinho, mas que se sustenta sozinhoNota nova + [[link]] entre as duas
Nada relacionadoNota 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/null

Achou 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 COLIDE

Já 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 Pessoal se 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 Inbox

O 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:

  1. ## 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 do CLAUDE.md.
  2. Todo [[link]] aponta pra arquivo que existe. Valide contra trabalho/<slug>/indice-vault.md. Link para nota inexistente só assim: [[Nome]] *(nota ainda não criada)*
  3. 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>.
  4. 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.
  5. 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 commit significa que o plugin ganhou a corrida e já engoliu a nota num vault 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.

Download now (ZIP)

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
What did you use it for? e.g. Reviewing pull requests in a Rails app

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.