Laissez votre agent vous montrer ce qu’il a écrit, et produire le PDF.

L’installer dans Claude Code

L’outil en ligne de commande marsdawn écrit la skill pour vous, et le fichier qu’il écrit correspond à la version de marsdawn que vous avez installée. Si vous n’avez pas encore marsdawn, installez-le avec Homebrew :

brew install redtear1115/tap/marsdawn

Installez ensuite la skill :

marsdawn skill --install

Cela écrit ~/.claude/skills/marsdawn/SKILL.md, en créant le dossier s’il n’existe pas. Comme le fichier vient de votre copie de marsdawn, il ne décrit jamais une option que votre copie n’a pas.

Claude Code la charge quand une tâche demande un PDF, ou quand il a écrit ou révisé un document Markdown que vous allez lire, et vous pouvez la lancer vous-même avec /marsdawn. Si vous voulez la lire d’abord, c’est un fichier court.

Après une mise à jour de marsdawn

Homebrew met à jour marsdawn mais laisse la skill où elle était, elle reste donc à l’ancienne version tant que vous ne la rafraîchissez pas :

marsdawn skill --install --force

--force remplace le SKILL.md existant, y compris les modifications que vous y avez faites. Sans --force, si un SKILL.md différent est déjà là, marsdawn n’y touche pas, vous dit qu’il diffère et se termine avec le code 64 (skill_differs). Si le fichier est déjà le bon, rien ne change.

Pour d’autres agents

Ajoutez --dir avec le dossier où votre agent range ses skills, et marsdawn y écrit SKILL.md à la place :

marsdawn skill --install --dir <path>

Le fichier est du Markdown brut, des instructions et des commandes : un agent qui charge des fichiers d’instructions peut l’utiliser tel quel.

Sans Homebrew ni l’outil en ligne de commande

Si vous ne pouvez pas installer marsdawn d’abord, téléchargez plutôt le fichier :

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

Cela récupère la dernière skill de ce site, qui peut être en avance sur un marsdawn plus ancien. Une fois l’outil installé, marsdawn skill --install --force la remplace par celle qui correspond. Vous pouvez aussi indiquer l’URL à un agent, ou coller le fichier.

Ce qu’elle enseigne

• Installer marsdawn avec Homebrew s’il manque, puis le vérifier avec marsdawn --version au lieu de supposer une version.
• Exporter avec marsdawn export … --json et lire le résultat : où est allé le PDF, combien de pages il compte, et quel diagramme Mermaid n’a pas pu être rendu.
• Distinguer les échecs par leur code de sortie : fichier introuvable, PDF déjà présent, export échoué, option incorrecte.
• Ouvrir un document qu’il a écrit avec marsdawn open file.md:line, sur sa première modification, et une seule fois : les modifications suivantes apparaissent d’elles-mêmes dans la fenêtre ouverte.
• Si l’app MarsDawn n’est pas installée, le dire une fois et continuer, sans réessayer. Ne jamais utiliser open pour produire un PDF.
• Avec --folder (marsdawn 0.5.1 et versions ultérieures), signaler le dossier comme demandé, pas comme affiché : c’est l’app qui décide, et rien ne le confirme.

Ce qu’elle ne fait pas

• Elle ne s’accorde pas elle-même la permission d’exécuter quoi que ce soit. Votre agent demande toujours avant d’installer marsdawn ou de le lancer, comme pour n’importe quelle autre commande.
• Elle n’envoie vos documents nulle part. marsdawn fait le rendu sur votre Mac et laisse de côté les images du web, sauf si vous passez --allow-remote-images.

Le contrat complet, chaque champ et chaque code, se trouve dans marsdawn pour les agents. Pour un agent qui appelle des outils via MCP plutôt que de lire un fichier de compétence, il existe aussi un serveur MCP.