Communitygithub.com

PDF スキル

学術文献レビュー、アカデミックライティング、図表作成、バイオインフォマティクス、研究成果物のための再利用可能なエージェントスキル。

PDF スキル とは?

このスキルは、PDF ドキュメントの読み取り、作成、検証を支援します。視覚的なレイアウトと書式が重要な学術論文やレポートの作成に特に有用です。主に Claude Code などの AI エージェント向けに設計されています。ワークフローでは、pdftoppm を用いた PNG レンダリングによる視覚確認、reportlab による PDF 生成、pdfplumber や pypdf によるテキスト抽出を行います。依存関係は uv で管理し、Poppler などのシステムツールも必要に応じてインストールします。最終的な品質チェックとして、レンダリング画像に欠陥がないかを確認し、フォーマットや引用が適切であることを保証します。

対応~Claude Code~Codex CLI~Cursor
npx skills add zhoy0409-debug/scholarflow-skills

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

PDF スキル は何をしますか?

使用するタイミング

  • レイアウトやビジュアルが重要なPDFコンテンツを読んだりレビューしたりする場合。
  • 信頼性の高いフォーマットでプログラム的にPDFを作成する場合。
  • 納品前に最終レンダリングを検証する場合。

ワークフロー

  1. 視覚的なレビューを優先:PDFページをPNGにレンダリングし、検査します。
    • pdftoppm が利用可能な場合はそれを使用します。
    • 利用できない場合は、Poppler をインストールするか、ユーザーにローカルで出力を確認してもらいます。
  2. 新しいドキュメントを作成する際は、reportlab を使用してPDFを生成します。
  3. テキスト抽出や簡単なチェックには pdfplumber(または pypdf)を使用しますが、レイアウトの忠実性をそれに頼ってはいけません。
  4. 意味のある更新のたびに、ページを再レンダリングし、配置、間隔、可読性を確認します。

一時ファイルと出力の規則

  • 中間ファイルは tmp/pdfs/ を使用し、完了したら削除します。
  • このリポジトリで作業する場合、最終成果物は output/pdf/ に書き込みます。
  • ファイル名は安定していて説明的なものにします。

依存関係(不足している場合はインストール)

依存管理には uv を優先します。

Python パッケージ:

uv pip install reportlab pdfplumber pypdf

uv が利用できない場合:

python3 -m pip install reportlab pdfplumber pypdf

システムツール(レンダリング用):

# macOS (Homebrew)
brew install poppler

# Ubuntu/Debian
sudo apt-get install -y poppler-utils

この環境でインストールできない場合は、不足している依存関係とそのローカルインストール方法をユーザーに伝えてください。

環境

必要な環境変数はありません。

レンダリングコマンド

pdftoppm -png $INPUT_PDF $OUTPUT_PREFIX

品質要件

  • 洗練されたビジュアルデザインを維持する:一貫したタイポグラフィ、スペーシング、マージン、セクション階層。
  • レンダリングの問題を避ける:テキストのクリッピング、要素の重なり、壊れたテーブル、黒い四角、判読不能なグリフ。
  • チャート、表、画像は鮮明で、整列し、明確にラベル付けされている必要があります。
  • ASCII ハイフンのみを使用してください。U+2011(ノーブレークハイフン)やその他の Unicode ダッシュは避けてください。
  • 引用と参考文献は人間が読める形式でなければなりません。ツールトークンやプレースホルダー文字列を残さないでください。

最終チェック

  • 最新のPNG検査で視覚的または書式の欠陥がゼロであることを確認するまで納品しないでください。
  • ヘッダー/フッター、ページ番号、セクションの移行が洗練されていることを確認します。
  • 中間ファイルは整理するか、最終承認後に削除します。

関連スキル