bib-hygienelisted
Install: claude install-skill ymurat/academic-agent-skills
# Bibliography hygiene (BibTeX and Zotero)
Keeps reference files correct. `citation-check` verifies that a claim matches its source; this skill fixes the reference records themselves.
## Sources in `resources/`
- Upstream (MIT, credit: K-Dense Inc., https://github.com/K-Dense-AI/scientific-agent-skills): `../../common/citation-management/` (scripts `doi_to_bibtex.py`, `validate_citations.py`, `format_bibtex.py`, `extract_metadata.py`, `search_openalex.py`) and `resources/bib-hygiene/upstream/pyzotero/` (Zotero Web API notes).
- Safety review: `resources/bib-hygiene/README.md`. Scripts call only scholarly APIs (Crossref, DOI, DataCite, OpenAlex, PubMed, arXiv). Do not use `search_google_scholar.py`.
## Workflow
1. **Inventory.** Copy the user's `.bib` (or Zotero export) to `./work/bib/`; never edit the original. Count entries, types, missing DOIs.
2. **Duplicates.** Match on DOI, then normalised title plus first author plus year. List candidate merges; merge only after the user confirms.
3. **Complete and validate.** For each entry with a DOI run `validate_citations.py`; for entries without a DOI search Crossref or OpenAlex by title and propose a DOI only when title, first author and year all match. Flag mismatches (wrong year, page range, journal name, preprint cited instead of published version).
4. **Normalise.** Consistent keys (`firstauthorYEARword`), braces for acronyms and proper nouns in titles (`{UML}`, `{T{\"u}rkiye}`), Turkish characters as UTF-8 with `biblatex`/