Deja que tu agente te muestre lo que escribió y genere el PDF.

Esta skill es un archivo Markdown. Le enseña a un agente de programación a abrir en MarsDawn un documento que escribió para que lo revises, y a instalar marsdawn, comprobar que funciona, exportar un documento a PDF y leer el resultado.

Un archivo Markdown, en ~/.claude/skills/marsdawn/SKILL.md. Con él, tu agente instala marsdawn, exporta a PDF y lee el resultado JSON, y aun así pregunta antes de ejecutar cualquier cosa.

Instálala en Claude Code

La herramienta de línea de comandos marsdawn escribe la skill por ti, y el archivo que escribe corresponde a la versión de marsdawn que tienes instalada. Si aún no tienes marsdawn, instálalo con Homebrew:

brew install redtear1115/tap/marsdawn

Después instala la skill:

marsdawn skill --install

Esto escribe ~/.claude/skills/marsdawn/SKILL.md y crea la carpeta si no existe. Como el archivo sale de tu copia de marsdawn, nunca describe una opción que tu copia no tenga.

Claude Code la carga cuando una tarea pide un PDF, o cuando escribió o revisó un documento Markdown para que lo leas, y tú puedes ejecutarla con /marsdawn. Si prefieres leerla antes, es un archivo corto.

Después de actualizar marsdawn

Homebrew actualiza marsdawn pero deja la skill donde estaba, así que se queda en la versión antigua hasta que la renueves:

marsdawn skill --install --force

--force reemplaza el SKILL.md existente, incluidos los cambios que hayas hecho en él. Sin --force, si ya hay un SKILL.md distinto, marsdawn no lo toca, te avisa de que es distinto y termina con el código 64 (skill_differs). Si el archivo ya es el actual, no cambia nada.

Para otros agentes

Añade --dir con la carpeta donde tu agente guarda sus skills, y marsdawn escribe SKILL.md allí:

marsdawn skill --install --dir <path>

El archivo es Markdown simple, instrucciones y comandos, así que un agente que carga archivos de instrucciones puede usarlo tal cual.

Sin Homebrew ni la herramienta de línea de comandos

Si no puedes instalar marsdawn primero, descarga el archivo:

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

Esto descarga la última skill de este sitio, que puede ir por delante de un marsdawn más antiguo. Cuando tengas la herramienta, marsdawn skill --install --force la reemplaza por la que corresponde. También puedes indicarle la URL a un agente o pegar el archivo.

Qué enseña

Instalar marsdawn con Homebrew si falta y luego comprobarlo con marsdawn --version en lugar de suponer una versión.
Exportar con marsdawn export … --json y leer el resultado: dónde quedó el PDF, cuántas páginas tiene y qué diagrama Mermaid no se pudo renderizar.
Distinguir los errores por el código de salida: el archivo no existe, ya hay un PDF, la exportación falló, una opción no es válida.
Abrir un documento que escribió con marsdawn open file.md:line, en su primer cambio, y solo una vez: los cambios posteriores aparecen solos en la ventana abierta.
Si la app MarsDawn no está instalada, decirlo una vez y seguir, sin reintentar. Nunca usar open para generar un PDF.
Con --folder (marsdawn 0.5.1 y posterior), informar la carpeta como solicitada, no como mostrada: la app decide y nada lo confirma.

Qué no hace

No se da permiso a sí misma para ejecutar nada. Tu agente sigue preguntando antes de instalar marsdawn o ejecutarlo, como con cualquier otro comando.
No envía tus documentos a ningún lado. marsdawn renderiza en tu Mac y omite las imágenes de la web a menos que pases --allow-remote-images.

El contrato completo, cada campo y cada código, está en marsdawn para agentes. Para un agente que llama a herramientas por MCP en lugar de leer un archivo de skill, también hay un servidor MCP.