Skip to content

kayquer/citacoes-abnt

v1.3.0MIT

Biblioteca de citações, checador de referências (detecta referência inventada, quimérica e DOI divergente) e aplicação da ABNT vigente (NBR 6023:2025, 10520:2023, 14724:2024) com perfis de 50 universidades e institutos brasileiros.

Citações ABNT para Claude: biblioteca, checador de referências e normas de 50 universidades

Página Licença MIT ABNT

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

SkillO que faz
biblioteca-citacoesAdiciona 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-citacoesProcura 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-formatacaoAplica 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:

  1. Nada é inventado. Dado ausente vira [VERIFICAR: campo].
  2. Uma referência só é "verificada" quando duas bases independentes confirmam título e autoria.
  3. 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.

OndeComo
Claude Code/plugin marketplace add kayquer/citacoes-abnt-skill e depois /plugin install citacoes-abnt@citacoes-abnt-skill
Claude na web e no appEnvie 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 CLIgemini extensions install https://github.com/kayquer/citacoes-abnt-skill
Hermeshermes 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, OpenClawComo 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, CursorDescompacte 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 chatsCole 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.

CasoSaí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 interrogativoBENTO, 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 siglaINDEPENDENT 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
StatusSignifica
verificada2 ou mais bases confirmam título e autoria
parcialsó 1 base achou (comum em livro nacional)
nao_encontradanenhuma base achou: possível referência inventada
quimeratítulo real, autoria errada (no mesmo ano e tipo)
homonimosó há obra de mesmo título de outro autor, em outro ano ou tipo: não indica invenção
doi_divergenteDOI inexistente ou de outra obra
url_verificada / url_divergente / url_inacessivelnotícia ou site: o link responde e bate, leva a outra página, ou não respondeu
nao_verificavelnotícia sem URL ou título atribuído entre colchetes
fora_de_coberturaobra anterior a 1800 sem resultado nas bases
inconclusiva / erro_redeas 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_CACHE e CITACOES_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çãoTipoNorma principalManual oficial
USPPública (Estadual)ABNT (com diretrizes próprias USP)2024
UNICAMPPública (Estadual)ABNT2023
UFRJPública (Federal)ABNT (Vancouver em Biomédicas)2023
UFMGPública (Federal)ABNT2025
UFRGSPública (Federal)ABNTnão encontrado
UFSCPública (Federal)ABNTlink
UnBPública (Federal)ABNT / APA (Psicologia)não encontrado
UNIFESPPública (Federal)Vancouver / ABNT2024
UFPRPública (Federal)ABNT2024
UNESPPública (Estadual)ABNTnão encontrado
UFSCarPública (Federal)ABNT2023
PUC-RioPrivada (Filantrópica)ABNT / APA2020
UFPEPública (Federal)ABNT2023
UFCPública (Federal)ABNT2022
UFBAPública (Federal)ABNTnão encontrado
UFVPública (Federal)ABNT2025
UFFPública (Federal)ABNT2012
PUCRSPrivada (Filantrópica)ABNT / APAlink
UFSMPública (Federal)ABNT2021
UFPelPública (Federal)ABNT2023
UNESAPrivada (Lucrativa)ABNT2019
UNIPPrivada (Lucrativa)ABNT2025
UNOPARPrivada (Lucrativa)ABNTnão encontrado
UFMAPública (Federal)ABNTnão encontrado
UFPAPública (Federal)ABNT2023
UFGPública (Federal)ABNT2016
UFRNPública (Federal)ABNT / Vancouver2022
UNICSULPrivada (Lucrativa)ABNTnão encontrado
UNINOVEPrivada (Lucrativa)ABNT / Vancouver (Medicina)2025
UFAMPública (Federal)ABNT2017
UFUPública (Federal)ABNT2025
UFPIPública (Federal)ABNT2025
UFPBPública (Federal)ABNT2023
UFALPública (Federal)ABNT2025
UFMTPública (Federal)ABNTnão encontrado
UEMPública (Estadual)ABNTnão encontrado
UELPública (Estadual)ABNT2025
UERJPública (Estadual)ABNT2012
Anhembi MorumbiPrivada (Lucrativa)ABNT / APA2024
UNISINOSPrivada (Filantrópica)ABNT2024
IFSPInstituto FederalABNT (Geral) / APA (Áreas Tecnológicas específicas)2011
FATECFaculdade de TecnologiaABNT2024
IFRJInstituto FederalABNT / Vancouver (Cursos da área de Saúde)2025
IFMGInstituto FederalABNT2020
IFRSInstituto FederalABNT2019
IFSCInstituto FederalABNT2025
IFPRInstituto FederalABNT2023
IFCEInstituto FederalABNT2020
IFPEInstituto FederalABNTnão encontrado
IFBInstituto FederalABNT2017

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:

  1. Altere a entrada em data/pesquisa/grupo*.json, com a URL do manual e o campo conferido_em.
  2. Rode py -3 tools/build.py e py -3 -m unittest discover tests.
  3. 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:

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.