Citações ABNT para Claude: biblioteca, checador de referências e normas de 50 universidades
Plugin com três skills para Claude Code, Claude na web, ChatGPT, Gemini e outros agentes:
- organiza suas referências numa biblioteca;
- descobre referência inventada por IA;
- aplica a ABNT vigente com as regras do manual da sua universidade.
Feito para quem escreve TCC, dissertação, tese, projeto de pesquisa ou artigo no Brasil.
Página com as regras de cada instituição: https://kayquer.github.io/citacoes-abnt-skill/
Sumário
Sobre
| Skill | O que faz |
|---|---|
biblioteca-citacoes | Adiciona obras por DOI, ISBN ou URL e importa .bib, .ris e CSL-JSON. Remove duplicatas. Gera a chamada (Silva, 2020, p. 15) e exporta a lista em ABNT, BibTeX, RIS ou CSL-JSON (Zotero, Mendeley, Pandoc). |
checador-citacoes | Procura cada referência no Crossref, OpenAlex, Semantic Scholar, Open Library e Google Books. Aponta referência inexistente, quimera (título real com autor errado), DOI que leva a outra obra, chamada sem referência e referência nunca citada. |
abnt-formatacao | Aplica NBR 14724:2024, 10520:2023, 6023:2025 (ou 2018), 6024, 6027 e 6028 com o perfil da instituição. Gera um modelo .docx com margens, fonte, espaçamento, estilos e paginação. |
Três regras valem para todas as skills:
- Nada é inventado. Dado ausente vira
[VERIFICAR: campo]. - Uma referência só é "verificada" quando duas bases independentes confirmam título e autoria.
- O manual da instituição vem antes da norma, e a norma antes do costume. Quando o manual cita uma edição antiga da norma, a skill avisa e pergunta.
Os scripts são Python 3 e usam só a biblioteca padrão. Funcionam também sem o Claude.
Instalação
As skills seguem o padrão aberto Agent Skills e funcionam fora do Claude Code. Os pacotes ficam em dist/ e são gerados por tools/build.py. O passo a passo com links de download está na página do projeto.
| Onde | Como |
|---|---|
| Claude Code | /plugin marketplace add kayquer/citacoes-abnt-skill e depois /plugin install citacoes-abnt@citacoes-abnt-skill |
| Claude na web e no app | Envie checador-citacoes.zip, biblioteca-citacoes.zip e abnt-formatacao.zip em Configurações › Capacidades › Skills, com a execução de código ativada |
| ChatGPT (GPT ou Projeto) | Cole instrucoes.txt nas instruções. Anexe conhecimento-instituicoes.md e conhecimento-normas.md. Ative a busca na web. Para usar os scripts, anexe citacoes-abnt-scripts.zip e ative a análise de código |
| Gemini (Gem) | Igual ao ChatGPT: instruções mais os dois arquivos de conhecimento |
| Gemini CLI | gemini extensions install https://github.com/kayquer/citacoes-abnt-skill |
| Hermes | hermes plugins install kayquer/citacoes-abnt-skill e depois hermes plugins enable citacoes-abnt. O Hermes lê o plugin.json da raiz (formato Agent Plugins v1) e instala o plugin desativado. Como skill avulsa: descompacte citacoes-abnt-skills.zip em ~/.hermes/skills/ |
| Codex, Copilot CLI, OpenClaw | Como plugin, pelo mesmo .claude-plugin/plugin.json do Claude Code. Como skill: descompacte citacoes-abnt-skills.zip em .agents/skills/ no projeto ou em ~/.agents/skills/ (o OpenClaw também lê ~/.openclaw/skills/) |
| OpenCode, Cursor | Descompacte citacoes-abnt-skills.zip em .agents/skills/ no projeto (o OpenCode também lê .opencode/skills/ e ~/.config/opencode/skills/). O OpenCode não instala plugin de manifesto, só skill. Sem suporte a skills, salve citacoes-abnt-agents.md como AGENTS.md, GEMINI.md ou regra do Cursor |
| Perplexity, Copilot e outros chats | Cole instrucoes.txt nas instruções do espaço e anexe os arquivos de conhecimento |
No Claude Code, as skills aparecem a partir da sessão seguinte à instalação. Depois de instalar ou atualizar, reinicie o Claude Code ou abra uma nova sessão.
A checagem de existência depende de acesso à internet: busca na web no chat, ou os scripts com rede. Sem acesso, o assistente avisa que não conseguiu verificar e não marca nenhuma referência como verificada. Formatar e conferir citação × referência funcionam sem internet.
Para usar só os scripts:
git clone https://github.com/kayquer/citacoes-abnt-skill
cd citacoes-abnt-skill
python3 scripts/biblioteca.py --help # no Windows: py -3
Uso
Pedidos ao Claude
- "Confira se as referências deste TCC existem." (anexe o .docx)
- "Formate estas referências no padrão da UFMG."
- "Adiciona o DOI 10.1038/nature14539 na bibliografia e me dá a citação da página 438."
- "Gera o modelo Word de dissertação da USP."
- "Qual a margem e a fonte exigidas pela PUC-Rio?"
Antes e depois
Chamadas pela NBR 10520:2023:
- Segundo SILVA (2020) a escola é diálogo (SOUZA; LIMA, 2019, s.p.).
+ Segundo Silva (2020), a escola é diálogo (Souza; Lima, 2019).
Referência pela NBR 6023:
- IBGE. Censo 2022. Disponível em: <https://censo2022.ibge.gov.br>. Acesso em: 10 janeiro 2024.
+ INSTITUTO BRASILEIRO DE GEOGRAFIA E ESTATÍSTICA. **Censo 2022**. Rio de Janeiro, 2023. Disponível em: https://censo2022.ibge.gov.br. Acesso em: 10 jan. 2024.
Humanidades: tradução, obras completas, jornal e notas de rodapé
O formatador tem campos para os casos que mais aparecem em livros de humanidades. Não é preciso escrever código por fora nem pôr esses dados em nota. O exemplo completo está em tests/fixtures/biblioteca-humanidades.json. Os dados desse arquivo servem para testar a forma: confira cada obra antes de usar como referência.
| Caso | Saída |
|---|---|
Capítulo nas obras completas do próprio autor (in_mesmo_autor, volume_obra) | FREUD, Sigmund. Luto e melancolia. In: FREUD, Sigmund. **Obras completas**. Tradução: Paulo César de Souza. São Paulo: Companhia das Letras, 2010a. v. 12, p. 170-194. Publicação original: 1917. |
Clássico com organizador da edição (organizacao, tradutor, ano_original) | HOBBES, Thomas. **Leviatã**: [...]. Tradução: João Paulo Monteiro e Maria Beatriz Nizza da Silva. Organização: Richard Tuck. São Paulo: Martins Fontes, 2003. Título original: Leviathan. Publicação original: 1651. |
Artigo com e-localização (eloc) e título interrogativo | BENTO, Berenice. Necrobiopoder: quem pode habitar o Estado-nação? **Cadernos Pagu**, Campinas, n. 53, e185305, 2018. DOI: [...] |
Jornal com data completa (tipo jornal) | OTTA, Lu Aiko. Parcela do Tesouro [...]. **O Estado de S. Paulo**, São Paulo, ano 131, n. 42656, 1 ago. 2010. Economia & Negócios, p. B1. |
Obra sem título (titulo_atribuido) | SWIFT, Jonathan. [Sobre a mentira política]. **The Examiner**, London, n. 14, 9 nov. 1710. |
| Entidade citada pela sigla | INDEPENDENT INVESTIGATIVE MECHANISM FOR MYANMAR (IIMM). **Annual report**. [S. l.], 27 mar. 2024. [...] e (IIMM, 2024) |
Notas de rodapé: a primeira citação de cada obra sai completa, e as seguintes saem abreviadas.
$ python3 scripts/biblioteca.py --arquivo biblioteca.json notas "freud2010luto:172, freud2010luto:180, hobbes2003leviata:cap. XIII"
1. FREUD, Sigmund. Luto e melancolia. In: FREUD, Sigmund. **Obras completas**. [...] 2010a. v. 12, p. 172. Publicação original: 1917.
2. FREUD, 2010a, p. 180.
3. HOBBES, Thomas. **Leviatã**: [...]. Organização: Richard Tuck. São Paulo: Martins Fontes, 2003. cap. XIII. [...]
Com --expressoes-latinas, a segunda nota vira *Ibid.*, p. 180. O conferidor lê as notas do .docx e do Markdown ([^n]:), conta como citada a obra que só aparece em nota e avisa quando a primeira citação vem abreviada.
Checador
$ python3 scripts/checar_referencias.py tests/fixtures/referencias-mistas.md
[1] VERIFICADA: LECUN, Yann; BENGIO, Yoshua; HINTON, Geoffrey. Deep learning. ...
confirmada em: crossref, openalex, openlibrary
[6] DOI_DIVERGENTE: KOWALCZYK, Martin; ODUYA, Grace. Recursive transformer distillation ...
- DOI não existe no Crossref
[7] QUIMERA: SOUZA, Marcos Antônio; PEREIRA, Juliana Costa. Attention is all you need. ...
- o título existe, mas a autoria não bate com nenhuma base
| Status | Significa |
|---|---|
verificada | 2 ou mais bases confirmam título e autoria |
parcial | só 1 base achou (comum em livro nacional) |
nao_encontrada | nenhuma base achou: possível referência inventada |
quimera | título real, autoria errada (no mesmo ano e tipo) |
homonimo | só há obra de mesmo título de outro autor, em outro ano ou tipo: não indica invenção |
doi_divergente | DOI inexistente ou de outra obra |
url_verificada / url_divergente / url_inacessivel | notícia ou site: o link responde e bate, leva a outra página, ou não respondeu |
nao_verificavel | notícia sem URL ou título atribuído entre colchetes |
fora_de_cobertura | obra anterior a 1800 sem resultado nas bases |
inconclusiva / erro_rede | as bases não responderam |
Em lista longa, --saida checagem.jsonl grava cada obra assim que termina e mostra o progresso ([12/92] verificada: ...). Se a rodada cair ou esbarrar no limite das bases, --retomar refaz só o que faltou. As respostas ficam em cache por 30 dias em ~/.cache/citacoes-abnt.
Scripts
python3 scripts/biblioteca.py adicionar --doi 10.1590/0102-4698214500
python3 scripts/biblioteca.py citar <id> --pagina 45
python3 scripts/biblioteca.py notas "id:pág, id:pág" [--expressoes-latinas]
python3 scripts/biblioteca.py [--edicao-6023 2018] [--et-al] exportar --formato abnt|bib|ris|csl --saida refs.md
python3 scripts/checar_referencias.py trabalho.docx [--json] [--saida checagem.jsonl [--retomar]]
python3 scripts/conferir_citacoes.py trabalho.docx [--edicao-10520 2002] [--sem-notas]
python3 scripts/gerar_modelo_docx.py --instituicao usp --tipo tcc|dissertacao|tese|artigo|projeto --saida modelo.docx
As opções globais (--arquivo, --edicao-6023, --edicao-10520, --et-al) vão antes do subcomando.
Variáveis opcionais:
CROSSREF_MAILTO: pool educado do Crossref;OPENALEX_API_KEY: chave gratuita do OpenAlex. Sem ela, o OpenAlex usa uma cota diária dividida por todos no mesmo IP. Quando a cota acaba, a base fica de fora da rodada;S2_API_KEY: limite maior no Semantic Scholar;GOOGLE_BOOKS_KEY: o Google Books limita consultas anônimas;CITACOES_ABNT_CACHEeCITACOES_ABNT_SEM_CACHE=1: mudam a pasta do cache e o desligam.
Sem as chaves, nada é enviado além da própria consulta.
Instituições
As 50 instituições têm perfil de formatação. São 40 universidades, entre as maiores e as mais bem avaliadas, e 10 instituições técnicas (institutos federais e Fatec). Para 40 delas, o perfil foi levantado no manual oficial, com o link e a data da consulta. O que o manual não especifica vem do padrão ABNT, e o perfil indica isso.
| Instituição | Tipo | Norma principal | Manual oficial |
|---|---|---|---|
| USP | Pública (Estadual) | ABNT (com diretrizes próprias USP) | 2024 |
| UNICAMP | Pública (Estadual) | ABNT | 2023 |
| UFRJ | Pública (Federal) | ABNT (Vancouver em Biomédicas) | 2023 |
| UFMG | Pública (Federal) | ABNT | 2025 |
| UFRGS | Pública (Federal) | ABNT | não encontrado |
| UFSC | Pública (Federal) | ABNT | link |
| UnB | Pública (Federal) | ABNT / APA (Psicologia) | não encontrado |
| UNIFESP | Pública (Federal) | Vancouver / ABNT | 2024 |
| UFPR | Pública (Federal) | ABNT | 2024 |
| UNESP | Pública (Estadual) | ABNT | não encontrado |
| UFSCar | Pública (Federal) | ABNT | 2023 |
| PUC-Rio | Privada (Filantrópica) | ABNT / APA | 2020 |
| UFPE | Pública (Federal) | ABNT | 2023 |
| UFC | Pública (Federal) | ABNT | 2022 |
| UFBA | Pública (Federal) | ABNT | não encontrado |
| UFV | Pública (Federal) | ABNT | 2025 |
| UFF | Pública (Federal) | ABNT | 2012 |
| PUCRS | Privada (Filantrópica) | ABNT / APA | link |
| UFSM | Pública (Federal) | ABNT | 2021 |
| UFPel | Pública (Federal) | ABNT | 2023 |
| UNESA | Privada (Lucrativa) | ABNT | 2019 |
| UNIP | Privada (Lucrativa) | ABNT | 2025 |
| UNOPAR | Privada (Lucrativa) | ABNT | não encontrado |
| UFMA | Pública (Federal) | ABNT | não encontrado |
| UFPA | Pública (Federal) | ABNT | 2023 |
| UFG | Pública (Federal) | ABNT | 2016 |
| UFRN | Pública (Federal) | ABNT / Vancouver | 2022 |
| UNICSUL | Privada (Lucrativa) | ABNT | não encontrado |
| UNINOVE | Privada (Lucrativa) | ABNT / Vancouver (Medicina) | 2025 |
| UFAM | Pública (Federal) | ABNT | 2017 |
| UFU | Pública (Federal) | ABNT | 2025 |
| UFPI | Pública (Federal) | ABNT | 2025 |
| UFPB | Pública (Federal) | ABNT | 2023 |
| UFAL | Pública (Federal) | ABNT | 2025 |
| UFMT | Pública (Federal) | ABNT | não encontrado |
| UEM | Pública (Estadual) | ABNT | não encontrado |
| UEL | Pública (Estadual) | ABNT | 2025 |
| UERJ | Pública (Estadual) | ABNT | 2012 |
| Anhembi Morumbi | Privada (Lucrativa) | ABNT / APA | 2024 |
| UNISINOS | Privada (Filantrópica) | ABNT | 2024 |
| IFSP | Instituto Federal | ABNT (Geral) / APA (Áreas Tecnológicas específicas) | 2011 |
| FATEC | Faculdade de Tecnologia | ABNT | 2024 |
| IFRJ | Instituto Federal | ABNT / Vancouver (Cursos da área de Saúde) | 2025 |
| IFMG | Instituto Federal | ABNT | 2020 |
| IFRS | Instituto Federal | ABNT | 2019 |
| IFSC | Instituto Federal | ABNT | 2025 |
| IFPR | Instituto Federal | ABNT | 2023 |
| IFCE | Instituto Federal | ABNT | 2020 |
| IFPE | Instituto Federal | ABNT | não encontrado |
| IFB | Instituto Federal | ABNT | 2017 |
Os dados estão em data/instituicoes.json. Os perfis lidos pela skill ficam em skills/abnt-formatacao/references/instituicoes/.
Estrutura do Projeto
citacoes-abnt-skill/
├── .claude-plugin/ marketplace.json e plugin.json
├── skills/
│ ├── biblioteca-citacoes/SKILL.md
│ ├── checador-citacoes/SKILL.md
│ └── abnt-formatacao/
│ ├── SKILL.md
│ └── references/
│ ├── normas/ NBR 6023, 10520, 14724 e vigência
│ └── instituicoes/ um perfil por instituição (gerado)
├── scripts/ abnt_lib, biblioteca, metadados, checar_referencias,
│ conferir_citacoes, documento, gerar_modelo_docx
├── data/ instituicoes.json (gerado), base dos CSVs e pesquisa nos manuais
├── tools/ build.py (perfis, site e tabela do README), site_gen.py, og_image.py
├── docs/ GitHub Pages (gerado)
├── dist/ pacotes para Claude.ai, ChatGPT, Gemini, Codex e outros (gerado)
├── portatil/instrucoes.md instruções para chats, base do pacote dist/chat/
├── gemini-extension.json manifesto da extensão do Gemini CLI
└── tests/ testes de unidade e fixtures
py -3 tools/build.py gera os perfis, o site, os pacotes de dist/ e a tabela acima a partir de data/. --verificar falha se algum arquivo gerado estiver defasado.
Testes
python3 -m unittest discover tests # 89 testes, sem rede (as bases são simuladas)
python3 tools/build.py --verificar
python3 scripts/checar_referencias.py tests/fixtures/referencias-mistas.md # teste real, com rede
A fixture referencias-mistas.md traz 3 referências reais, 3 inventadas, 1 quimera e 1 DOI de outra obra. Nenhuma das falsas pode sair como verificada.
Contribuindo
Manuais mudam. Se o perfil da sua instituição está errado ou desatualizado, abra uma issue com o link do manual oficial. Para editar direto:
- Altere a entrada em
data/pesquisa/grupo*.json, com a URL do manual e o campoconferido_em. - Rode
py -3 tools/build.pyepy -3 -m unittest discover tests. - Abra o pull request.
Para incluir uma instituição, acrescente uma linha ao CSV de origem, rode tools/importar_csv.py e depois inclua a pesquisa.
Fontes
- Edições vigentes: catálogo Target (histórico de edições) e folhas de rosto das normas. Detalhes em
vigencia.md. - Regras práticas: guias das bibliotecas da ECA-USP, UFU, UFSCar, UFV, UNESP, IFCE e Unifor.
- Perfis: manuais oficiais de cada instituição, com o link em cada perfil.
As normas ABNT são pagas. Este repositório resume as regras com palavras próprias e não reproduz o texto das normas. Não há vínculo com a ABNT nem com as instituições listadas.
Créditos
O projeto foi escrito do zero. As ideias vieram destas skills, que recebem a atribuição também nos SKILL.md e na página:
- PHY041/claude-skill-citation-checker: verificação em várias bases, critério de duas bases e detecção de quimera.
- K-Dense-AI/claude-scientific-writer,
citation-management(MIT): metadado externo tratado como dado não confiável, deduplicação e exportação. - viniciusvcgprofssional/claude-skills-academic (MIT) e ABNT Word Template Generator: papel da referência no argumento e modelo Word ABNT.
- DevAlissu/pesquisador-br-skill (MIT): um arquivo por norma, etapa bloqueante de integridade, DOI para ABNT e declaração de uso de IA.
- carlosafjr-dev/abnt-academico-skill (MIT): quadro de normas vigentes, prioridade instituição > norma > costume e conferência citação × referência.
Licenças e detalhes em THIRD_PARTY_NOTICES.md. Para citar este projeto, use o CITATION.cff.
Licença
MIT, ver LICENSE. Feito por Kayque Rotondo.