PDF Editor

---

name: pdf-editor-compdf version: 1.1.0 description: > PDF Editor edits and organizes PDF pages with merge, insert, reorder, exchange, and crop operations, built on ComPDF page management capabilities for fast PDF cleanup and document restructuring. It is a strong fit for requests such as “edit pdf,” “organize pdf pages,” “merge pdf,” “insert pages,” “reorder pdf pages,” “crop pdf pages,” and “rearrange pdf.” Example queries include “Merge these three PDFs into one file,” “Insert this appendix after page 8,” and “Reorder the pages and crop the white margins.” license: Proprietary. ComPDFKit SDK license obtained via online activation API. homepage: https://www.compdf.com compatibility: "[Windows] Requires Windows (x64/x86) and .NET Framework runtime | [Mac] Requires macOS (arm64/x86_64) with ComPDFKit.framework" metadata: clawdbot: emoji: "📑" os: - windows - macos requires: bins: - curl

---

PDF Editor — PDF Document Processing CLI Tool

Platform Detection (Agent must execute automatically)

Before running any CLI command, the Agent must automatically detect the platform (read env.platform: win32→Windows, darwin→Mac; or run uname -s). Do NOT ask the user about their platform.

| Variable | [Windows] | [Mac] | |------|-----------|-------| | | {skill_root}/scripts/win/compdf_cli.exe | {skill_root}/scripts/mac/compdf_cli | | | {skill_root}/scripts/win/license_key_windows.xml | {skill_root}/scripts/mac/license_key_mac.xml | | | {"email":""} | {"email":""} | | | {skill_root}/scripts/win/PDFA/sRGB2014.icc | {skill_root}/scripts/mac/PDFA/sRGB2014.icc | | | {skill_root}/scripts/win/PDFA/CoatedFOGRA39.icc | {skill_root}/scripts/mac/PDFA/CoatedFOGRA39.icc | | Shell syntax | cmd + REM | bash + # |

> {skill_root} = the absolute path of the directory containing this SKILL.md.

CLI Download & Installation (Required on first use)

The CLI binary is not included in the Skill package. It is downloaded from the official ComPDFKit distribution server (download.compdf.com) operated by PDF Technologies, Inc. The Agent must complete the following steps before the first execution:

1. Check whether exists → skip if it does 2. Inform the user that the CLI binary will be downloaded from download.compdf.com (official ComPDFKit CDN) 3. Download the appropriate archive for the platform: - [Windows]: https://download.compdf.com/skills/winCLI/win.zip - [Mac]: https://download.compdf.com/skills/macCLI/mac.zip 4. Extract the archive to the {skill_root}/scripts/ directory (the zip already contains a win/ or mac/ prefix, so the correct directory structure is formed automatically after extraction) 5. [Mac] After extraction, run: chmod +x {skill_root}/scripts/mac/compdf_cli 6. Verify: run --help to confirm the binary is executable

> Download is performed once on first use only; no re-download is needed on subsequent runs.

License Activation (Required on first use)

1. Check whether exists → skip if it does 2. Ask the user for their email address (explain: the email is sent to the official ComPDFKit license server to obtain a free trial license; no other data is transmitted) 3. After the user confirms, send POST https://wms.compdf.com/api/license/skillsTrial, Body: - code=200: write the data.license XML to - code=500: prompt the user to retry with a different email address 4. Run --help to verify activation

Common Options

The following options apply to all commands (they are not repeated in individual command references):

| Option | Description | Default | |------|------|--------| | --output, -o | Output file path or directory | Directory of the input file | | --name | Output filename | {original_filename}_{command_name}.pdf | | --overwrite | Allow overwriting existing files | No |

Command Reference

split — Split PDF

split [options]

| Option | Description | Default | |------|------|--------| | --mode | all=split into individual pages, range=split by range | all | | --range | Page range, e.g. "1-3" (range mode only) | — |

Output naming: all → {original_filename}_page_{page_number}.pdf; range → {original_filename}_pages_{start}-{end}.pdf

merge — Merge PDFs

merge [file3.pdf ...] [options]

> Encrypted PDFs are skipped automatically; if fewer than 2 unencrypted files remain, the command fails.

extract — Extract Pages

extract --range [options]

| Option | Description | |------|------| | --range | Required, e.g. "2-5" or "3" |

rotate — Rotate Pages

rotate --pages --angle <90|180|270> [options]

| Option | Description | |------|------| | --pages | Required, page range | | --angle <90\|180\|270> | Required, rotation angle |

delete — Delete Pages

delete --pages [options]

| Option | Description | |------|------| | --pages | Required, page range to delete |

insert — Insert Pages/Images

 insert  --source  --pages  --at  [options]
 insert  --image  --at  --width  --height  [options]

| Option | Description | |------|------| | --source | Source PDF (mutually exclusive with --image) | | --image | Image path (mutually exclusive with --source) | | --pages | Page range from the source PDF; --source mode only | | --at | Required, insert before page N (1-based) | | --width / --height | Image page dimensions; --image mode only (A4: 595×842) |

convert — Standard Format Conversion

convert --standard [options]

| Option | Description | Default | |------|------|--------| | --standard | Required: pdfa-1a pdfa-1b pdfa-2a pdfa-2b pdfa-2u pdfx-4 pdfe-1 pdfua-1 | — | | --icc | ICC profile file | or | | --title