Przejdź do treści
Biblioteka skilli
Nauka i badania · Przegląd i audyt

paper-bib

/paper-bib

Pilnuje porządku w BibTeX i bibliotece PDF: nazwy plików, duplikaty, pola sprawdzone względem PDF i DOI.

Repozytorium
benz-skills ↗
Licencja
MIT
Ostatnia zmiana repozytorium
10.11.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
3
Skrypty
2
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 10.11.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co sprawdzić przed instalacją
  • 2 skrypty w paczce. Przejrzyj je przed instalacją, bo Claude może je uruchomić.

Skrypty: scripts/find_dup_pdfs.py, scripts/ris2bib.py

Co robi i kiedy

Pilnuje porządku w BibTeX i bibliotece PDF: nazwy plików, duplikaty, pola sprawdzone względem PDF i DOI.

Oryginalny opis (EN)

BibTeX and PDF-library hygiene - the Lastname_etal_YYYY filename and key convention, duplicate checks (hash, same stem, same author+year), every field verified against the PDF and DOI, RIS-to-BibTeX conversion, no invented fields, no ghost keys. Use when adding a paper or bib entry, importing .ris/.bib from a publisher, moving PDFs from inspiring_papers into mypaper, or before compiling a manuscript.

Jak działa

  1. The convention (measured on mybible's 866 PDFs, 2026-11-09)
  2. Steps to add a paper
  3. Rules
Sekcje z nagłówków SKILL.md, w oryginale · 47 linii, 428 słów
Podgląd SKILL.md
---
name: paper-bib
description: BibTeX and PDF-library hygiene - the Lastname_etal_YYYY filename and key convention, duplicate checks (hash, same stem, same author+year), every field verified against the PDF and DOI, RIS-to-BibTeX conversion, no invented fields, no ghost keys. Use when adding a paper or bib entry, importing .ris/.bib from a publisher, moving PDFs from inspiring_papers into mypaper, or before compiling a manuscript.
---

# paper-bib

## The convention (measured on mybible's 866 PDFs, 2026-11-09)

| authors | file / key | examples |
|---|---|---|
| one | `Lastname_YYYY` | `Biondi_2006` |
| two | `Lastname_Lastname_YYYY` | `Virieux_Operto_2009` |
| three or more | `Lastname_etal_YYYY` | `Kukreja_etal_2022` |
| collision | suffix `a`, `b` | `Amestoy_etal_2023a`, `Klöwer_etal_2021b` |
| rare disambiguator | `_<topic>` after the year | `Li_etal_2025_sep` |
| supplementary material | `_sup` after the year (no bib key of its own) | `Yuan_etal_2024_sup` |

The **bib key equals the PDF stem**. Particles stay as written with underscores (`van_den_Berg_...`,
`de_Ridder_...`). Prefer ASCII in new file names (existing names with accents, e.g. `Klöwer`, `Váňa`,
are kept; never rename a file other docs cite without updating them). Bibliographies: `mypaper/mybible/`
`fwi_ref.bib`, `alg_ref.bib`, `das_ref.bib`, `cs_ref.bib`, `rocks_ref.bib`; manuscripts reuse these or keep
a local bib whose keys follow the same rule.

## Steps to add a paper

1. **Duplicates first**: `python3 scripts/find_dup_pdfs.py <new.pdf> --roots <mybible dirs> <inspiring_papers>`
   reports identical hashes, the same normalized stem (case/accents/underscores ignored) and the same
   first-author + year with another suffix. Same author+year but a different paper -> assign the next suffix
   and check every existing citation of the old key still points to the right paper.
2. **Name the file** by the convention; put it in the right folder (`fwi/` FWI and imaging, `alg/` math and
   algorithms, `das/` DAS, `etc/` other, `cs/` computing).
3. **Build the entry from the PDF**: title page and journal header first; DOI resolved (Crossref) for volume,
   issue, pages, year. Fields you cannot verify are left out, never guessed. Publisher `.ris` ->
   `python3 scripts/ris2bib.py file.ris --key <Key>`; then verify every field the same way.
4. **ASCII and escapes**: match the target bib (mybible's bibs are checked for non-ASCII: use LaTeX escapes
   such as `{\"o}`, `{\v{a}}`); protect capitals in titles with braces (`{FWI}`, `{G}auss-{N}ewton`).
5. **Check**: no duplicate keys across the five bibs (`grep -h '^@' *.bib | sort | uniq -d`); run
   `python3 scripts/check_citations.py --strict` in `mypaper/mybible` (0 ghost keys, 0 manual "(Name, year)"
   citations, 0 duplicate keys) and compile with 0 undefined citations.

## Rules

- **No ghost citations**: every `\cite` key exists, and its PDF is on disk and was read (`benz:paper-read`).
- **No manual in-text citations**: natbib `\citet`/`\citep`/`\citeauthor` everywhere, including tables,
  captions and TikZ.
- An entry added before its PDF is read carries `note = {UNVERIFIED: PDF not yet read (YYYY-MM-DD)}`, removed
  only after reading.
- Software is cited by its paper (and the repo URL in a footnote or `howpublished`), with the licence's
  citation clause honoured (e.g. occamypy: cite in the paper).
Pliki w paczce (3)
  • SKILL.md 3 KB
  • scripts/find_dup_pdfs.py 4 KB
  • scripts/ris2bib.py 5 KB

Wersje

W bazie nie ma innych skilli o nazwie paper-bib.

Migawka bazy z 13.11.2026 · wersja paczki b1445e420e6d (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 1 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 90bibtex-manager
    Utrzymuje plik BibTeX pracy: pobiera wpisy po DOI, identyfikatorze arXiv lub tytule, normalizuje klucze i usuwa duplikaty.
  • 90bib-hygiene
    Czyści bibliotekę BibTeX lub Zotero: usuwa duplikaty, uzupełnia dane z DOI i sprawdza je w Crossref.
  • 100bib-verify
    Weryfikuje plik BibTeX pod kątem zmyślonych źródeł, porównując każdy wpis z CrossRef, arXiv i DBLP i raportując różnice w tytule, autorach, roku i DOI.
  • 10002-bib-verify
    Weryfikuje plik BibTeX pod kątem zmyślonych odwołań, porównując każdy wpis z CrossRef, arXiv i DBLP i raportując rozbieżności w tytule, autorach, roku i DOI.
  • 100bib-audit
    Wykrywa zmyślone lub błędne pozycje bibliograficzne w pracy, z pliku .bib, PDF lub wklejonej listy, sprawdza je w Crossref, arXiv i wyszukiwaniu po tytule oraz odzyskuje poprawny BibTeX wydawcy.
  • 100validate-bib
    Sprawdza zgodność pozycji bibliografii z cytowaniami we wszystkich plikach wykładów, wykrywa brakujące i błędne wpisy.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.