arxiv-reading について
arxiv-readingは、arXiv論文を数式、表、章立てを保ったMarkdownに変換して読むためのリサーチスキルです。必要な図の取得方法と、HTML変換できない場合の代替手順も説明します。
主な機能
- 01arxiv2mdによる論文のMarkdown変換
- 02LaTeX数式、表、章立ての保持
- 03必要な図アセットの取得と表示
- 04古い論文向けの代替手順
活用シーン
- 01PDFから始めずに論文本文を読む
- 02論文の重要な図を確認する
- 03arXiv HTMLがない論文を読む
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ leo1oel/ leo-agent-skills --skill arxiv-readingインストール後、Claude Code で/arxiv-readingを入力して読み込まれたか確認します。
詳細
arXiv 論文を読む
PDF ではなく、読みやすい Markdown で論文を読みます。
論文から何を抽出し、どう評価するかという判断には、research-taste スキルを使います。
読む前に変換する
arXiv の論文は、arXiv の構造化 HTML を解析し、数式を LaTeX のまま保持して、実際の表とセクションツリーも含めてくれる arxiv2md で Markdown に変換します。
uvx --from arxiv2markdown arxiv2md <id> -o paper.md
/abs/、/pdf/、/html/ の URL 形式では同じ ID が使われるため、PDF のリンクも使えます。ID だけを取り出してください。
図
arxiv2md はテキスト、数式、表を保持しますが、図はダウンロードしません。
各図は Markdown 内に Refer to caption: 2501.11120v1/x1.png のような機能しない行として表示されます。これは相対アセットパスであり、URL でも保存済みファイルでもありません。
図を実際に表示するには、そのパスを https://arxiv.org/html/ を基準に解決してアセットをダウンロードし、Read ツールで開きます(Read は画像を視覚的に表示します)。
curl -sL https://arxiv.org/html/2501.11120v1/x1.png -o fig1.png
次に Read で fig1.png を読み込みます。
論文の読み込みを arxiv2md 経由にする事前ツール使用フックでは、画像アセットのダウンロード(.png、.jpg、.svg など)は許可しつつ、HTML/PDF の論文を直接取得することは引き続きブロックします。そのため、HTML ページ全体ではなく、図を1ファイルずつ取得してください。
必要な図だけをダウンロードしてください。ほとんどの論文は、テキストと主要な図を数点読むだけで十分です。
フォールバック
arxiv2md で扱える HTML がない場合(arXiv がまだ HTML に変換していない古い論文)、次の順で試します。
https://ar5iv.org/abs/<id>に対して、具体的な質問を指定して WebFetch を使います。ar5iv は、ほとんどの古い論文について LaTeX ソースから HTML を生成します。- PDF は最後の手段としてのみ使用します。Read ツールで、全文を無差別に出力するのではなく、ページ範囲を指定して読みます。要旨だけで、それ以上読む価値がないと判断できる場合もよくあります。