Quarkdown & KI: Das Agent-Skill und warum Markdown die Brücke ist

Dies ist der Teil, der Quarkdown überhaupt auf diesen Blog gebracht hat. Diese Plattform ist ein Experiment darin, Inhalte maschinen- und KI-freundlich vorzuhalten — jede Seite gibt es zusätzlich nativ als Markdown, damit KI-Systeme rauschfrei darauf zugreifen können. Quarkdown trifft denselben Nerv von der Produktionsseite: Es bewirbt sich ausdrücklich als agent-freundlich und bringt ein eigenes Skill für KI-Coding-Agenten mit. Nach dem praktischen Werkzeug aus Teil 8 schließt sich hier der Kreis zum Thema dieser Seite.

Was ein „Agent-Skill" ist

Ein Skill ist eine kompakte Anleitung, die ein KI-Agent (etwa Claude Code oder ChatGPT) lädt, sobald eine bestimmte Aufgabe ansteht — hier: das Schreiben oder Bearbeiten einer .qd-Datei. Statt sich auf vages Trainingswissen zu verlassen, bekommt das Modell eine präzise Arbeitsanweisung und Zugriff auf die Wahrheit: Quarkdown liefert eine vollständige Offline-Kopie seiner Wiki und der Stdlib-API-Referenz mit. Der Agent kann also die echte Doku konsultieren, bevor er Code generiert — statt Funktionssignaturen zu raten.

Wie das Skill arbeitet

Der Ablauf ist bewusst diszipliniert. Das Skill löst zuerst das Installationsverzeichnis auf …

QUARKDOWN_INSTALL="$(quarkdown doctor get install-dir)"

… liest dann den Wiki-Index (docs/wiki/_nav.qd), bei Bedarf den Quickstart und die für die Aufgabe relevanten Seiten, schreibt erst danach die .qd-Datei — und verifiziert sie durch Kompilieren:

quarkdown c main.qd --strict --out /tmp/quarkdown-verify

Das --strict aus Teil 8 ist hier der entscheidende Trick: Es macht Fehler hart sichtbar, statt sie still als Boxen ins Dokument zu rendern. So merkt der Agent sofort, wenn etwas nicht kompiliert, und kann nachbessern. „Lesen vor Schreiben, kompilieren zur Kontrolle" — eine Arbeitsweise, die ich aus meinem eigenen Agenten-Alltag nur bestätigen kann.

Installation

Eingerichtet ist das Skill schnell. In Claude Code verlinkst du das mitgelieferte Skill in dein Skills-Verzeichnis:

ln -s "$(quarkdown doctor get agent-skill)" ~/.claude/skills/quarkdown

Nach einem Neustart der Sitzung aktiviert es sich, sobald du den Agenten bittest, eine .qd-Datei zu schreiben; manuell triggerst du es mit /quarkdown. Für ChatGPT und andere Agenten lädst du schlicht die SKILL.md hoch — ihren Pfad liefert quarkdown doctor get agent-skill. Quarkdown verweist sogar auf eine eigene Eval, die die Fluency mit und ohne Skill misst.

Warum Markdown die Brücke zur KI ist

Der tiefere Punkt geht über ein einzelnes Tool hinaus. Markdown ist zur Lingua franca zwischen Mensch und Sprachmodell geworden: Es ist Klartext, strukturiert, ohne Rendering-Rauschen — genau das Format, das LLMs am saubersten lesen und schreiben. Was klassische Werkzeuge wie LaTeX oder DOCX zwar maschinell, aber nicht modellfreundlich machen, leistet Markdown von Natur aus.

Quarkdown erweitert dieses Format, ohne die Maschinenlesbarkeit zu opfern: Die Quelle bleibt Klartext, und ein Agent kann denselben .qd-Code sowohl verstehen als auch erzeugen — und daraus ein poliertes Artefakt (PDF, Slides, Wiki) bauen. Genau diese Doppelrolle macht es zum natürlichen Partner für KI-gestützte Inhaltsproduktion. Es ist dieselbe Wette, die auch hinter dieser Plattform steht und die ich in Was ist GEO? und Schreiben für KI ausführlicher beschrieben habe: Wer Inhalte maschinenlesbar hält, macht sie zukunftssicher.

FAQ

Brauche ich das Skill, um Quarkdown mit KI zu nutzen?

Nein, aber es hilft spürbar. Ohne Skill rät das Modell anhand seines Trainingsstands; mit Skill arbeitet es gegen die echte, aktuelle Doku und verifiziert sein Ergebnis durch Kompilieren. Gerade bei einer noch jungen Sprache mit eigener Syntax ist das der Unterschied zwischen „plausibel" und „kompiliert tatsächlich".

Funktioniert das nur mit Claude?

Nein. Das Skill ist eine schlichte SKILL.md plus Doku-Bundle. Claude Code bindet es per Symlink ein, andere Agenten über das Hochladen oder Referenzieren der Datei. Das Prinzip ist agentenneutral.

Was hat das mit diesem Blog zu tun?

Dieselbe Idee, von zwei Seiten: Diese Seite hält bestehende Inhalte KI-freundlich vor; Quarkdown produziert Inhalte KI-freundlich. Beide setzen darauf, dass Markdown die Schnittstelle zwischen menschlichem Schreiben und maschinellem Lesen ist.

Weiterlesen

Den praktischen Unterbau dazu liefert Teil 8: CLI, PDF & Deployment. In den letzten beiden Teilen dieser Reihe geht es noch einmal in die Tiefe — erst hinter die Kulissen in Quarkdowns Kompilier-Pipeline, dann eine Sammlung praktischer Tipps & Tricks. Die Installationsdetails zum Skill stehen in der offiziellen Wiki.