Lass deinen Agenten zeigen, was er geschrieben hat, und das PDF erstellen.

Dieser Skill ist eine Markdown-Datei. Er bringt einem Coding-Agenten bei, ein Dokument, das er geschrieben hat, zur Prüfung für dich in MarsDawn zu öffnen, marsdawn zu installieren, zu prüfen, ob es funktioniert, ein Dokument als PDF zu exportieren und das Ergebnis zu lesen.

Eine Markdown-Datei unter ~/.claude/skills/marsdawn/SKILL.md. Damit installiert dein Agent marsdawn, exportiert als PDF und liest das JSON-Ergebnis, und er fragt trotzdem, bevor er etwas ausführt.

In Claude Code installieren

Das Befehlszeilenwerkzeug marsdawn schreibt den Skill für dich, und die Datei, die es schreibt, passt zur Version von marsdawn, die du installiert hast. Wenn du marsdawn noch nicht hast, installiere es mit Homebrew:

brew install redtear1115/tap/marsdawn

Installiere dann den Skill:

marsdawn skill --install

Das schreibt ~/.claude/skills/marsdawn/SKILL.md und legt den Ordner an, falls er fehlt. Weil die Datei von deiner Kopie von marsdawn stammt, beschreibt sie nie eine Option, die deine Kopie nicht hat.

Claude Code lädt ihn, wenn eine Aufgabe ein PDF verlangt oder wenn es ein Markdown-Dokument zum Lesen für dich geschrieben oder überarbeitet hat, und du kannst ihn selbst als /marsdawn aufrufen. Wenn du ihn zuerst lesen möchtest: Es ist eine kurze Datei.

Nach einem Upgrade von marsdawn

Homebrew aktualisiert marsdawn, lässt den Skill aber, wo er war, er bleibt also auf der alten Version, bis du ihn auffrischst:

marsdawn skill --install --force

--force ersetzt die vorhandene SKILL.md, auch mit Änderungen, die du daran vorgenommen hast. Ohne --force lässt marsdawn eine bereits vorhandene, abweichende SKILL.md unangetastet, teilt dir mit, dass sie abweicht, und beendet sich mit Code 64 (skill_differs). Ist die Datei schon die aktuelle, ändert sich nichts.

Für andere Agenten

Füge --dir mit dem Ordner hinzu, in dem dein Agent seine Skills ablegt, und marsdawn schreibt SKILL.md stattdessen dorthin:

marsdawn skill --install --dir <path>

Die Datei ist reines Markdown, Anweisungen und Befehle, ein Agent, der Anweisungsdateien lädt, kann sie also unverändert nutzen.

Ohne Homebrew oder das Befehlszeilenwerkzeug

Wenn du marsdawn nicht zuerst installieren kannst, lade stattdessen die Datei herunter:

mkdir -p ~/.claude/skills/marsdawn
curl -fsSL https://marsdawn.southern-light.dev/cli/skill/SKILL.md -o ~/.claude/skills/marsdawn/SKILL.md

Das holt den neuesten Skill von dieser Website, der einem älteren marsdawn voraus sein kann. Sobald du das Werkzeug hast, ersetzt marsdawn skill --install --force ihn durch den passenden. Du kannst auch einen Agenten auf die URL verweisen oder die Datei einfügen.

Was er beibringt

marsdawn mit Homebrew installieren, falls es fehlt, und es dann mit marsdawn --version prüfen, statt eine Version anzunehmen.
Mit marsdawn export … --json exportieren und das Ergebnis lesen: wo das PDF gelandet ist, wie viele Seiten es hat und welches Mermaid-Diagramm nicht gerendert wurde.
Fehler am Exit-Code unterscheiden: keine solche Datei, ein PDF ist schon da, ein fehlgeschlagener Export, eine falsche Option.
Ein geschriebenes Dokument mit marsdawn open file.md:line öffnen, bei der ersten Änderung, und nur einmal: Spätere Änderungen erscheinen von selbst im offenen Fenster.
Wenn die MarsDawn-App nicht installiert ist, das einmal sagen und weitermachen, ohne es erneut zu versuchen. Nie open verwenden, um ein PDF zu erstellen.
Mit --folder (marsdawn 0.5.1 und neuer) den Ordner als angefragt melden, nicht als angezeigt: Die App entscheidet, und nichts meldet zurück.

Was er nicht tut

Er gibt sich nicht selbst die Erlaubnis, etwas auszuführen. Dein Agent fragt weiterhin, bevor er marsdawn installiert oder ausführt, wie bei jedem anderen Befehl.
Er schickt deine Dokumente nirgendwohin. marsdawn rendert auf deinem Mac und lässt Bilder aus dem Web weg, außer du übergibst --allow-remote-images.

Der vollständige Vertrag, jedes Feld und jeder Code, steht unter marsdawn für Agenten. Für einen Agenten, der Werkzeuge über MCP aufruft, statt eine Skill-Datei zu lesen, gibt es außerdem einen MCP-Server.