Devs & IA
/cookbook-auditProgramação

Auditar notebook e código de exemplo com rubrica

Revisa notebooks e receitas contra critérios objetivos de qualidade — útil para qualquer material técnico que outras pessoas vão seguir.

Para: Quem escreve material técnico

O que é

Nasceu para auditar os notebooks do cookbook da Anthropic, mas o valor é mais amplo: ela aplica uma rubrica — um conjunto fixo de critérios — a material técnico de exemplo. Roda tudo? As dependências estão declaradas? O exemplo funciona isolado? O erro está tratado? Há explicação do porquê ou só do como?

A ideia de rubrica é o que faz diferença. Revisão sem critério fixo vira opinião do revisor do dia; com rubrica, dois materiais são avaliados pelo mesmo régua e a comparação faz sentido.

Quando usar

  • Antes de publicar tutorial, notebook ou exemplo de código
  • Ao revisar material que outra pessoa escreveu e você quer critério, não gosto
  • Para padronizar a qualidade de uma pasta de exemplos que cresceu sem controle

Quando não usar

  • Em código de produção — a rubrica é de material didático, não de aplicação
  • Quando o problema é o conteúdo estar errado: rubrica avalia forma e completude, não te salva de ensinar algo incorreto

O erro mais comum

Tratar a nota da rubrica como objetivo. Material que passa em todos os critérios e continua confuso para quem lê não é bom material. A rubrica pega o que é verificável; a clareza ainda depende de alguém ler com olhos de iniciante.

Instalação

$ npx skills add anthropics/skills
Ver o repositório de origem ↗

Outras skills de Programação