Communitygithub.com

Academia-Papier-Ökosystem

Ein Claude Code Agent Skill-Bundle zum Schreiben und Überprüfen von akademischen Papieren (SSRN / arXiv / Zenodo / Zeitschriften). Enthält einen Orchestrator-Skill, einen Entwurf-Skill und 5 Gutachter-Subagenten – das erste Repository, das Skills und Agenten über install.sh zusammenpackt.

Was ist Academia-Papier-Ökosystem?

Dieses Skill-Bundle, genannt 'paper-ecosystem', ist eine Sammlung von Claude Code Agent Skills und Agents, die speziell für das Schreiben und Reviewen von akademischen Papieren entwickelt wurde. Es unterstützt die Veröffentlichungsformate SSRN, arXiv, Zenodo und Zeitschriften. Das Bundle besteht aus einem Orchestrator-Skill, einem Draft-Skill und fünf Gutachter-Subagenten, die jeweils spezifische Prüfungen durchführen: Struktur-Review, Quelltreue, Vokabelkonsistenz, Zitierformat und Vollständigkeitsprüfung. Der Workflow ist streng organisiert: Vor dem Schreiben müssen Autoren eine primäre Quellenliste erstellen, Behauptungen mit Zitaten 1:1 verknüpfen und sicherstellen, dass keine sekundären Quellen als Ersatz dienen. Die Skill-Dokumentation definiert klare Aktivierungsbedingungen (z.B. beim Draften eines Papiers für ein bestimmtes Venue oder bei substanziellen Überarbeitungen) und Abgrenzungen zu anderen Skills wie 'writing-ecosystem' für Blogbeiträge. Nach dem Draft jedes Abschnitts werden die drei Prüfungs-Agenten parallel gestartet, und vor der Einreichung durchläuft das Papier ein Quality Gate mit sieben Checklistenpunkten. Das Bundle ist das erste seiner Art, das Skills und Agents in einem Repository zusammenführt und über ein install.sh-Skript installiert wird.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add shimo4228/claude-skill-paper-ecosystem

In Ihrer bevorzugten KI fragen

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

Dokumentation

Paper-Writing – Anleitung für den akademischen Papierentwurf

Skill, der den Entwurfsprozess für Position Papers, Preprints und Zeitschriftenartikel gemäß den Regeln des paper-ecosystem-Orchestrators organisiert.

Wann zu aktivieren

  • Entwurf eines Papers für SSRN / arXiv / Zenodo / Zeitschriften
  • Extraktion eines Papers aus einer bestehenden Serie von Essays / ADRs / Implementierungshistorie
  • Erstellung der einzelnen Abschnitte nach Festlegung der Gliederung eines Position Papers
  • Überarbeitung von Preprint v1 → v2 (bei signifikanten Umformulierungen)

Nicht zu aktivieren

  • Blogbeitrag / Essay (primär menschlich, informell) → writing-ecosystem verwenden
  • llms.txt / FAQ (primär KI) → llms-txt-writer verwenden
  • README / CHANGELOG (Projektdokumentation) → direkt schreiben, ohne Skill

Checkliste vor dem Entwurf

Vor dem Einstieg in den Papierentwurf muss der Autor Folgendes abschließen:

1. Erstellung der primären Quellenliste

Liste der primären Quellen, die das Papier zitiert:

  • Zitierte Essays / Blogbeiträge (URL + Datum + 1-zeilige Zusammenfassung)
  • Zitierte ADRs / Spezifikationsdokumente (Repo-Pfad + Version + 1-zeilige Zusammenfassung)
  • Zitierte externe Paper (Autor JAHR + arXiv-ID / DOI + 1-zeilige Zusammenfassung)
  • Zitierte Standards / Framework-Dokumente (Org JAHR + Standard-ID)

Jede primäre Quelle muss beim Papierentwurf direkt lesbar sein (URL zugänglich, Repo geklont, PDF heruntergeladen).

2. Vermeidung der Abhängigkeit von Glossaren / Zusammenfassungen

Verwenden Sie kein Glossar / keine Zusammenfassung / kein sekundäres Dokument aus dem Repo als Zitatquelle anstelle der primären Quelle. Abweichungen in sekundären Quellen würden sich auf das Papier übertragen (Details: paper-ecosystem Skill, Source Fidelity Rules).

Sekundäre Quellen werden nur für zwei Zwecke verwendet:

  • Überprüfung der Definitionskonsistenz von Begriffen (ob die Definition im Papier mit der im Glossar übereinstimmt)
  • Referenz für das Format der Referenzliste (Stilbeispiel, welche Felder enthalten sein sollen)

3. 1:1-Zuordnung von Behauptung ↔ Zitatquelle

In der Gliederungsphase wird für jeden Abschnitt die Kernbehauptung in einem Satz formuliert und jeder Behauptung eine Zitatquelle 1:1 zugeordnet. Unklare Zuordnungen werden vor dem Entwurf aufgelöst.

Formatbeispiel:

§3 Kernbehauptung: „Redirect-Fehler hat zwei architektonisch unterschiedliche Modi – prinzipienbasiert (autonomen Schleifen inhärent) und künstlich (Workflow-Arbeiten, die durch autonome Schleifen geleitet werden).“
Zitatquellen:
- Essay 5 (zenn-content/articles-en/react-agent-business-quadrant-2.md, 2026-04-30)
- ADR-0009 §Context (agent-attribution-practice/docs/adr/0009-triage-before-autonomy.md)
- Elish (2019) „Moral Crumple Zones“

4. Erhaltung von Unterklassifikationen

Wenn eine primäre Quelle einem Konzept Unterformen / Unterzellen / Untertypen zuweist, muss dies bei der Einführung des Begriffs im Papier explizit gemacht werden. Eine Vereinfachung führt zu Abweichungen (Details: paper-ecosystem Skill, Vocabulary Consistency Rules).


Abschnittsvorlage (Position Paper / Preprint)

Standardmäßige 9-Abschnitts-Struktur:

  1. Titelseite — Titel + Untertitel + Autor + ORCID + Version + Begleit-Repository + Lizenz
  2. Zusammenfassung — 250–300 Wörter, 3-Absatz-Struktur (unten)
  3. Einleitung — Problemstellung + Thesenvorschau + Abschnittsübersicht
  4. [Hauptabschnitte] — Kernbeitrag des Papiers. Etwa 3–6 Abschnitte
  5. Beziehung zu bestehenden Frameworks — Kurz (1 Absatz bis 1 Seite), Beziehung zu konkurrierenden Frameworks
  6. Schlussfolgerung — Wiederaufnahme der These + offene Fragen
  7. Referenzen — Vereinfacht nach APA-Stil
  8. Danksagungen (optional)
  9. Anhang (optional)

Bei Zeitschriftenartikeln werden Abschnittsnummern, Überschriftsebenen sowie die Platzierung von Tabellen und Abbildungen gemäß dem Hausstil des Verlags angepasst.


Zusammenfassungsstruktur (250–300 Wörter)

3 Absätze:

  1. Problemstellung (~70–90 Wörter) — Welches Phänomen wird behandelt, und was fehlt im aktuellen Diskurs?
  2. Beiträge (~120–150 Wörter) — 2–3 Kernbeiträge des Papiers explizit nennen. Für jeden Beitrag je ein Satz zu Was / Warum / Wie.
  3. Konsequenz (~60–90 Wörter) — Was die Beiträge für die Zielgruppe des Papiers bedeuten, mit Erwähnung ungelöster offener Fragen.

Schlüsselwörter (5–8) direkt unter der Zusammenfassung platzieren.


Referenzenformat (vereinfacht nach APA-Stil)

QuelltypFormat
ZeitschriftenartikelAutor, A. B. (JAHR). Titel. *Zeitschriftenname* Bd(Heft): Seiten.
arXiv-PreprintAutor, A. B., & Autor, C. D. (JAHR). *Titel.* arXiv:NNNN.NNNNN.
KonferenzbeitragAutor, A. B. (JAHR). Titel. In *Tagungsband* (Seiten). Verlag.
Branchen-/UnternehmensdokumentOrg. (JAHR). *Titel.* URL
StandardOrg. (JAHR). *Standard-ID Titel.* Verlag.
Repository / DatensatzAutor, A. B. (JAHR). *Titel (Version).* Plattform. DOI

Details: paper-ecosystem Skill, Citation Format Rules.


Mehrsprachigkeitskonvention (optional)

Bei paralleler Erstellung einer untergeordneten Sprachversion (z. B. Übersetzung ins Deutsche):

  • Die englische Version ist primär, die untergeordnete Sprachversion ist nicht verbindlich
  • Dateibenennung: <papiername>.md (Englisch) + <papiername>.de.md (Deutsch)
  • Bei inhaltlichen Änderungen zuerst die englische Version aktualisieren, dann die untergeordnete Sprachversion
  • Fachbegriffe (Quadrant / Phasentrennung / Artefaktname usw.) bleiben auch in der untergeordneten Sprachversion auf Englisch oder werden mit englischer Angabe versehen

Details: paper-ecosystem Skill, Multi-language Paper Convention.


Schreibprozess (Abschnittsentwurf)

Vorgehen für jeden Abschnitt:

  1. Abschnittsbehauptung in einem Satz formulieren (Ausgabe der Checkliste vor dem Entwurf erneut prüfen)
  2. Abschnittseinleitung mit einem konkreten Beispiel beginnen: Beispiel / bekanntes Phänomen / Zitat aus einer Quelle, nicht mit abstraktem Rahmen
  3. Belege für die Behauptung direkt dahinter platzieren (1:1 mit Zitat)
  4. Übergang zum nächsten Abschnitt am Ende des aktuellen Abschnitts explizit machen: Was wird an den nächsten Abschnitt übergeben, was aus dem aktuellen Abschnitt wird als Voraussetzung mitgenommen?
  5. Untergeordnete Absätze entweder in Richtung Zerlegung der Behauptung oder in Richtung Behandlung von Gegen-/Alternativpositionen ausrichten – eine Mischung beider Richtungen schwächt den Fluss

Nach Fertigstellung jedes Abschnittsentwurfs die Agenten paper-reviewer + source-fidelity-checker + vocabulary-consistency-checker parallel starten, um eine Überprüfung durchzuführen (Details: paper-ecosystem Skill, When to Use What-Flussdiagramm).


Qualitätskontrolle (vor der Einreichung)

Unmittelbar vor der Einreichung prüfen:

  • Alle Abschnitte haben die paper-reviewer-Prüfung bestanden
  • Alle Behauptungen wurden vom source-fidelity-checker als ALIGNED oder PARTIAL eingestuft (kein DRIFT mehr vorhanden)
  • Alle Begriffe haben die vocabulary-consistency-checker-Prüfung bestanden (Einführung von Unterklassifikationen explizit gemacht)
  • citation-formatter zeigt 0 verwaiste Zitate, 1:1-Zuordnung Zitat ↔ Referenz
  • Die Wortanzahl der Zusammenfassung liegt im Standardbereich des Verlags
  • Alle DOIs / arXiv-IDs / URLs sind gültig
  • Bei Vorhandensein einer mehrsprachigen Version weichen englische Version und Übersetzung inhaltlich nicht voneinander ab

Detaillierte Dimensionen sind in den 4 kanonischen Regelabschnitten des paper-ecosystem-Skills zu finden.


Verwandte Skills und Agents

  • paper-ecosystem Skill — Quelltreue / Vokabelkonsistenz / akademischer Stil / Zitierformat (die verbindliche Quelle). Orchestrator, auf den dieser Skill aufbaut
  • paper-reviewer Agent — Strukturüberprüfung nach Fertigstellung eines Abschnittsentwurfs
  • source-fidelity-checker Agent — Überprüfung der Zitat-Behauptungs-Konsistenz nach Fertigstellung eines Abschnittsentwurfs
  • vocabulary-consistency-checker Agent — Überprüfung der Begriffskonsistenz nach Fertigstellung eines Abschnittsentwurfs
  • citation-formatter Agent — Endkontrolle der Zitat-Referenz-Zuordnung vor der Einreichung
  • writing-ecosystem Skill — Für Blogbeiträge / Essays, nicht dieser Skill
  • llms-txt-writer Skill — Für KI-Dokumentation, nicht dieser Skill

Verwandte Skills