Agent-almanac format-citations

install
source · Clone the upstream repo
git clone https://github.com/pjt222/agent-almanac
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/pjt222/agent-almanac "$T" && mkdir -p ~/.claude/skills && cp -r "$T/i18n/de/skills/format-citations" ~/.claude/skills/pjt222-agent-almanac-format-citations-c449ab && rm -rf "$T"
manifest: i18n/de/skills/format-citations/SKILL.md
source content

Zitate formatieren

Zitate und Literaturverzeichnisse über verschiedene akademische Stile hinweg formatieren unter Verwendung von CSL-Definitionen und citeproc-Verarbeitung in R, mit Regeln für Autorenformatierung, Datumsstile, Kursivschrift und DOI-Einbindung.

Wann verwenden

  • Umstellung eines Manuskripts von einem Zitierstil auf einen anderen (z.B. APA zu Vancouver)
  • Erzeugung eines stilkonformen Literaturverzeichnisses für Zeitschrifteneinreichung
  • Prüfung, ob Zitate korrekt nach einem bestimmten Stil formatiert sind
  • Erstellung konsistenter In-Text-Zitate und korrespondierender Literaturverzeichniseinträge
  • Anpassung eines CSL-Stils für besondere Zeitschriftenanforderungen

Eingaben

  • Erforderlich: Bibliographiedaten (BibTeX .bib-Datei oder BibEntry-Objekt)
  • Erforderlich: Zielzitierstil (APA 7., Chicago Autor-Jahr, Vancouver, IEEE oder benutzerdefinierte CSL-Datei)
  • Optional: Spezifische zu formatierende Zitierschlüssel (Standardmäßig werden alle Einträge formatiert)
  • Optional: Dokumentkontext (Quarto .qmd, R Markdown .Rmd oder eigenständig)
  • Optional: Sprachgebiet für lokalisierte Formatierung (z.B. Deutsch: „und" statt „and")

Vorgehensweise

Schritt 1: Stilregeln und CSL-Definition laden

Den Zielzitierstil vorbereiten:

  1. Vordefinierten Stil identifizieren: Standardstile im CSL-Repository unter https://github.com/citation-style-language/styles finden.
  2. CSL-Datei herunterladen oder lokalisieren: Sicherstellen, dass die .csl-Datei für das Projekt zugänglich ist. Häufige Stile:
StilCSL-DateinameIn-Text-Format
APA 7. Auflage
apa.csl
(Nachname, Jahr)
Chicago Autor-Jahr
chicago-author-date.csl
(Nachname Jahr)
Vancouver
vancouver.csl
Nummern [1]
IEEE
ieee.csl
Nummern [1]
Nature
nature.csl
Hochgestellte Nummern
  1. Sprachgebiet prüfen: CSL-Stile verwenden Sprachgebietsdateien für lokalisierte Begriffe. Sicherstellen, dass das richtige Sprachgebiet konfiguriert ist.
  2. Benutzerdefinierte Änderungen: Falls der Zielstil von einem Standard-CSL-Stil abweicht, die CSL-XML-Datei bearbeiten oder eine Kopie erstellen.

Erwartet: Die CSL-Stildatei ist geladen und alle stilspezifischen Regeln sind dokumentiert.

Bei Fehler: Falls kein exakter CSL-Stil verfügbar ist, den nächstliegenden Stil als Basis verwenden und die benötigten Änderungen dokumentieren. Häufige Anpassungen: Reihenfolge der Autoren, Datumsformat, Verwendung von Kursivschrift vs. Anführungszeichen für Titel.

Schritt 2: Stilregeln auf Einträge anwenden

Jeden Bibliographieeintrag gemäß den CSL-Regeln formatieren:

  1. Autorenformatierung:

    • APA: Nachname, Initiale(n). Format, „&" vor dem letzten Autor, max. 20 Autoren
    • Vancouver: Nachname Initialen, Komma-getrennt, max. 6 dann „et al."
    • Chicago: Erster Autor invertiert, nachfolgende in normaler Reihenfolge
  2. Titelformatierung:

    • APA: Satzmäßige Großschreibung für Artikeltitel, titelgemäße Großschreibung für Bücher/Zeitschriften
    • Vancouver: Satzmäßige Großschreibung, keine Kursivschrift für Artikeltitel
    • Zeitschriftennamen je nach Stil abgekürzt oder ausgeschrieben
  3. Datum und Volumen:

    • APA: (Jahr). Vor dem Titel
    • Vancouver: Jahr;Volumen(Ausgabe):Seiten
    • IEEE: vol. X, no. Y, S. Z–W, Mon. Jahr
  4. DOI/URL-Einbindung:

    • APA 7: DOI als
      https://doi.org/10.xxxx
      (immer einschließen)
    • Vancouver: DOI nach Seitenangaben, optional
    • Einige Stile erfordern „Verfügbar unter:" vor URLs
  5. Seitenangaben und Identifikatoren: Seitenbereiche, Artikelnummern und elektronische Standorte korrekt formatieren.

Erwartet: Jeder Eintrag ist vollständig im Zielstil formatiert mit korrekter Autorenreihenfolge, Zeichensetzung und Typografie.

Bei Fehler: Falls ein Eintrag vom Stil nicht unterstützte Felder hat (z.B. Softwarezitat im Vancouver-Stil), auf den nächsten unterstützten Eintragstyp zurückfallen und die Abweichung dokumentieren.

Schritt 3: In-Text-Zitate generieren

Die in den Dokumenttext eingebetteten Zitationsverweise erstellen:

  1. Autor-Jahr-Stile (APA, Chicago):

    • Einzelner Autor: (Müller, 2024)
    • Zwei Autoren: (Müller & Schmidt, 2024)
    • Drei oder mehr: (Müller et al., 2024)
    • Narrativ: Müller (2024) berichtet, dass...
    • Seitenverweis: (Müller, 2024, S. 45)
  2. Nummerierte Stile (Vancouver, IEEE):

    • Sequenziell nummeriert in Reihenfolge des ersten Erscheinens: [1], [2], [3]
    • Bereiche: [1–3], [1, 3, 5]
    • Hochgestellt (Nature): ¹, ²⁻⁴
  3. Mehrdeutigkeiten auflösen: Wenn mehrere Einträge zur gleichen Zitation zusammenfallen (gleicher Autor, gleiches Jahr), Buchstabensuffixe hinzufügen: (Müller, 2024a), (Müller, 2024b).

Erwartet: In-Text-Zitate stimmen exakt mit dem Literaturverzeichnis überein und folgen den Regeln des Zielstils.

Bei Fehler: Falls Mehrdeutigkeitsregeln den Stil überkomplizieren, die spezifischen Stilrichtlinien für die Disambiguierung konsultieren (einige Stile verwenden Initialen des Vornamens statt Buchstabensuffixe).

Schritt 4: Literaturverzeichnis zusammenstellen

Die vollständige Literaturliste generieren:

  1. Sortierreihenfolge: Nach Stil sortieren:

    • APA: Alphabetisch nach Nachname des ersten Autors, dann Jahr
    • Vancouver: In Reihenfolge des ersten Erscheinens im Text
    • Chicago: Alphabetisch nach Nachname
  2. Formatierung: Jeden formatierten Eintrag mit korrekten hängenden Einzügen, Abständen und Trennzeichen zusammenstellen.

  3. Überschrift: Geeignete Abschnittsüberschrift verwenden:

    • APA: „Literatur" (englisch: „References")
    • Chicago: „Bibliographie" oder „Zitierte Werke"
    • Vancouver: „Literatur"
  4. Ausgabe rendern: Für Quarto/R Markdown den CSL-Prozessor die Formatierung übernehmen lassen. Für eigenständige Ausgabe formatierten Text oder HTML erzeugen.

Erwartet: Ein vollständiges, korrekt geordnetes und formatiertes Literaturverzeichnis, das zum gewählten Stil passt.

Bei Fehler: Falls die Sortierreihenfolge falsch ist, die Sprachgebiet-Einstellungen des CSL-Prozessors prüfen (betrifft die Alphabetisierung in nicht-englischen Namen). Falls Einträge fehlen, sicherstellen, dass alle zitierten Schlüssel in der .bib-Datei vorhanden sind.

Schritt 5: Ausgabe validieren und exportieren

Die formatierte Ausgabe prüfen und liefern:

  1. Stichprobenprüfung: 3–5 Einträge manuell gegen die Stilrichtlinien prüfen: Autorformat, Interpunktion, Kursivschrift, DOI-Format.
  2. Querverweis: Sicherstellen, dass jedes In-Text-Zitat einen korrespondierenden Literaturverzeichniseintrag hat und umgekehrt.
  3. Exportformate: Ausgabe in dem für den Arbeitsablauf benötigten Format liefern:
    • Quarto/R Markdown: YAML-Header mit
      bibliography:
      und
      csl:
      konfigurieren
    • Eigenständig: Formatierten Text, HTML oder Word-Dokument erzeugen
    • LaTeX: Formatierten .bbl-Dateiabschnitt erzeugen

Erwartet: Validierte, stilkonforme Zitate und Literaturverzeichnis, bereit für die Einreichung oder Veröffentlichung.

Bei Fehler: Falls die Validierung Inkonsistenzen findet, die CSL-Stilregeln (Schritt 1) mit den stilspezifischen Transformationen (Schritt 2) abgleichen. Häufige Probleme: Groß-/Kleinschreibungsregeln, die vom Bibliographiemanager nicht durchgesetzt werden, fehlende Felder, die zu unvollständigen Einträgen führen.

Validierung

  • CSL-Stildatei korrekt geladen und Stilregeln dokumentiert
  • Autorenformatierung entspricht den Regeln des Zielstils
  • Titel, Daten, Volumina und Seitenangaben korrekt formatiert
  • DOIs/URLs gemäß Stilanforderungen eingebunden
  • In-Text-Zitate stimmen mit Literaturverzeichniseinträgen überein
  • Sortierreihenfolge des Literaturverzeichnisses entspricht dem Stil
  • Stichprobenprüfung repräsentativer Einträge gegen Stilrichtlinien bestanden
  • Querverweisüberprüfung: keine verwaisten Zitate und keine nicht zitierten Einträge

Häufige Fehler

  • CSL-Stile variieren in subtilen Details: Zwei „APA"-Stildateien aus verschiedenen Quellen können unterschiedliche Ergebnisse liefern. Immer das offizielle CSL-Repository (citation-style-language/styles) als Autoritätsquelle verwenden.
  • Groß-/Kleinschreibungsregeln zwischen Stilen verwechseln: APA verwendet Satzmäßige Großschreibung für Artikeltitel, aber titelgemäße Großschreibung für Zeitschriftennamen. Eine globale Anwendung einer Groß-/Kleinschreibungsregel erzeugt in den meisten Stilen falsche Ergebnisse.
  • Autorenmehrdeutigkeiten nicht auflösen: Wenn zwei Einträge den gleichen Erstautor und das gleiche Jahr haben, erfordern die meisten Stile eine Disambiguierung (Buchstabensuffixe oder zusätzliche Autoreninitialen). Fehlende Disambiguierung hinterlässt mehrdeutige Zitate.
  • Sprachgebiet ignorieren: Deutsche Bibliographien brauchen „und" statt „and", „Hrsg." statt „Eds." und passende Datumsformate. Die Sprachgebietskonfiguration im CSL-Prozessor muss zum Dokumentsprachgebiet passen.
  • Annehmen, dass alle Zitierstile „Nachname, Jahr" sind: Nummerierte Stile (Vancouver, IEEE) haben grundlegend andere Sortier- und Referenzierungsregeln. In-Text-Zitat-Generierung und Sortierung des Literaturverzeichnisses müssen zum Stiltyp passen.

Verwandte Skills

  • manage-bibliography
    -- Bibliographiedateien erstellen und bereinigen, bevor die Formatierung angewendet wird
  • validate-references
    -- Zitate gegen externe Quellen prüfen, bevor sie formatiert werden
  • create-quarto-report
    -- Quarto-Dokumente erstellen, die formatierte Zitate konsumieren
  • format-apa-report
    -- spezialisierte APA-7-Formatierung für Berichte und Manuskripte