compdf-page-editor について
PDF のページ管理を行うエージェント向けスキルで、ComPDF Server API のエンドポイント選択とリクエスト計画を支援します。結合、分割、回転、挿入、削除、抽出に対応し、破壊的な編集には確認を求めます。
主な機能
- 01複数の PDF の結合
- 02PDF ファイルの分割
- 03ページの回転
- 04ページの挿入または削除
- 05指定ページや範囲の抽出
- 06ページ範囲の検証と編集前の確認
活用シーン
- 01レビュー用 PDF の準備
- 02大きな文書の分割
- 03ページ単位での並べ替えや抽出
- 04保管や納品用ファイルの準備
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ compdfkit/ compdf-skills --skill compdf-page-editorインストール後、Claude Code で/compdf-page-editorを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
agents/openai.yamlreferences/endpoint-index.mdofficial-api-reference.md詳細
ComPDF Page Editor
概要
ComPDF Page Editor は、AI エージェントが文書を組み立て、整理し、再構成するための、PDF ページ管理に特化したスキルです。複数の PDF の結合、大きなファイルの分割、ページの回転、新しいページの挿入、ページの削除、選択したページや範囲の抽出に対応しています。レビュー、ファイリング、納品、自動化の前に行う文書準備のワークフローに適しています。
以下で対応している操作について、正式な ComPDF Server API エンドポイントを選択し、正確なリクエスト計画を準備するには、このスキルを使用してください。
対応操作
| 操作 | 正式なページまたはインデックスのセクション |
|---|---|
| PDF の結合 | merge |
| PDF の分割 | split |
| ページの回転 | rotate |
| ページの挿入 | insert |
| ページの削除 | delete |
| ページの抽出 | extract |
対象範囲
ページ管理のエンドポイントのみを使用してください。ページ範囲は 1 始まりで検証し、破壊的な編集については、すでに許可されている場合を除き、確認を求めてください。
ワークフロー
- 元ファイルの種類、希望する出力、依頼された操作を特定します。
references/endpoint-index.mdを読み、このスキルの対応操作に記載された操作のみを選択します。references/official-api-reference.mdの該当する見出しを読みます。そこに記載された正確なエンドポイントパス、リクエストフィールド、リクエストモード、レスポンスフィールドを使用し、対応していないオプションを推測しないでください。- すべての ComPDF API リクエストに
sourceType=5を含めます。これは統合ルーティングパラメーターとして扱い、ユーザーからリクエストの詳細を求められた場合は、その詳細にも含めてください。 - 小規模な対話型の処理では、同期モードを優先します。大規模なアップロード、バッチ処理、またはセキュリティ上慎重な対応が必要なアップロードでは、ドキュメントに記載された非同期または署名付き URL のワークフローに従ってください。
- 認証情報は、
SKILL.mdが置かれているディレクトリ内のapi_keyからのみ取得します。最初の空でない行を読み取ってください。環境変数やその他のローカルパスは調べないでください。ファイルが存在しない、読み取れない、または空の場合は、ユーザーに API キーの提供を依頼し、保存についてユーザーが確認した後に限り、このスキル専用のapi_keyファイルのみを作成または置き換えてください。キーを表示、ログ記録、コミットしたり、リクエスト例や最終出力に含めたりしないでください。 - ComPDF に文書をアップロードする前に、対象ファイルと保存先を特定し、ユーザーが明示的にアップロードを許可していない限り確認を得てください。また、上書き、削除、復号、永続的な保護の適用を行う操作の前にも確認を得てください。
- エンドポイント、メソッド、コンテンツタイプ、すべてのリクエストフィールド、想定されるタスク/結果フィールド、次のポーリングまたはダウンロード手順を提示します。置き換えが明示的に依頼されていない限り、元のファイルを保持してください。
認証情報
現在のスキルの API キーのみを、同じディレクトリにある api_key ファイルに保存してください。このファイルはプライベートな実行時データであり、バージョン管理とスキルの公開から除外する必要があります。
API キーを取得するには、ComPDF Portal で登録またはサインインしてください。初回使用時は、求められたらキーを提供し、スキル専用の api_key ファイルへの保存を確認してください。以降のリクエストでは、保存済みのキーを再利用します。