書いたものをエージェントに見せてもらい、PDF も作ってもらう。

このスキルは1つの Markdown ファイルです。コーディングエージェントに、自分が書いた文書を MarsDawn で開いてあなたに確認してもらう方法と、marsdawn のインストール方法、動作確認の方法、文書を PDF に書き出す方法、結果の読み方を教えます。

1つの Markdown ファイルを ~/.claude/skills/marsdawn/SKILL.md に置くだけ。これでエージェントが marsdawn をインストールし、PDF に書き出し、JSON の結果を読みます。何かを実行する前には、これまでどおり確認を求めます。

Claude Code にインストールする

コマンドラインツール marsdawn がスキルを書き出します。書き出されるファイルは、インストール済みの marsdawn のバージョンに合ったものです。まだ marsdawn がない場合は、Homebrew でインストールしてください。

brew install redtear1115/tap/marsdawn

そのあと、スキルをインストールします。

marsdawn skill --install

これで ~/.claude/skills/marsdawn/SKILL.md が書き出されます。フォルダがなければ作成されます。ファイルは手元の marsdawn から作られるので、そのバージョンにないオプションが書かれることはありません。

Claude Code は、PDF が必要なタスクのとき、またはあなたが読む Markdown 文書を書いたり修正したりしたときに、これを自動的に読み込みます。/marsdawn として自分で実行することもできます。先に中身を読みたい場合は、短いファイル1つです。

marsdawn をアップグレードしたあと

Homebrew は marsdawn をアップグレードしますが、スキルには手を触れないので、更新するまで古いバージョンのままです。

marsdawn skill --install --force

--force は、既存の SKILL.md を、あなたが加えた変更も含めて置き換えます。--force を付けない場合、内容の異なる SKILL.md がすでにあると、marsdawn はそのファイルに触れず、内容が違うことを知らせて、終了コード 64（skill_differs）で終了します。ファイルがすでに最新なら、何も変わりません。

ほかのエージェントの場合

--dir に、お使いのエージェントがスキルを置くフォルダを指定すると、marsdawn はそこに SKILL.md を書き出します。

marsdawn skill --install --dir <path>

このファイルはただの Markdown で、説明とコマンドだけなので、指示ファイルを読むエージェントならそのまま使えます。

Homebrew やコマンドラインツールがない場合

先に marsdawn をインストールできない場合は、ファイルを直接ダウンロードします。

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

これはこのサイトにある最新のスキルを取得するので、古い marsdawn より新しいことがあります。ツールをインストールしたら、marsdawn skill --install --force で、それに合ったものに置き換えられます。エージェントにこの URL を指定するか、ファイルをそのまま貼り付けることもできます。このファイルは英語です。

教えること

marsdawn がなければ Homebrew でインストールし、バージョンを決め打ちせず marsdawn --version で確認する。
marsdawn export … --json で書き出し、結果を読み取る：PDF の書き出し先、ページ数、レンダリングされなかった Mermaid 図の有無。
終了コードで失敗の種類を見分ける：ファイルが見つからない、PDF がすでにある、書き出しに失敗した、オプションが不正、など。
marsdawn open file.md:line で自分が書いた文書を開き、最初の変更箇所に移動する。開くのは1回だけ：その後の編集は、開いているウインドウに自動的に反映される。
MarsDawn アプリがインストールされていなければ、一度だけそう伝えて作業を続け、再試行はしない。PDF を作るために open を使うことは絶対にない。
--folder（marsdawn 0.5.1 以降）を使ったときは、フォルダを「表示された」ではなく「表示を依頼した」と報告する：判断するのはアプリで、結果は返ってこない。

しないこと

何かを実行する権限を自分自身に与えることはありません。あなたのエージェントは、他のコマンドと同じように、marsdawn をインストールしたり実行したりする前に、あなたに確認します。
あなたの文書をどこかに送信することはありません。marsdawn はあなたの Mac 上でレンダリングし、--allow-remote-images を指定しない限りウェブからの画像を除外します。

すべての仕様、すべてのフィールドとコードはAI エージェント向け marsdawnにあります。