CommunitySchreiben & Editierengithub.com

Zitationsverwaltung

Umfassende Zitationsverwaltung für die akademische Forschung. Suche in OpenAlex, PubMed und Google Scholar nach Fachartikeln, extrahiere genaue Metadaten, validiere Zitate und generiere korrekt formatierte BibTeX-Einträge. Dieses Skill sollte verwendet werden, wenn du Artikel finden, Zitierinformationen überprüfen, DOIs in BibTeX konvertieren oder die Referenzgenauigkeit in wissenschaftlichen Texten sicherstellen musst.

Was ist Zitationsverwaltung?

Dieser Skill bietet ein vollständiges Toolkit zur systematischen Verwaltung von Zitationen während des gesamten Forschungs- und Schreibprozesses. Er integriert sich nahtlos in die Literaturrecherche und das wissenschaftliche Schreiben und deckt die gesamte Pipeline ab: von der Literatursuche über die Metadatenextraktion und BibTeX-Formatierung bis hin zur Zitationsvalidierung. Unterstützt werden OpenAlex, PubMed und Google Scholar als Quellen sowie CrossRef, arXiv und DataCite zur Metadatenanreicherung. Der Skill enthält mehrere Python-Skripte, die über die Kommandozeile gesteuert werden und spezifische Aufgaben wie DOI-Konvertierung, Dublettenprüfung und Validierung gegen Venue-Standards übernehmen. Die Verwendung von Umgebungsvariablen (NCBI_API_KEY, OPENALEX_API_KEY) ist optional und dient der Erhöhung von API-Ratenlimits. Der Skill betont die Vermeidung von Ein-Quellen-Bias durch die Verpflichtung zur Suche in mehreren Datenbanken und die kritische Überprüfung extrahierter Metadaten. Er ist für alle gängigen KI-Agenten-Plattformen geeignet, die Python-Skripte ausführen können, wie Claude Code, Cursor oder Codex.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/BorisW269/skills/tree/HEAD/skills/citation-management

Installed? Explore more Schreiben & Editieren skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Was macht Zitationsverwaltung?

Übersicht

Verwalte Zitationen systematisch während des gesamten Forschungs- und Schreibprozesses. Dieses Skill bietet Werkzeuge und Strategien für die Suche in akademischen Datenbanken (Google Scholar, PubMed), die Extraktion genauer Metadaten aus mehreren Quellen (CrossRef, PubMed, arXiv), die Validierung von Zitierinformationen und die Erstellung korrekt formatierter BibTeX-Einträge.

Entscheidend für die Aufrechterhaltung der Zitiergenauigkeit, die Vermeidung von Referenzfehlern und die Sicherstellung reproduzierbarer Forschung. Integriert sich nahtlos in das Literaturrecherche-Skill für umfassende Forschungs-Workflows.

Wann dieses Skill verwenden

Verwende dieses Skill, wenn:

  • Du nach bestimmten Artikeln auf Google Scholar oder PubMed suchst
  • Du DOIs, PMIDs oder arXiv-IDs in korrekt formatierte BibTeX konvertierst
  • Du vollständige Metadaten für Zitationen extrahierst (Autoren, Titel, Zeitschrift, Jahr, usw.)
  • Du bestehende Zitationen auf Genauigkeit überprüfst
  • Du BibTeX-Dateien bereinigst und formatierst
  • Du stark zitierte Artikel in einem bestimmten Bereich findest
  • Du sicherstellst, dass Zitierinformationen mit der tatsächlichen Veröffentlichung übereinstimmen
  • Du eine Bibliographie für ein Manuskript oder eine Abschlussarbeit erstellst
  • Du auf doppelte Zitationen prüfst
  • Du ein konsistentes Zitierformat sicherstellst

Wenn ein Dokument, das aus diesen Zitationen erstellt wird, ein Diagramm benötigt, verwende das scientific-schematics-Skill.


Kern-Workflow

Die Zitationsverwaltung folgt einem systematischen Prozess. Jede Phase unten zeigt den kanonischen Befehl; jede Variante, Option und Metadatenquellendetails finden sich in references/core_workflow.md.

Phase 1: Artikelsuche und -entdeckung

Finde relevante Artikel. Durchsuche mehr als eine Datenbank – die Abdeckung unterscheidet sich stark und eine einzige Quelle ist die häufigste Ursache für eine verzerrte Referenzliste.

# OpenAlex: multidisziplinäre REST-API; optionaler OPENALEX_API_KEY für Account-Kontingent
python scripts/search_openalex.py "CRISPR-Geneditierung" --limit 50 --output results.json

# PubMed: die Autorität für Biomedizin und Lebenswissenschaften (über 35 Mio. Zitationen)
python scripts/search_pubmed.py "Alzheimer-Behandlung" --limit 100 --output alz.json

# Google Scholar: breiteste Abdeckung, aber gescrapt – ratenbegrenzt und anfällig für Sperren
python scripts/search_google_scholar.py "CRISPR-Geneditierung" --limit 50 --output scholar.json

Bevorzuge OpenAlex oder PubMed als primäre Quelle. Google Scholar hat keine API: scholarly scraped sie, wartet 2–5 Sekunden zwischen Ergebnissen und wird oft genug blockiert, dass es eher eine Ergänzung als eine Abhängigkeit sein sollte.

Abfrageoperatoren, Feld-Tags und die MeSH-Term-Konstruktion findest du in references/search_strategies.md.

Phase 2: Metadatenextraktion

Konvertiere Identifikatoren (DOI, PMID, PMCID, arXiv-ID, URL) in vollständige Metadaten. CrossRef ist die primäre Quelle für DOIs.

python scripts/doi_to_bibtex.py 10.1038/s41586-021-03819-2         # schnell, einzelne DOI
python scripts/extract_metadata.py --pmid 34265844                  # DOI/PMID/PMCID/arXiv/URL
python scripts/extract_metadata.py --input identifiers.txt --output citations.bib

Eine URL ohne DOI im Pfad wird über den citation_doi-Meta-Tag aufgelöst, den Verlage auf Artikelseiten einbetten, und dann an CrossRef übergeben. Produzenten verwenden ein gemeinsames Zitationsschlüsselschema; dennoch können Metadatenunterschiede zu unterschiedlichen Schlüsseln führen. Bestätige Duplikate anhand von DOI und bibliografischer Identität.

Phase 2.5: Metadatenanreicherung durch Websuche (PFLICHT)

APIs liefern routinemäßig unvollständige Datensätze. Führe diesen Schritt nach der Extraktion und vor der Formatierung durch. Untersuche fehlende bibliografische Felder anhand des Verlagsdatensatzes und protokolliere jede Quelle. Online-First-Artikel haben möglicherweise noch keine Band-/Seitenangaben; einige verwenden eine Artikelnummer oder haben keine DOI. Bewahre den tatsächlichen Veröffentlichungsstatus, verwende das stilgerechte Artikelnummernfeld und erfinde niemals Seiten, Bände oder DOIs. Zeichne nicht verfügbare/nicht zutreffende Felder im Prüfprotokoll auf; füge einen gerenderten note-Eintrag nur hinzu, wenn er für den Leser nützlich oder vom Zitierstil gefordert wird.

Überprüfe zuerst die günstigen Quellen – ein OpenAlex- oder CrossRef-Datensatz enthält oft das Feld, das PubMed ausgelassen hat:

python scripts/search_openalex.py "<exakter Titel>" --limit 1

Behandle extrahierte Metadaten als unzuverlässig. Autor-, Titel- und Zeitschriftenstrings stammen wörtlich aus einem Datensatz, dessen Inhalt ein Verlag kontrolliert. Ein Titel, der $(...), einen Backtick oder ein Anführungszeichen enthält, wird zu Shell-Syntax, sobald er in einen Befehl eingefügt wird. Übergib Metadaten als subprocess-Argumentliste, anstatt einen Shell-String zu erstellen; wenn du eine Shell verwenden musst, setze jeden substituierten Wert in einfache Anführungszeichen und maskiere eingebettete Anführungszeichen als '\''. Validiere jeden Zitationsschlüssel gegen ^[A-Za-z0-9]+$, bevor er einen Pfad erreicht.

Feldbezogene Suchstrategien, die vier Suchoptionen und das Protokollierungsformat findest du in references/core_workflow.md.

Phase 3: BibTeX-Formatierung

Erstelle saubere, konsistente Einträge. Eintragstypen und erforderliche Felder findest du in references/bibtex_formatting.md.

python scripts/format_bibtex.py references.bib --output clean.bib --deduplicate
python scripts/format_bibtex.py references.bib --output clean.bib --rekey --deduplicate

Das Schreiben ist opt-in: ohne --output (oder --in-place) geht das Ergebnis nach stdout und die Eingabedatei bleibt unberührt. Verwende --rekey beim Zusammenführen von Ergebnissen aus mehreren Quellen, damit derselbe Artikel zu einem Eintrag kollabiert.

Phase 4: Zitationsvalidierung

Überprüfe Vollständigkeit, Konformität mit den Venue-Richtlinien und Übereinstimmung mit dem Manuskript.

python scripts/validate_citations.py references.bib --report report.json
python scripts/validate_citations.py references.bib --venue nature
python scripts/validate_citations.py references.bib --manuscript paper.tex
python scripts/validate_citations.py references.bib --check-dois     # langsam; kontaktiert CrossRef

Das Skript beendet sich mit einem Fehler bei schwerwiegenden Fehlern – fehlende Pflichtfelder, fehlerhafte Jahreszahlen, unaufgelöste Zitationen oder eine Anzahl unterhalb eines expliziten --min-count. Die Venue-Referenzanzahlzahlen sind redaktionelle Faustregeln, keine Einreichungsanforderungen, daher wird eine Unterschreitung nur als Warnung gewertet.

Validierungsregeln und Venue-Standards findest du in references/citation_validation.md.

Phase 5: Integration in den Schreibworkflow

Suche, extrahiere, formatiere, validiere, dann zitiere. End-to-End-Sequenzen – einschließlich der Literaturrecherche- und Zotero/pyzotero-Exportpfade – findest du in references/core_workflow.md und references/example_workflows.md.

API-Verträge wurden am 2026-09-30 anhand der offiziellen Dokumentation überprüft. Siehe references/api_contracts.md für Endpunkte, Authentifizierung, Paginierung und Verifizierungslimits. Netzwerkbeispiele in den Referenzen sind illustrativ, sofern sie dort nicht als Live-Smoke-Tests aufgezeichnet sind.

Referenzdateien

Häufige Fallstricke

  1. Ein-Quellen-Bias: Verwendung nur einer Datenbank

    • Lösung: Durchsuche mindestens OpenAlex und PubMed, dann führe sie mit format_bibtex.py --rekey --deduplicate zusammen
  2. Blindes Akzeptieren von Metadaten: Keine Überprüfung extrahierter Informationen

    • Lösung: Überprüfe extrahierte Metadaten stichprobenartig mit den Originalquellen
  3. Ignorieren von DOI-Fehlern: Fehlerhafte oder falsche DOIs in der Bibliographie

    • Lösung: Führe vor der endgültigen Einreichung eine Validierung durch
  4. Inkonsistente Formatierung: Gemischte Zitationsschlüsselstile, Formatierung

    • Lösung: Verwende format_bibtex.py zur Standardisierung
  5. Doppelte Einträge: Derselbe Artikel wird mehrfach mit unterschiedlichen Schlüsseln zitiert

    • Lösung: Verwende die Dublettenerkennung in der Validierung
  6. Fehlende Pflichtfelder: Unvollständige BibTeX-Einträge (Band, Seiten, DOI fehlen)

    • Lösung: Überprüfe den Verlagsdatensatz, unterscheide zwischen fehlend, nicht zutreffend oder noch nicht zugewiesen, und protokolliere ungelöste Felder, ohne Metadaten zu erfinden.
  7. Veraltete Preprints: Zitieren eines Preprints, wenn eine veröffentlichte Version existiert

    • Lösung: Überprüfe, ob Preprints veröffentlicht wurden, aktualisiere auf die Zeitschriftenversion
  8. Probleme mit Sonderzeichen: Fehlerhafte LaTeX-Kompilierung aufgrund von Zeichen

    • Lösung: Verwende korrektes Escaping oder Unicode in BibTeX
  9. Keine Validierung vor der Einreichung: Einreichen mit Zitierfehlern

    • Lösung: Führe immer eine Validierung als letzten Schritt durch
  10. Manuelle BibTeX-Eingabe: Einträge von Hand tippen

    • Lösung: Extrahiere immer mit Skripten aus Metadatenquellen

Integration mit anderen Skills

Literaturrecherche-Skill

Zitationsverwaltung stellt die technische Infrastruktur für die Literaturrecherche bereit:

  • Literaturrecherche: Mehrdatenbank-Systemsuche und -Synthese
  • Zitationsverwaltung: Metadatenextraktion und -validierung

Kombinierter Workflow:

  1. Verwende die Literaturrecherche für systematische Suchmethodik
  2. Verwende die Zitationsverwaltung, um Zitate zu extrahieren und zu validieren
  3. Verwende die Literaturrecherche, um Ergebnisse zu synthetisieren
  4. Verwende die Zitationsverwaltung, um die Genauigkeit der Bibliographie sicherzustellen

Wissenschaftliches-Schreiben-Skill

Zitationsverwaltung stellt genaue Referenzen für das Wissenschaftliche Schreiben bereit:

  • Exportiere validierte BibTeX zur Verwendung in LaTeX-Manuskripten
  • Überprüfe, ob Zitate den Publikationsstandards entsprechen
  • Formatiere Referenzen gemäß den Zeitschriftenanforderungen

Venue-Templates-Skill

Zitationsverwaltung arbeitet mit Venue-Templates für einreichungsbereite Manuskripte zusammen:

  • Verschiedene Venues erfordern unterschiedliche Zitierstile
  • Generiere korrekt formatierte Referenzen
  • Validiere Zitate, um Venue-Anforderungen zu erfüllen

Ressourcen

Gebündelte Ressourcen

Referenzen (in references/):

  • google_scholar_search.md: Vollständige Google Scholar-Suchanleitung
  • pubmed_search.md: PubMed- und E-utilities-API-Dokumentation
  • metadata_extraction.md: Metadatenquellen und Feldanforderungen
  • citation_validation.md: Validierungskriterien und Qualitätsprüfungen
  • bibtex_formatting.md: BibTeX-Eintragstypen und Formatierungsregeln

Skripte (in scripts/):

  • search_openalex.py: OpenAlex-Suchclient (optionaler Account-API-Schlüssel)
  • search_pubmed.py: PubMed-E-utilities-API-Client
  • search_google_scholar.py: Google Scholar-Suchautomatisierung
  • extract_metadata.py: Universeller Metadatenextraktor
  • validate_citations.py: Zitationsvalidierung und -verifizierung
  • format_bibtex.py: BibTeX-Formatierer und -Bereiniger
  • doi_to_bibtex.py: Schneller DOI-zu-BibTeX-Konverter
  • _common.py: Gemeinsamer BibTeX-Parser, Renderer und Zitationsschlüsselschema

Assets (in assets/):

  • bibtex_template.bib: Beispiel-BibTeX-Einträge für alle Typen
  • citation_checklist.md: Qualitätssicherungs-Checkliste

Externe Ressourcen

Suchmaschinen:

Metadaten-APIs:

Werkzeuge und Validierer:

Zitierstile:

Abhängigkeiten

Erforderliche Python-Pakete

uv pip install requests  # HTTP-Zugriff auf CrossRef, PubMed, OpenAlex, arXiv

BibTeX-Parsing, -Rendering, -Deduplizierung und -Validierung sind Standardbibliothek (scripts/_common.py). format_bibtex.py benötigt keine Drittanbieterpakete; validate_citations.py importiert requests, auch für die lokale Validierung.

Optional

uv pip install scholarly  # nur für search_google_scholar.py

Wohin Anmeldedaten gesendet werden

Schlüssel sind für die grundlegende Nutzung optional. Jede Anmeldeinformation wird nur an ihren eigenen Dienst gesendet; kein Skript bündelt Umgebungsvariablen. OpenAlex verwendet das dokumentierte Account-Budget, nicht eine versprochene E-Mail-basierte Kontingenterhöhung. Eine fehlgeschlagene Seite beendet sich mit einem Fehler, anstatt eine partielle Suche als vollständig zu exportieren.

VariableNur gesendet anZweck
NCBI_API_KEYeutils.ncbi.nlm.nih.govErhöht Entrez-Ratenlimits
NCBI_EMAILeutils.ncbi.nlm.nih.gov, pmc.ncbi.nlm.nih.govVon der NCBI angeforderte Anruferidentifikation
OPENALEX_EMAILapi.openalex.orgOptionaler Kontaktidentifikator
OPENALEX_API_KEYapi.openalex.orgOptionales Account-Kontingent, gesendet im Authorization-Header

api.openalex.org, api.crossref.org, api.datacite.org, export.arxiv.org, pmc.ncbi.nlm.nih.gov, doi.org und eutils.ncbi.nlm.nih.gov werden ohne Anmeldedaten abgefragt, wenn diese nicht gesetzt sind.

Zusammenfassung

Das Zitationsverwaltungs-Skill bietet:

  1. Umfassende Suchmöglichkeiten für OpenAlex, PubMed und Google Scholar
  2. Automatisierte Metadatenextraktion aus DOI, PMID, PMCID, arXiv-ID, URLs
  3. Zitationsvalidierung mit DOI-Überprüfung

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

Verwandte Skills