compdf-pdf-to-word について
ComPDF の公式 API ドキュメントに基づき、チームやエージェント向けに PDF から Word へのリクエストを計画するスキルです。出力を Word に限定し、根拠のないオプションを加えずにリクエスト内容と後続手順を示します。
主な機能
- 01PDF から Word への変換に限定
- 02公式ドキュメントに基づくエンドポイントと項目の選定
- 03同期または非同期リクエストの計画
- 04文書アップロード前の確認
- 05スキルディレクトリからの API キー読み込み
活用シーン
- 01契約書 PDF を編集可能な Word に変換
- 02小規模な対話型処理の同期変換を計画
- 03一括または機密性の高いアップロードの非同期処理を計画
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ compdfkit/ compdf-skills --skill compdf-pdf-to-wordインストール後、Claude Code で/compdf-pdf-to-wordを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
agents/openai.yamlreferences/endpoint-index.mdofficial-api-reference.md詳細
ComPDF PDF から Word へ
概要
ComPDF PDF to Word を使うと、チームや AI エージェントは、元のレイアウト、テキスト、視覚的な構造を可能な限り維持しながら、PDF ファイルを編集可能な Word 文書に変換できます。契約書、レポート、フォーム、提案書などを PDF で受け取った後、すばやく編集、ローカライズ、注釈の追加、社内での改訂を行う必要がある場合に特に役立ちます。
このスキルを使って、公式の ComPDF Server API エンドポイントを選択し、以下でサポートされる操作に対する正確なリクエスト計画を作成します。
サポートされる操作
| 操作 | 公式ページまたはインデックスのセクション |
|---|---|
| PDF から Word へ | pdf-to-word |
対象範囲
Word 形式の出力のみを生成します。別の PDF 変換エンドポイントで代用しないでください。
ワークフロー
- 元ファイルの種類、希望する出力、依頼された操作を特定します。
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 ファイルへの保存を確認します。以降のリクエストでは、保存されたキーを再利用します。