Communitygithub.com

zhangys11/agent-skills

Wiederverwendbare Agenten-Fähigkeiten (SKILL.md) für KI-Codierungsagenten. Enthält obsidian-pdf: Markdown -> Obsidian-stilisiertes PDF (pandoc + Headless Chromium).

Was ist agent-skills?

Diese Skill-Sammlung stellt wiederverwendbare Fähigkeiten für KI-Codierungsagenten wie Claude Code, Cursor oder Codex bereit. Sie umfasst zwei Hauptwerkzeuge: **md2tex**, einen akademischen Markdown-zu-LaTeX-Konverter, der Manuskripte in journalreife `.tex`-Dateien umwandelt, und **obsidian-pdf**, das Markdown in PDFs im Obsidian-Stil rendert (A4, Arial, MathJax). Der md2tex-Konverter beherrscht die Umwandlung von Überschriften, Textauszeichnungen, Tabellen, Bildern, Mathematik und Unicode-Sonderzeichen in LaTeX-Äquivalente. Er unterstützt vordefinierte Dokumentklassen wie `article`, `revtex` und `ieeetran` sowie benutzerdefinierte Präambeln. Die Skill ist plattformunabhängig über die Kommandozeile nutzbar und eignet sich besonders für Forscher und Autoren, die mit Markdown schreiben und ihre Arbeit bei Fachzeitschriften einreichen möchten. Die Integration mit Obsidian-Workflows wird durch die PDF-Option abgerundet. Einfach per `python3 scripts/md2tex.py` aufrufbar – die Pfade sind relativ zum Skill-Basisverzeichnis.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add zhangys11/agent-skills

In Ihrer bevorzugten KI fragen

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

Vorschau

Aus dem Skill-README

alt

Dokumentation

Markdown-zu-LaTeX-Konverter (md2tex)

Konvertiert akademische Markdown-Manuskripte in LaTeX-.tex-Dateien, die für die Einreichung bei Fachzeitschriften geeignet sind. Deckt die gesamte Konvertierungspipeline ab: Überschriften, fett/kursiv, Pipe-Tabellen, Bilder, angezeigte/Inline-Mathematik, Aufzählungslisten, Unicode-Sonderzeichen und Zitierformatierung.

Kurzstart

# Einfach: einzelne .md in Article-Klasse .tex konvertieren
python3 scripts/md2tex.py paper.md -o output/

# Dokumentklassen-Vorlage wählen
python3 scripts/md2tex.py paper.md -o output/ --class ieeetran
python3 scripts/md2tex.py paper.md -o output/ --class revtex

# Mehrere Dateien: Hauptmanuskript + Anhang als Ergänzungsmaterial
python3 scripts/md2tex.py main.md --appendix appendix.md -o output/ --class revtex

# Benutzerdefinierte Präambel-Überschreibungen (Pakete, Befehle usw. hinzufügen)
python3 scripts/md2tex.py paper.md --preamble my_preamble.tex -o output/

# PDFs nach der Generierung kompilieren
python3 scripts/md2tex.py paper.md -o output/ --compile

Pfade oben sind relativ zum Basisverzeichnis dieser Skill.

Was es tut

Das Skript liest Markdown und erzeugt LaTeX, indem es diese Konvertierungen anwendet:

MarkdownLaTeX
## Abschnitt\section{Abschnitt}
### Unterabschnitt\subsection{Unterabschnitt}
#### Unterunterabschnitt\subsubsection{Unterunterabschnitt}
**fett**\textbf{fett}
*kursiv*\textit{kursiv} (mathematikbewusst: überspringt $...$)
$$...$$$$...$$ (Durchleitung)
$...$$...$ (Durchleitung)
| ... | Pipe-Tabellen\begin{tabular}...\end{tabular}
![alt](pfad)\begin{figure}\includegraphics...\caption...\end{figure}
![[pfad|alt]] (Obsidian)Wie oben
- Aufzählungspunkt\begin{itemize}\item...\end{itemize}
α, β, ∞, →, × usw.$\alpha$, $\beta$, $\infty$, $\to$, $\times$
--- (Gedankenstrich)--- (beibehalten)

Zusätzliche Verarbeitung

  • Bildunterschriften: Sucht voraus nach Zeilen wie **Abb. N | ...** oder **Abb. N.** nach Bildern, um korrekte \caption{...} zu erstellen.
  • Tabellenunterschriften: Sucht nach Blöcken wie **Tabelle N | ...** oder **TABELLE N** vor Pipe-Tabellen.
  • Unicode-Mathematik: Bildet α β γ ε λ μ π ρ σ ω Γ Λ Σ Ω ∞ → ← × ± ≤ ≥ ≈ ≠ ¬ auf LaTeX-Äquivalente ab.
  • Akzentuierte Zeichen: Bildet é è ê ñ ö ü â î ô auf LaTeX-Escape-Sequenzen ab.
  • Geschickte Anführungszeichen: "" '' zu `` ''.
  • Polnisches ł: Białynicki → Bia{\l}ynicki für korrekte Darstellung.
  • Leerzeilenbereinigung: Reduziert 4+ Leerzeilen auf 2.
  • Blockzitatentfernung: Entfernt optional Zeilen mit > ....

Dokumentklassen-Vorlagen

VorlageDokumentklasseVerwendungszweck
article (Standard)\documentclass[12pt]{article}Allgemeine Arbeiten, arXiv
revtex\documentclass[aps,pra,preprint]{revtex4-2}Physical Review Journals
ieeetran\documentclass[journal,onecolumn,12pt]{IEEEtran}IEEE Transactions

Jede Vorlage enthält geeignete Pakete (graphicx, amsmath, amssymb, hyperref, booktabs, array).

Benutzerdefinierte Präambel

Erstellen Sie eine .tex-Datei mit Ihrer vollständigen Präambel (Pakete, Befehle usw.) und übergeben Sie sie mit --preamble. Die Standardeinstellung für jede Vorlage wird überschrieben.

Beispiel my_preamble.tex:

\documentclass[aps,pra,reprint]{revtex4-2}
\usepackage{graphicx}
\usepackage{amsmath,amssymb}
\usepackage{hyperref}
\usepackage{booktabs}
\usepackage{xcolor}
\newcommand{\pbox}[2]{\parbox{#1}{\vspace{4pt}\RaggedRight #2\vspace{4pt}}}

Zitierbehandlung

Zwei Modi, einstellbar mit --cite:

bibtex (Standard)

Behält BibTeX-Schlüssel im Text: \cite{key2020}. Standardmäßig werden Zitierschlüssel aus einem Referenzabschnitt oder einer Bibliotheksdatei gelesen. Platzhalter im Stil [N] bleiben unverändert, es sei denn, --cite-map wird angegeben.

inline

Bettet \begin{thebibliography}...\end{thebibliography} mit handschriftlichen Einträgen ein. Verwenden Sie --biblio references.tex, um den Bibliotheksinhalt bereitzustellen.

Erweiterte Optionen

--title "Titel der Arbeit"     Überschreibt den Dokumenttitel (Standard: erste #-Überschrift)
--author "Name"               Autorenname
--affiliation "Uni"           Autorenzugehörigkeit
--email "[email protected]"            Korrespondenz-E-Mail
--abstract                     Extrahiert Abstract aus Abschnitt ## Zusammenfassung (Standard: automatisch)
--no-abstract                  Überspringt die Abstract-Extraktion
--appendix appendix.md         Konvertiert Anhang als Ergänzungsmaterial
--suppress-numbers             Verwendet \section*{} (unnummeriert, für Ergänzungsmaterial)
--cite-map map.json            JSON-Zuordnung von Zitierplatzhaltern zu BibTeX-Schlüsseln
--compile                      Führt pdflatex zweimal nach der Generierung aus
--fig-dir figures/             Verzeichnis zum Kopieren der Abbildungen (Standard: automatische Erkennung)
--help                         Zeigt die vollständige Nutzung an

Kompilierungshinweise

Nach der Generierung von .tex-Dateien mit folgendem Befehl kompilieren:

# REVTeX (erfordert installierte revtex4-2.cls)
cd output/ && pdflatex main.tex && pdflatex main.tex

# IEEEtran (erfordert installierte IEEEtran.cls)  
cd output/ && pdflatex main.tex && pdflatex main.tex

Das Skript erkennt automatisch Abbildungen, auf die im Markdown verwiesen wird, und kopiert sie aus dem Quellverzeichnis in das Ausgabeverzeichnis.

Einschränkungen

  • Kein universeller Konverter: Entwickelt für die akademische Papierstruktur (IMRaD + Ergänzungsmaterial). Komplexe verschachtelte Listen, Codeblöcke und Fußnoten erfordern möglicherweise manuelle Anpassungen.
  • Nur Pipe-Tabellen: HTML-<table>-Tags werden nicht konvertiert.
  • Einzeilige Aufzählungspunkte: Behandelt derzeit 2-stufige Verschachtelung; tiefere Listen werden möglicherweise abgeflacht.
  • Mathematik-Umgebungen: \begin{aligned}...\end{aligned} usw. werden unverändert durchgelassen – stellen Sie sicher, dass sie gültiges LaTeX sind.
  • Zitierkonvertierung: [N] zu \cite{} erfordert eine vom Benutzer bereitgestellte Zuordnungsdatei oder manuelle Nachbearbeitung.
  • Kein Live-Neuladen: .tex nach jeder .md-Änderung neu generieren; die Skill überwacht keine Dateien.

Verwenden Sie für die PDF-Wiedergabe im Obsidian-Stil (A4, Arial, MathJax) stattdessen die obsidian-pdf-Skill.

Verwandte Skills