Let your agent make the PDF.

This skill is one Markdown file. It teaches a coding agent to install marsdawn, check that it works, export a document to PDF and read the result, so the agent that wrote the Markdown can hand you the PDF as well.

Install it in Claude Code

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

Claude Code loads it when a task calls for a PDF, and you can run it yourself as /marsdawn. It's one short file, so read it before you install it.

Other agents can use the same file. It's plain Markdown, instructions and commands, so point yours at the URL or paste it in.

What it teaches

Install marsdawn with Homebrew if it's missing, then check it with marsdawn --version instead of assuming a version.
Export with marsdawn export … --json, and read the result: where the PDF went, how many pages it has, and any Mermaid diagram that didn't render.
Tell the failures apart by exit code: no such file, a PDF already there, a failed export, a bad option.
Use open only when the MarsDawn app is installed, and never to make a PDF.

What it doesn't do

It doesn't give itself permission to run anything. Your agent still asks before it installs marsdawn or runs it, as it would for any other command.
It doesn't send your documents anywhere. marsdawn renders on your Mac, and it leaves out images from the web unless you pass --allow-remote-images.

The whole contract, every field and every code, is in marsdawn for agents.