メニュー
ローカルPDFをLLM投入前にトークン効率のよいMarkdownへ変換する。Microsoft MarkItDownをuv管理のPython環境で実行する。PDFのトークン消費を抑えたい場合、PDF内容をMarkdownで確認したい場合、複数PDFを一括変換したい場合、再利用可能なローカル変換成果物を作る場合に使う。高忠実度の視覚再現、法務監査級の抽出、クラウドOCR、未ダウンロードまたは信頼未確認のURL入力には使わない。
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
SOC 職業分類に基づく
日本語の文章で文と文のつながりを点検し、直前の文の不足、常識的な連続性、読者視点から論理のほころびを防ぐ。エッセイ、記事、レポート、解説文の執筆・推敲・レビューで使う。法的判断、数学的証明、事実確認のみ、文法校正のみ、意図的なシュール表現や断片的表現の矯正には使わない。
日本語の文章を、誇張、借り物の美辞麗句、過剰な謙遜を避け、実感に近い等身大な表現へ整える。エッセイ、プロフィール、商品説明、自己紹介、note、スピーチ、振り返り文の推敲で使う。法的文書、逐語訳、意図的に言葉を高める詩、学術的な出典確認、事実検証には使わない。
macOSのスクリーンショットを、screencaptureと補助CLIで取得する。画面全体、ウィンドウ指定、選択範囲、タイマー撮影、クリップボード保存に対応する。macOS上でエージェントが再現可能なパスへスクリーンショットを保存したい場合に使う。OCR、画像編集、動画収録、macOS以外のスクリーンショット取得には使わない。
文章、記事、レポート、企画書の論理破綻をレビューし、論点、必要情報、推論、結論と根拠の構造を確認する。Why So、So What、MECEの観点で飛躍、矛盾、論点ずれ、根拠不足を検出する。公開前や改稿前に文章の筋道を点検するときに使う。単なる校正、文体調整、事実確認のみ、法的助言、数学的証明の厳密検証には使わない。
UI 変更や状態遷移を伴う PR に、E2E テスト計画・操作後スクリーンショット・検証結果・検証データの副作用を確認エビデンスとして残す。 gh image で画像をアップロードし、Chrome DevTools MCP で画面を操作・撮影し、gh でテスト計画と結果を PR コメントへ投稿する際に使用。 「PR にスクショを貼る」「UI エビデンスを残す」「E2E 確認結果を PR にまとめる」「レビュー用に画面の証跡を添付」と依頼された時に適用。 内部ロジックのみの変更や、既存の自動テストで担保できる変更には使わない。コミット作成や PR 本体の作成フローには使わない。
WXTを使ったブラウザ拡張開発を支援する。プロジェクト調査、entrypoint設計、manifestと権限変更、content script UI、storage、messaging、build、zip、ブラウザ検証を扱う。WXTプロジェクトの作成、変更、監査、デバッグ時に使う。非WXT拡張、汎用フロントエンド、拡張ストア審査には使わない。
| name | pdf-markdown-local |
| description | ローカルPDFをLLM投入前にトークン効率のよいMarkdownへ変換する。Microsoft MarkItDownをuv管理のPython環境で実行する。PDFのトークン消費を抑えたい場合、PDF内容をMarkdownで確認したい場合、複数PDFを一括変換したい場合、再利用可能なローカル変換成果物を作る場合に使う。高忠実度の視覚再現、法務監査級の抽出、クラウドOCR、未ダウンロードまたは信頼未確認のURL入力には使わない。 |
LLMにPDF本文を渡す前に、ローカルPDFをMarkdownへ変換する。変換にはMicrosoft MarkItDownを使い、依存関係はuvで隔離して、呼び出し元プロジェクトのPython環境を汚さない。
入力が信頼できるローカルPDFパスであることを確認する。
コマンド構文、依存関係の選択、品質上の注意点が必要な場合だけ、references/markitdown-uv-notes.mdを読む。
出力Markdownパスを決める。
.mdを付ける。例: paper.pdf -> paper.md。このスキルディレクトリから、同梱コンバータをuvで実行する。標準では同一ディレクトリへ出力するため、--outputは省略する。
uv run scripts/convert_pdf.py path/to/input.pdf
既存Markdownを意図的に置き換える場合だけ、--overwriteを付ける。
同一ディレクトリに出力されたMarkdownが存在し、空でないことを確認する。
test -s path/to/input.md && wc -c path/to/input.md
Markdownを根拠として使う前に、抽出品質をスポットチェックする。
要手動確認として扱う。スポットチェックに通った場合、または制約を明記した場合だけ、下流のLLM読解にMarkdownを使う。
PDFごとに1回ずつ変換し、エラーが出たら停止する。
for pdf in path/to/pdfs/*.pdf; do
uv run scripts/convert_pdf.py "$pdf"
done
一括変換後は、ls -lh path/to/pdfs/*.mdを実行し、代表ファイルをスポットチェックする。
呼び出し元が監査可能な記録を必要とする場合は、assets/conversion-report-template.mdを使う。元PDF、出力Markdownパス、実行コマンド、文字数、状態、スポットチェック結果を記録する。
uvが見つからない場合は、blocked: uv is not installed or not on PATHと報告する。インストール方法は、依頼された場合だけreferences/markitdown-uv-notes.mdの情報を示す。要手動確認とする。PDFがスキャン画像、暗号化済み、画像のみ、未対応形式である可能性は、可能性としてだけ述べる。変換成果物を引き渡す前に、以下を確認する。
uv run scripts/convert_pdf.py、または文書化されたuvフォールバックを使った。