{"id":"c5f5f8d3-b870-433f-9a45-b15bde1b0e92","entityType":"agent","slug":"clawhub-compdf-youna-pdf-editor-compdf","name":"PDF Editor","canonicalUrl":"https://www.xpersona.co/agent/clawhub-compdf-youna-pdf-editor-compdf","canonicalPath":"/agent/clawhub-compdf-youna-pdf-editor-compdf","generatedAt":"2026-10-10T08:44:17.855Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-10T04:16:55.527Z","emptyReason":null},"description":"PDF Editor edits and organizes PDF pages with merge, insert, reorder, exchange, and crop operations, built on ComPDF page management capabilities for fast PD...","descriptionLabel":"Source description","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 1.7K downloads reported by the source. Last updated 10/10/2026.","installCommand":"clawhub skill install s178t897hzzp9pvkwbav4e2kfs83g980:pdf-editor-compdf","sourceUrl":"https://clawhub.ai/compdf-youna/pdf-editor-compdf","homepage":"https://clawhub.ai/compdf-youna/skills/pdf-editor-compdf","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/compdf-youna/pdf-editor-compdf","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/compdf-youna/skills/pdf-editor-compdf","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":42,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"PDF Editor technical dossier on Xpersona with agent coverage, OPENCLEW support, and live trust metadata."},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-10T04:16:55.527Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-10T04:16:55.527Z","emptyReason":null},"stars":null,"forks":null,"downloads":1695,"packageName":null,"latestVersion":"1.2.0","tractionLabel":"1.7K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-10T04:16:55.527Z","emptyReason":null},"lastUpdatedAt":"2026-10-10T04:16:55.527Z","lastCrawledAt":"2026-10-10T04:16:55.527Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-11T04:16:55.527Z","lastVerifiedAt":null,"highlights":[{"version":"1.2.0","createdAt":"2026-06-24T03:49:26.701Z","changelog":"Version 1.2.0 - Updated the skill homepage URL to include UTM parameters for improved referral tracking. - Removed the file: skill-card.md. - No functional or CLI/API changes.","fileCount":4,"zipByteSize":8869},{"version":"1.1.0","createdAt":"2026-04-29T11:30:08.047Z","changelog":"- Skill description updated to focus on PDF page management: merge, insert, reorder, exchange, and crop operations. - New examples in the description clarify supported queries such as merging, inserting, and rearranging PDF pages. - Previous references to document comparison, watermark management, and text analysis removed from the skill description. - Command reference, installation, activation, and options remain unchanged.","fileCount":4,"zipByteSize":8096},{"version":"1.0.1","createdAt":"2026-03-25T06:51:07.530Z","changelog":"Security & Transparency - Added official source declaration for CLI download (download.compdf.com) - Download flow now notifies user of source before proceeding - License activation clarifies email is used solely for trial license; requires user confirmation - Security & Privacy table expanded with download endpoint, user consent column, and official source statement (PDF Technologies, Inc.)","fileCount":3,"zipByteSize":6680},{"version":"1.0.0","createdAt":"2026-03-25T06:15:41.099Z","changelog":"Initial release — PDF Editor CLI Tool for advanced PDF processing - Enables automated editing and processing of PDFs via ComPDFKit CLI: split, merge, extract, insert, rotate, and delete pages. - Supports document comparison, PDF optimization & compression, and file format conversion (PDF/A, PDF/X, PDF/UA, etc.). - Provides comprehensive watermark management (add/remove). - Automatic platform detection, CLI download/installation, and license activation included. - Designed for robust post-processing and reorganization of PDF files, supporting both Windows and macOS.","fileCount":3,"zipByteSize":6387}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s178t897hzzp9pvkwbav4e2kfs83g980:pdf-editor-compdf","setupComplexity":"low","setupSteps":["Install using `clawhub skill install s178t897hzzp9pvkwbav4e2kfs83g980:pdf-editor-compdf` in an isolated environment before connecting it to live workloads.","No published capability contract is available yet, so validate auth and request/response behavior manually.","Review the upstream CLAWHUB listing at https://clawhub.ai/compdf-youna/pdf-editor-compdf before using production credentials."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-compdf-youna-pdf-editor-compdf/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-compdf-youna-pdf-editor-compdf/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-compdf-youna-pdf-editor-compdf/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-compdf-youna-pdf-editor-compdf/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-compdf-youna-pdf-editor-compdf/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-compdf-youna-pdf-editor-compdf/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-10T08:44:17.851Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-compdf-youna-pdf-editor-compdf/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-compdf-youna-pdf-editor-compdf/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-compdf-youna-pdf-editor-compdf/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-compdf-youna-pdf-editor-compdf/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-10T04:16:55.527Z","emptyReason":null},"readme":"Skill: PDF Editor\n\nOwner: compdf-youna\n\nSummary: PDF Editor edits and organizes PDF pages with merge, insert, reorder, exchange, and crop operations, built on ComPDF page management capabilities for fast PD...\n\nTags: latest:1.2.0\n\nVersion history:\n\nv1.2.0 | 2026-06-24T03:49:26.701Z | user\n\nVersion 1.2.0\n\n- Updated the skill homepage URL to include UTM parameters for improved referral tracking.\n- Removed the file: skill-card.md.\n- No functional or CLI/API changes.\n\nv1.1.0 | 2026-04-29T11:30:08.047Z | user\n\n- Skill description updated to focus on PDF page management: merge, insert, reorder, exchange, and crop operations.\n- New examples in the description clarify supported queries such as merging, inserting, and rearranging PDF pages.\n- Previous references to document comparison, watermark management, and text analysis removed from the skill description.\n- Command reference, installation, activation, and options remain unchanged.\n\nv1.0.1 | 2026-03-25T06:51:07.530Z | user\n\nSecurity & Transparency\n- Added official source declaration for CLI download (download.compdf.com)\n- Download flow now notifies user of source before proceeding\n- License activation clarifies email is used solely for trial license; requires user confirmation\n- Security & Privacy table expanded with download endpoint, user consent column, and official source statement (PDF Technologies, Inc.)\n\nv1.0.0 | 2026-03-25T06:15:41.099Z | user\n\nInitial release — PDF Editor CLI Tool for advanced PDF processing\n\n- Enables automated editing and processing of PDFs via ComPDFKit CLI: split, merge, extract, insert, rotate, and delete pages.\n- Supports document comparison, PDF optimization & compression, and file format conversion (PDF/A, PDF/X, PDF/UA, etc.).\n- Provides comprehensive watermark management (add/remove).\n- Automatic platform detection, CLI download/installation, and license activation included.\n- Designed for robust post-processing and reorganization of PDF files, supporting both Windows and macOS.\n\nArchive index:\n\nArchive v1.2.0: 4 files, 8869 bytes\n\nFiles: License.txt (1900b), skill-card.md (2669b), SKILL.md (21621b), _meta.json (136b)\n\nFile v1.2.0:SKILL.md\n\n---\nname: pdf-editor-compdf\nversion: 1.2.0\ndescription: >\n 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.”\nlicense: Proprietary. ComPDFKit SDK license obtained via online activation API.\nhomepage: https://www.compdf.com/?utm_source=clawhub&utm_medium=skillhub&utm_campaign=pdf_skill_pdf_editor&ref_platform_id=clawhub_skills\ncompatibility: \"[Windows] Requires Windows (x64/x86) and .NET Framework runtime | [Mac] Requires macOS (arm64/x86_64) with ComPDFKit.framework\"\nmetadata:\n clawdbot:\n emoji: \"📑\"\n os:\n - windows\n - macos\n requires:\n bins:\n - curl\n---\n# PDF Editor — PDF Document Processing CLI Tool\n\n## Platform Detection (Agent must execute automatically)\n\nBefore 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.**\n\n\n| Variable | [Windows] | [Mac] |\n| -------------------- | -------------------------------------------------- | ------------------------------------------------- |\n| `` | `{skill_root}/scripts/win/compdf_cli.exe` | `{skill_root}/scripts/mac/compdf_cli` |\n| `` | `{skill_root}/scripts/win/license_key_windows.xml` | `{skill_root}/scripts/mac/license_key_mac.xml` |\n| `` | `{\"email\":\"\"}` | `{\"email\":\"\"}` |\n| `` | `{skill_root}/scripts/win/PDFA/sRGB2014.icc` | `{skill_root}/scripts/mac/PDFA/sRGB2014.icc` |\n| `` | `{skill_root}/scripts/win/PDFA/CoatedFOGRA39.icc` | `{skill_root}/scripts/mac/PDFA/CoatedFOGRA39.icc` |\n| Shell syntax | `cmd` + `REM` | `bash` + `#` |\n\n> `{skill_root}` = the absolute path of the directory containing this SKILL.md.\n\n## CLI Download & Installation (Required on first use)\n\nThe 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:\n\n1. Check whether `` exists → skip if it does\n2. **Inform the user** that the CLI binary will be downloaded from `download.compdf.com` (official ComPDFKit CDN)\n3. Download the appropriate archive for the platform:\n - **[Windows]**: `https://download.compdf.com/skills/winCLI/win.zip`\n - **[Mac]**: `https://download.compdf.com/skills/macCLI/mac.zip`\n4. 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)\n5. **[Mac]** After extraction, run: `chmod +x {skill_root}/scripts/mac/compdf_cli`\n6. Verify: run ` --help` to confirm the binary is executable\n\n> Download is performed once on first use only; no re-download is needed on subsequent runs.\n\n## License Activation (Required on first use)\n\n1. Check whether `` exists → skip if it does\n2. 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**)\n3. **After the user confirms**, send `POST https://wms.compdf.com/api/license/skillsTrial`, Body: ``\n - `code=200`: write the `data.license` XML to ``\n - `code=500`: prompt the user to retry with a different email address\n4. Run ` --help` to verify activation\n\n## Common Options\n\nThe following options apply to **all commands** (they are not repeated in individual command references):\n\n\n| Option | Description | Default |\n| --------------------- | -------------------------------- | ---------------------------------------- |\n| `--output, -o ` | Output file path or directory | Directory of the input file |\n| `--name ` | Output filename | `{original_filename}_{command_name}.pdf` |\n| `--overwrite` | Allow overwriting existing files | No |\n\n## Command Reference\n\n### split — Split PDF\n\n` split [options]`\n\n\n| Option | Description | Default |\n| -------------------- | --------------------------------------------------------- | ------- |\n| `--mode ` | `all`=split into individual pages, `range`=split by range | `all` |\n| `--range ` | Page range, e.g.`\"1-3\"` (range mode only) | — |\n\nOutput naming: `all` → `{original_filename}_page_{page_number}.pdf`; `range` → `{original_filename}_pages_{start}-{end}.pdf`\n\n### merge — Merge PDFs\n\n` merge [file3.pdf ...] [options]`\n\n> Encrypted PDFs are skipped automatically; if fewer than 2 unencrypted files remain, the command fails.\n\n### extract — Extract Pages\n\n` extract --range [options]`\n\n\n| Option | Description |\n| ----------------- | ----------------------------------- |\n| `--range ` | **Required**, e.g. `\"2-5\"` or `\"3\"` |\n\n### rotate — Rotate Pages\n\n` rotate --pages --angle <90|180|270> [options]`\n\n\n| Option | Description |\n| ---------------------- | ------------------------ |\n| `--pages ` | Required, page range |\n| `--angle <90|180|270>` | Required, rotation angle |\n\n### delete — Delete Pages\n\n` delete --pages [options]`\n\n\n| Option | Description |\n| ----------------- | ------------------------------ |\n| `--pages ` | Required, page range to delete |\n\n### insert — Insert Pages/Images\n\n```\n insert --source --pages --at [options]\n insert --image --at --width --height [options]\n```\n\n\n| Option | Description |\n| --------------------------------------- | -------------------------------------------------------- |\n| `--source ` | Source PDF (mutually exclusive with`--image`) |\n| `--image ` | Image path (mutually exclusive with`--source`) |\n| `--pages ` | Page range from the source PDF;`--source` mode only |\n| `--at ` | Required, insert before page N (1-based) |\n| `--width ` / `--height ` | Image page dimensions;`--image` mode only (A4: 595×842) |\n\n### convert — Standard Format Conversion\n\n` convert --standard [options]`\n\n\n| Option | Description | Default |\n| ----------------------- | ------------------------------------------------------------------------------------------- | ----------------------------- |\n| `--standard` | **Required**: `pdfa-1a` `pdfa-1b` `pdfa-2a` `pdfa-2b` `pdfa-2u` `pdfx-4` `pdfe-1` `pdfua-1` | — |\n| `--icc ` | ICC profile file | `` or `` |\n| `--title ` | PDF/UA title (`pdfua-1` only) | Input filename |\n| `--language <language>` | PDF/UA language (`pdfua-1` only) | Win:`en-US` / Mac: `en` |\n\n`--language` supported values: Win `en-US`/`zh-CN`/`ja-JP`/`ko-KR`/`fr-FR`/`de-DE` | Mac `en`/`zh`/`ja`/`ko`\n\n**Examples**:\n\n```\n<CLI> convert \"report.pdf\" --standard pdfa-1a --overwrite\n<CLI> convert \"report.pdf\" --standard pdfua-1 --title \"My Document\" --language zh-CN --overwrite\n```\n\n### optimize — Document Optimization & Compression\n\n`<CLI> optimize <input.pdf> [options]`\n\n\n| Option | Description | Default |\n| ------------------------- | ------------------------------------------- | -------------------- |\n| `--compress-images` | Enable image compression | No |\n| `--image-quality <0-100>` | Image quality | `50` |\n| `--target-ppi <integer>` | Target image PPI | `150` |\n| `--upper-ppi <integer>` | Compression upper-limit PPI | Win`300` / Mac `225` |\n| `--image-alg <algorithm>` | `jpeg`/`jpeg2000`/`jbig2`/`ccitt3`/`ccitt4` | `jpeg2000` |\n| `--fast-web-view` | Fast Web View optimization | No |\n| `--optimize-page-content` | Page content optimization | No |\n| `--remove-annotations` | Remove annotations | No |\n| `--remove-bookmarks` | Remove bookmarks | No |\n| `--remove-form` | Remove forms | No |\n| `--remove-metadata` | Remove metadata | No |\n| `--remove-doc-info` | Remove document info | No |\n| `--incremental` | Incremental save mode | No |\n\nDefault behavior: removes unused/empty objects and enables Flate compression. Image compression is only enabled when `--compress-images` or image-related parameters are explicitly passed.\n\n**Examples**:\n\n```\n<CLI> optimize \"report.pdf\" --overwrite\n<CLI> optimize \"report.pdf\" --compress-images --image-quality 55 --target-ppi 144 --overwrite\n```\n\n### compare — Overlay Document Comparison\n\n`<CLI> compare <old.pdf> <new.pdf> [options]`\n\n\n| Option | Description | Default |\n| ------------------------------------------- | ---------------------------------------------------------------------- | --------------------- |\n| `--old-pages` / `--new-pages` | Page range | All pages |\n| `--old-color` / `--new-color` | Stroke color`R,G,B` | `255,0,0` / `0,0,255` |\n| `--old-stroke-alpha` / `--new-stroke-alpha` | Stroke opacity 0-1 | `0.8` |\n| `--old-fill-alpha` / `--new-fill-alpha` | Fill opacity 0-1 | `0.2` |\n| `--no-fill` | Hide fill | No |\n| `--blend-mode` | `normal`/`multiply`/`screen`/`overlay`/`darken`/`lighten`/`difference` | `overlay` |\n\n### watermark-text — Add Text Watermark\n\n`<CLI> watermark-text <input.pdf> --text <content> [options]`\n\n### watermark-image — Add Image Watermark\n\n`<CLI> watermark-image <input.pdf> --image <image_path> [options]`\n\n### Shared Watermark Options\n\n\n| Option | Description | [Win] Default | [Mac] Default |\n| ----------------------------- | -------------------------------------------------- | ------------- | ----------------------------- |\n| `--text <content>` | Watermark text (watermark-text only) | — | — |\n| `--image <path>` | Image path (watermark-image only) | — | — |\n| `--pages <range>` | Page range to apply | All | All |\n| `--font <font>` | Font (text only) | `Helvetica` | `Helvetica` |\n| `--font-size` | Font size (text only) | `24` | `48.0` |\n| `--color <R,G,B>` | Text color (text only) | `192,192,192` | `0,0,0` |\n| `--opacity` | Opacity | `120` (0-255) | `0.5` (0-1) |\n| `--rotation` | Rotation angle | `45` | `0.0` |\n| `--scale` | Scale factor | `1.0` | `1.0` |\n| `--h-align` / `--v-align` | Alignment`left|center|right` / `top|center|bottom` | `center` | `center` |\n| `--x-offset` / `--y-offset` | Offset | `0` | `0` |\n| `--h-spacing` / `--v-spacing` | Spacing | `80` | `0.0` |\n| `--front` / `--back` | Foreground/background | Foreground | Foreground |\n| `--full-screen` / `--single` | Tiled/single | Tiled | **Must be passed explicitly** |\n\n> **⚠️ Mac**: `--full-screen` is not enabled by default; tiled watermarks must be passed explicitly.\n\n**Examples** — [Windows]:\n\n```cmd\n<CLI> watermark-text \"report.pdf\" --text \"CONFIDENTIAL\" --overwrite\n<CLI> watermark-image \"report.pdf\" --image \"logo.png\" --scale 0.5 --opacity 100 --overwrite\n```\n\n**Examples** — [Mac]:\n\n```bash\n<CLI> watermark-text \"report.pdf\" --text \"CONFIDENTIAL\" --full-screen --overwrite\n<CLI> watermark-image \"report.pdf\" --image \"logo.png\" --scale 0.5 --opacity 0.3 --full-screen --overwrite\n```\n\n### watermark-delete — Remove All Watermarks\n\n`<CLI> watermark-delete <input.pdf> [options]`\n\n> [Win] `DeleteWatermarks()` removes all watermarks; [Mac] iterates and removes one by one. Selective removal is not supported.\n\n## Exit Codes\n\n\n| Code | Meaning | Action |\n| ---- | --------------- | ------------------------------------------------------------ |\n| `0` | Success | — |\n| `1` | Parameter error | Check required parameters |\n| `2` | File not found | Check path; wrap paths with spaces in double quotes |\n| `3` | Runtime error | PDF processing failed or output directory is not writable |\n| `4` | License failure | Missing → run activation; Expired → direct user to[contact sales](https://www.compdf.com/contact-sales?utm_source=clawhub&utm_medium=skillhub&utm_campaign=pdf_skill_pdf_editor&ref_platform_id=clawhub_skills) |\n\n## Usage Patterns (Agent quick reference)\n\n\n| User says | Command |\n| ------------------------- | ----------------------------------------------------------------------------------------- |\n| \"Split into single pages\" | `<CLI> split \"input.pdf\" --mode all --overwrite` |\n| \"Merge PDFs\" | `<CLI> merge \"a.pdf\" \"b.pdf\" --output \"merged.pdf\" --overwrite` |\n| \"Extract pages X to Y\" | `<CLI> extract \"input.pdf\" --range X-Y --output \"out.pdf\" --overwrite` |\n| \"Convert to PDF/A\" | `<CLI> convert \"input.pdf\" --standard pdfa-1a --overwrite` |\n| \"Compress PDF\" | `<CLI> optimize \"input.pdf\" --compress-images --image-quality 50 --overwrite` |\n| \"Compare two PDFs\" | `<CLI> compare \"old.pdf\" \"new.pdf\" --overwrite` |\n| \"Add text watermark\" | `<CLI> watermark-text \"input.pdf\" --text \"CONFIDENTIAL\" --overwrite` |\n| \"Add image watermark\" | `<CLI> watermark-image \"input.pdf\" --image \"logo.png\" --overwrite` |\n| \"Remove watermark\" | `<CLI> watermark-delete \"input.pdf\" --overwrite` |\n| \"Rotate pages\" | `<CLI> rotate \"input.pdf\" --pages X-Y --angle 90 --overwrite` |\n| \"Delete page X\" | `<CLI> delete \"input.pdf\" --pages X --overwrite` |\n| \"Insert pages\" | `<CLI> insert \"target.pdf\" --source \"src.pdf\" --pages X --at N --overwrite` |\n| \"Insert image\" | `<CLI> insert \"target.pdf\" --image \"img.png\" --at N --width 595 --height 842 --overwrite` |\n\n> ⚠️ Mac watermark commands require `--full-screen` to be passed explicitly (when tiling is desired).\n\n## Limitations\n\n1. Page ranges only support `\"N\"` or `\"N-M\"`; comma-separated values are not supported\n2. Except for `merge` (which skips encrypted files automatically), encrypted PDFs will cause an error and exit\n3. Wildcards, output path equal to input path, and multi-threaded parallel execution are not supported\n4. Results of standard format conversion and optimization depend on the content of the input PDF\n5. `watermark-delete` removes all watermarks; selective removal is not supported\n6. `compare` performs visual overlay comparison and does not output a structured diff list\n\n## Troubleshooting\n\n\n| Issue | Resolution |\n| --------------------------------- | ------------------------------------------------------------ |\n| Exit 4 / License error | `<LICENSE_PATH>` missing → run activation; exists but still errors → License expired, direct user to https://www.compdf.com/contact-sales?utm_source=clawhub&utm_medium=skillhub&utm_campaign=pdf_skill_pdf_editor&ref_platform_id=clawhub_skills |\n| File not found | Check path; wrap paths containing spaces in double quotes |\n| Page number out of range | First confirm the total page count of the PDF |\n| Standard format conversion failed | Check font embedding and whether the ICC file matches the target standard |\n| Optimize/compare/watermark failed | Confirm the input PDF can be opened and is not encrypted; check parameter format and output path permissions |\n\n---\n\n## Security & Privacy\n\n**All PDF processing is performed locally. No file content is uploaded.**\n\n\n| External Endpoint | Purpose | Data Sent | When | User Consent |\n| ----------------------------------------------------- | ---------------------- | ------------------ | -------------------------------------- | -------------------------------- |\n| `https://download.compdf.com/skills/...` | Download CLI binary | None (HTTP GET) | First use only, if CLI not present | User is informed before download |\n| `POST https://wms.compdf.com/api/license/skillsTrial` | SDK license activation | Email address only | First use only, if license not present | User provides email and confirms |\n\n- **Official Source**: Both endpoints are operated by [PDF Technologies, Inc.](https://www.compdf.com/?utm_source=clawhub&utm_medium=skillhub&utm_campaign=pdf_skill_pdf_editor&ref_platform_id=clawhub_skills) (a KDAN Company), the publisher of ComPDFKit SDK.\n- **No Telemetry**: The CLI does not collect usage statistics, crash reports, or any anonymous data.\n- **No Network Dependency**: After initial setup, all commands run fully offline without accessing any external services.\n- **License File**: The `license_key_windows.xml` / `license_key_mac.xml` generated after activation is stored only in the local `scripts/` directory.\n\n---\n\n## Copyright & License\n\nThis Skill is built on the **ComPDFKit SDK**. © 2014-2026 PDF Technologies, Inc., a KDAN Company. All Rights Reserved.\n\n- License file: `License.txt` | Terms of Service: https://www.compdf.com/terms-of-service/?utm_source=clawhub&utm_medium=skillhub&utm_campaign=pdf_skill_pdf_editor&ref_platform_id=clawhub_skills\n- Privacy Policy: https://www.compdf.com/privacy-policy/?utm_source=clawhub&utm_medium=skillhub&utm_campaign=pdf_skill_pdf_editor&ref_platform_id=clawhub_skills | Commercial Licensing: https://www.compdf.com/contact-sales/?utm_source=clawhub&utm_medium=skillhub&utm_campaign=pdf_skill_pdf_editor&ref_platform_id=clawhub_skills\n\nFile v1.2.0:_meta.json\n\n{\n \"ownerId\": \"kn75g40xmv3tgkb21e079d055n82v5h8\",\n \"slug\": \"pdf-editor-compdf\",\n \"version\": \"1.2.0\",\n \"publishedAt\": 1782272966701\n}\n\nFile v1.2.0:skill-card.md\n\n## Description:\n\nPDF Editor helps agents edit and organize PDFs with ComPDFKit page-management operations such as merge, split, extract, insert, reorder, rotate, delete, watermark, convert, optimize, and compare.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[compdf-youna](https://clawhub.ai/user/compdf-youna)\n\n### License/Terms of Use:\n\nProprietary ComPDFKit SDK License\n\n## Use Case:\n\nExternal users and developers use this skill to run local PDF cleanup, restructuring, conversion, watermarking, compression, and comparison tasks through platform-specific ComPDFKit CLI commands.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill downloads and runs a persistent native ComPDFKit CLI from mutable external URLs without hash or signature verification.\n\nMitigation: Install only when the publisher and download host are trusted, review the download URL before first use, and run the agent with access limited to the PDFs and output folders needed for the task.\n\nRisk: First-use license activation sends the user's email address to the ComPDFKit license service.\n\nMitigation: Ask for explicit user confirmation before activation and use an email address appropriate for trial licensing.\n\nRisk: PDF editing commands can overwrite or transform user documents when output paths or overwrite flags are misused.\n\nMitigation: Prefer working on copies, set explicit output paths, and use overwrite only when the requested replacement is intentional.\n\n## Reference(s):\n\n- [ClawHub PDF Editor skill page](https://clawhub.ai/compdf-youna/skills/pdf-editor-compdf)\n- [ComPDFKit homepage](https://www.compdf.com/?utm_source=clawhub&utm_medium=skillhub&utm_campaign=pdf_skill_pdf_editor&ref_platform_id=clawhub_skills)\n- [Windows CLI download](https://download.compdf.com/skills/winCLI/win.zip)\n- [macOS CLI download](https://download.compdf.com/skills/macCLI/mac.zip)\n\n## Skill Output:\n\n**Output Type(s):** [Shell commands, Files, Configuration instructions, Guidance]\n\n**Output Format:** [Markdown guidance with platform-specific shell commands and generated PDF files from the CLI]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Requires local PDF paths, curl, Windows or macOS, and one-time CLI download and license activation.]\n\n## Skill Version(s):\n\n1.2.0 (source: SKILL.md frontmatter and server release metadata)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nFile v1.2.0:License.txt\n\nComPDFKit SDK License Agreement\n=================================\n\nCopyright (c) 2014-2026 PDF Technologies, Inc., a KDAN Company.\nAll Rights Reserved.\n\nThis skill (\"compdf-cli\") integrates the ComPDFKit SDK for PDF processing.\nThe ComPDFKit SDK is the property of PDF Technologies, Inc. and is\nprotected by copyright law and international treaties.\n\nLICENSE TERMS\n-------------\nThe ComPDFKit SDK is licensed, not sold. You are granted a non-exclusive,\nnon-transferable, non-sublicensable, revocable license to use the SDK\nsolely for the purposes described in this skill's documentation.\n\nYou retain full copyright and ownership of any products or documents you\ncreate using this skill. PDF Technologies, Inc. retains all ownership\nrights to the ComPDFKit SDK itself.\n\nTRIAL LICENSE\n-------------\nThis skill includes a 30-day free trial license. After expiration, please\ncontact ComPDFKit sales to obtain a commercial license:\n\nhttps://www.compdf.com/contact-sales?utm_source=clawhub&utm_medium=skillhub&utm_campaign=pdf_skill_pdf_editor&ref_platform_id=clawhub_skills\n\nLEGAL REFERENCES\n----------------\nTerms of Service: https://www.compdf.com/terms-of-service/?utm_source=clawhub&utm_medium=skillhub&utm_campaign=pdf_skill_pdf_editor&ref_platform_id=clawhub_skills\n\nPrivacy Policy: https://www.compdf.com/privacy-policy/?utm_source=clawhub&utm_medium=skillhub&utm_campaign=pdf_skill_pdf_editor&ref_platform_id=clawhub_skills\n\nSecurity Policy: https://www.compdf.com/security\n\nAFFILIATED ENTITIES\n-------------------\nPDF Technologies, Inc. operates under KDAN Company, with regional entities:\n - KDAN Mobile Software Ltd.\n - KDAN Mobile Software America Inc.\n - KDAN Japan Ltd.\n - KDAN Singapore Pte Ltd.\n - PDF Technologies Ltd.\n\nFor more information, visit: https://www.compdf.com/?utm_source=clawhub&utm_medium=skillhub&utm_campaign=pdf_skill_pdf_editor&ref_platform_id=clawhub_skills\n\nArchive v1.1.0: 4 files, 8096 bytes\n\nFiles: License.txt (1481b), skill-card.md (2669b), SKILL.md (15185b), _meta.json (136b)\n\nFile v1.1.0:SKILL.md\n\n---\nname: pdf-editor-compdf\nversion: 1.1.0\ndescription: >\n 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.”\nlicense: Proprietary. ComPDFKit SDK license obtained via online activation API.\nhomepage: https://www.compdf.com\ncompatibility: \"[Windows] Requires Windows (x64/x86) and .NET Framework runtime | [Mac] Requires macOS (arm64/x86_64) with ComPDFKit.framework\"\nmetadata:\n clawdbot:\n emoji: \"📑\"\n os:\n - windows\n - macos\n requires:\n bins:\n - curl\n---\n\n# PDF Editor — PDF Document Processing CLI Tool\n\n## Platform Detection (Agent must execute automatically)\n\nBefore 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.**\n\n| Variable | [Windows] | [Mac] |\n|------|-----------|-------|\n| `<CLI>` | `{skill_root}/scripts/win/compdf_cli.exe` | `{skill_root}/scripts/mac/compdf_cli` |\n| `<LICENSE_PATH>` | `{skill_root}/scripts/win/license_key_windows.xml` | `{skill_root}/scripts/mac/license_key_mac.xml` |\n| `<LICENSE_API_BODY>` | `{\"email\":\"<email>\"}` | `{\"email\":\"<email>\"}` |\n| `<ICC_SRGB>` | `{skill_root}/scripts/win/PDFA/sRGB2014.icc` | `{skill_root}/scripts/mac/PDFA/sRGB2014.icc` |\n| `<ICC_FOGRA>` | `{skill_root}/scripts/win/PDFA/CoatedFOGRA39.icc` | `{skill_root}/scripts/mac/PDFA/CoatedFOGRA39.icc` |\n| Shell syntax | `cmd` + `REM` | `bash` + `#` |\n\n> `{skill_root}` = the absolute path of the directory containing this SKILL.md.\n\n## CLI Download & Installation (Required on first use)\n\nThe 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:\n\n1. Check whether `<CLI>` exists → skip if it does\n2. **Inform the user** that the CLI binary will be downloaded from `download.compdf.com` (official ComPDFKit CDN)\n3. Download the appropriate archive for the platform:\n - **[Windows]**: `https://download.compdf.com/skills/winCLI/win.zip`\n - **[Mac]**: `https://download.compdf.com/skills/macCLI/mac.zip`\n4. 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)\n5. **[Mac]** After extraction, run: `chmod +x {skill_root}/scripts/mac/compdf_cli`\n6. Verify: run `<CLI> --help` to confirm the binary is executable\n\n> Download is performed once on first use only; no re-download is needed on subsequent runs.\n\n## License Activation (Required on first use)\n\n1. Check whether `<LICENSE_PATH>` exists → skip if it does\n2. 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**)\n3. **After the user confirms**, send `POST https://wms.compdf.com/api/license/skillsTrial`, Body: `<LICENSE_API_BODY>`\n - `code=200`: write the `data.license` XML to `<LICENSE_PATH>`\n - `code=500`: prompt the user to retry with a different email address\n4. Run `<CLI> --help` to verify activation\n\n## Common Options\n\nThe following options apply to **all commands** (they are not repeated in individual command references):\n\n| Option | Description | Default |\n|------|------|--------|\n| `--output, -o <path>` | Output file path or directory | Directory of the input file |\n| `--name <filename>` | Output filename | `{original_filename}_{command_name}.pdf` |\n| `--overwrite` | Allow overwriting existing files | No |\n\n## Command Reference\n\n### split — Split PDF\n\n`<CLI> split <input.pdf> [options]`\n\n| Option | Description | Default |\n|------|------|--------|\n| `--mode <all\\|range>` | `all`=split into individual pages, `range`=split by range | `all` |\n| `--range <range>` | Page range, e.g. `\"1-3\"` (range mode only) | — |\n\nOutput naming: `all` → `{original_filename}_page_{page_number}.pdf`; `range` → `{original_filename}_pages_{start}-{end}.pdf`\n\n### merge — Merge PDFs\n\n`<CLI> merge <file1.pdf> <file2.pdf> [file3.pdf ...] [options]`\n\n> Encrypted PDFs are skipped automatically; if fewer than 2 unencrypted files remain, the command fails.\n\n### extract — Extract Pages\n\n`<CLI> extract <input.pdf> --range <range> [options]`\n\n| Option | Description |\n|------|------|\n| `--range <range>` | **Required**, e.g. `\"2-5\"` or `\"3\"` |\n\n### rotate — Rotate Pages\n\n`<CLI> rotate <input.pdf> --pages <range> --angle <90|180|270> [options]`\n\n| Option | Description |\n|------|------|\n| `--pages <range>` | Required, page range |\n| `--angle <90\\|180\\|270>` | Required, rotation angle |\n\n### delete — Delete Pages\n\n`<CLI> delete <input.pdf> --pages <range> [options]`\n\n| Option | Description |\n|------|------|\n| `--pages <range>` | Required, page range to delete |\n\n### insert — Insert Pages/Images\n\n```\n<CLI> insert <target.pdf> --source <source.pdf> --pages <range> --at <position> [options]\n<CLI> insert <target.pdf> --image <imagePath> --at <position> --width <width> --height <height> [options]\n```\n\n| Option | Description |\n|------|------|\n| `--source <source.pdf>` | Source PDF (mutually exclusive with `--image`) |\n| `--image <imagePath>` | Image path (mutually exclusive with `--source`) |\n| `--pages <range>` | Page range from the source PDF; `--source` mode only |\n| `--at <position>` | Required, insert before page N (1-based) |\n| `--width <width>` / `--height <height>` | Image page dimensions; `--image` mode only (A4: 595×842) |\n\n### convert — Standard Format Conversion\n\n`<CLI> convert <input.pdf> --standard <format> [options]`\n\n| Option | Description | Default |\n|------|------|--------|\n| `--standard` | **Required**: `pdfa-1a` `pdfa-1b` `pdfa-2a` `pdfa-2b` `pdfa-2u` `pdfx-4` `pdfe-1` `pdfua-1` | — |\n| `--icc <path>` | ICC profile file | `<ICC_SRGB>` or `<ICC_FOGRA>` |\n| `--title <title>` | PDF/UA title (`pdfua-1` only) | Input filename |\n| `--language <language>` | PDF/UA language (`pdfua-1` only) | Win: `en-US` / Mac: `en` |\n\n`--language` supported values: Win `en-US`/`zh-CN`/`ja-JP`/`ko-KR`/`fr-FR`/`de-DE` | Mac `en`/`zh`/`ja`/`ko`\n\n**Examples**:\n```\n<CLI> convert \"report.pdf\" --standard pdfa-1a --overwrite\n<CLI> convert \"report.pdf\" --standard pdfua-1 --title \"My Document\" --language zh-CN --overwrite\n```\n\n### optimize — Document Optimization & Compression\n\n`<CLI> optimize <input.pdf> [options]`\n\n| Option | Description | Default |\n|------|------|--------|\n| `--compress-images` | Enable image compression | No |\n| `--image-quality <0-100>` | Image quality | `50` |\n| `--target-ppi <integer>` | Target image PPI | `150` |\n| `--upper-ppi <integer>` | Compression upper-limit PPI | Win `300` / Mac `225` |\n| `--image-alg <algorithm>` | `jpeg`/`jpeg2000`/`jbig2`/`ccitt3`/`ccitt4` | `jpeg2000` |\n| `--fast-web-view` | Fast Web View optimization | No |\n| `--optimize-page-content` | Page content optimization | No |\n| `--remove-annotations` | Remove annotations | No |\n| `--remove-bookmarks` | Remove bookmarks | No |\n| `--remove-form` | Remove forms | No |\n| `--remove-metadata` | Remove metadata | No |\n| `--remove-doc-info` | Remove document info | No |\n| `--incremental` | Incremental save mode | No |\n\nDefault behavior: removes unused/empty objects and enables Flate compression. Image compression is only enabled when `--compress-images` or image-related parameters are explicitly passed.\n\n**Examples**:\n```\n<CLI> optimize \"report.pdf\" --overwrite\n<CLI> optimize \"report.pdf\" --compress-images --image-quality 55 --target-ppi 144 --overwrite\n```\n\n### compare — Overlay Document Comparison\n\n`<CLI> compare <old.pdf> <new.pdf> [options]`\n\n| Option | Description | Default |\n|------|------|--------|\n| `--old-pages` / `--new-pages` | Page range | All pages |\n| `--old-color` / `--new-color` | Stroke color `R,G,B` | `255,0,0` / `0,0,255` |\n| `--old-stroke-alpha` / `--new-stroke-alpha` | Stroke opacity 0-1 | `0.8` |\n| `--old-fill-alpha` / `--new-fill-alpha` | Fill opacity 0-1 | `0.2` |\n| `--no-fill` | Hide fill | No |\n| `--blend-mode` | `normal`/`multiply`/`screen`/`overlay`/`darken`/`lighten`/`difference` | `overlay` |\n\n### watermark-text — Add Text Watermark\n\n`<CLI> watermark-text <input.pdf> --text <content> [options]`\n\n### watermark-image — Add Image Watermark\n\n`<CLI> watermark-image <input.pdf> --image <image_path> [options]`\n\n### Shared Watermark Options\n\n| Option | Description | [Win] Default | [Mac] Default |\n|------|------|-----------|-----------|\n| `--text <content>` | Watermark text (watermark-text only) | — | — |\n| `--image <path>` | Image path (watermark-image only) | — | — |\n| `--pages <range>` | Page range to apply | All | All |\n| `--font <font>` | Font (text only) | `Helvetica` | `Helvetica` |\n| `--font-size` | Font size (text only) | `24` | `48.0` |\n| `--color <R,G,B>` | Text color (text only) | `192,192,192` | `0,0,0` |\n| `--opacity` | Opacity | `120` (0-255) | `0.5` (0-1) |\n| `--rotation` | Rotation angle | `45` | `0.0` |\n| `--scale` | Scale factor | `1.0` | `1.0` |\n| `--h-align` / `--v-align` | Alignment `left\\|center\\|right` / `top\\|center\\|bottom` | `center` | `center` |\n| `--x-offset` / `--y-offset` | Offset | `0` | `0` |\n| `--h-spacing` / `--v-spacing` | Spacing | `80` | `0.0` |\n| `--front` / `--back` | Foreground/background | Foreground | Foreground |\n| `--full-screen` / `--single` | Tiled/single | Tiled | **Must be passed explicitly** |\n\n> **⚠️ Mac**: `--full-screen` is not enabled by default; tiled watermarks must be passed explicitly.\n\n**Examples** — [Windows]:\n```cmd\n<CLI> watermark-text \"report.pdf\" --text \"CONFIDENTIAL\" --overwrite\n<CLI> watermark-image \"report.pdf\" --image \"logo.png\" --scale 0.5 --opacity 100 --overwrite\n```\n**Examples** — [Mac]:\n```bash\n<CLI> watermark-text \"report.pdf\" --text \"CONFIDENTIAL\" --full-screen --overwrite\n<CLI> watermark-image \"report.pdf\" --image \"logo.png\" --scale 0.5 --opacity 0.3 --full-screen --overwrite\n```\n\n### watermark-delete — Remove All Watermarks\n\n`<CLI> watermark-delete <input.pdf> [options]`\n\n> [Win] `DeleteWatermarks()` removes all watermarks; [Mac] iterates and removes one by one. Selective removal is not supported.\n\n## Exit Codes\n\n| Code | Meaning | Action |\n|----|------|------|\n| `0` | Success | — |\n| `1` | Parameter error | Check required parameters |\n| `2` | File not found | Check path; wrap paths with spaces in double quotes |\n| `3` | Runtime error | PDF processing failed or output directory is not writable |\n| `4` | License failure | Missing → run activation; Expired → direct user to [contact sales](https://www.compdf.com/contact-sales) |\n\n## Usage Patterns (Agent quick reference)\n\n| User says | Command |\n|--------|------|\n| \"Split into single pages\" | `<CLI> split \"input.pdf\" --mode all --overwrite` |\n| \"Merge PDFs\" | `<CLI> merge \"a.pdf\" \"b.pdf\" --output \"merged.pdf\" --overwrite` |\n| \"Extract pages X to Y\" | `<CLI> extract \"input.pdf\" --range X-Y --output \"out.pdf\" --overwrite` |\n| \"Convert to PDF/A\" | `<CLI> convert \"input.pdf\" --standard pdfa-1a --overwrite` |\n| \"Compress PDF\" | `<CLI> optimize \"input.pdf\" --compress-images --image-quality 50 --overwrite` |\n| \"Compare two PDFs\" | `<CLI> compare \"old.pdf\" \"new.pdf\" --overwrite` |\n| \"Add text watermark\" | `<CLI> watermark-text \"input.pdf\" --text \"CONFIDENTIAL\" --overwrite` |\n| \"Add image watermark\" | `<CLI> watermark-image \"input.pdf\" --image \"logo.png\" --overwrite` |\n| \"Remove watermark\" | `<CLI> watermark-delete \"input.pdf\" --overwrite` |\n| \"Rotate pages\" | `<CLI> rotate \"input.pdf\" --pages X-Y --angle 90 --overwrite` |\n| \"Delete page X\" | `<CLI> delete \"input.pdf\" --pages X --overwrite` |\n| \"Insert pages\" | `<CLI> insert \"target.pdf\" --source \"src.pdf\" --pages X --at N --overwrite` |\n| \"Insert image\" | `<CLI> insert \"target.pdf\" --image \"img.png\" --at N --width 595 --height 842 --overwrite` |\n\n> ⚠️ Mac watermark commands require `--full-screen` to be passed explicitly (when tiling is desired).\n\n## Limitations\n\n1. Page ranges only support `\"N\"` or `\"N-M\"`; comma-separated values are not supported\n2. Except for `merge` (which skips encrypted files automatically), encrypted PDFs will cause an error and exit\n3. Wildcards, output path equal to input path, and multi-threaded parallel execution are not supported\n4. Results of standard format conversion and optimization depend on the content of the input PDF\n5. `watermark-delete` removes all watermarks; selective removal is not supported\n6. `compare` performs visual overlay comparison and does not output a structured diff list\n\n## Troubleshooting\n\n| Issue | Resolution |\n|------|------|\n| Exit 4 / License error | `<LICENSE_PATH>` missing → run activation; exists but still errors → License expired, direct user to https://www.compdf.com/contact-sales |\n| File not found | Check path; wrap paths containing spaces in double quotes |\n| Page number out of range | First confirm the total page count of the PDF |\n| Standard format conversion failed | Check font embedding and whether the ICC file matches the target standard |\n| Optimize/compare/watermark failed | Confirm the input PDF can be opened and is not encrypted; check parameter format and output path permissions |\n\n---\n\n## Security & Privacy\n\n**All PDF processing is performed locally. No file content is uploaded.**\n\n| External Endpoint | Purpose | Data Sent | When | User Consent |\n|----------|------|----------|------|------|\n| `https://download.compdf.com/skills/...` | Download CLI binary | None (HTTP GET) | First use only, if CLI not present | User is informed before download |\n| `POST https://wms.compdf.com/api/license/skillsTrial` | SDK license activation | Email address only | First use only, if license not present | User provides email and confirms |\n\n- **Official Source**: Both endpoints are operated by [PDF Technologies, Inc.](https://www.compdf.com) (a KDAN Company), the publisher of ComPDFKit SDK.\n- **No Telemetry**: The CLI does not collect usage statistics, crash reports, or any anonymous data.\n- **No Network Dependency**: After initial setup, all commands run fully offline without accessing any external services.\n- **License File**: The `license_key_windows.xml` / `license_key_mac.xml` generated after activation is stored only in the local `scripts/` directory.\n\n---\n\n## Copyright & License\n\nThis Skill is built on the **ComPDFKit SDK**. © 2014-2026 PDF Technologies, Inc., a KDAN Company. All Rights Reserved.\n\n- License file: `License.txt` | Terms of Service: https://www.compdf.com/terms-of-service\n- Privacy Policy: https://www.compdf.com/privacy-policy | Commercial Licensing: https://www.compdf.com/contact-sales\n\nFile v1.1.0:_meta.json\n\n{\n \"ownerId\": \"kn75g40xmv3tgkb21e079d055n82v5h8\",\n \"slug\": \"pdf-editor-compdf\",\n \"version\": \"1.1.0\",\n \"publishedAt\": 1777462208047\n}\n\nFile v1.1.0:skill-card.md\n\n## Description: <br>\nPDF 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. <br>\n\nThis skill is ready for commercial/non-commercial use. <br>\n\n## Publisher: <br>\n[compdf-youna](https://clawhub.ai/user/compdf-youna) <br>\n\n### License/Terms of Use: <br>\nMIT-0; ComPDFKit SDK License Agreement <br>\n\n\n## Use Case: <br>\nExternal users and document-processing developers use this skill to run ComPDF PDF page-management workflows, including merging, splitting, extracting, rotating, deleting, inserting, converting, optimizing, comparing, and watermarking PDFs. <br>\n\n### Deployment Geography for Use: <br>\nGlobal <br>\n\n## Known Risks and Mitigations: <br>\nRisk: The skill downloads and executes an external ComPDF binary at first use without a checksum or signature check in the reviewed package. <br>\nMitigation: Install only when the publisher and download source are trusted, and verify the downloaded archive independently before running it. <br>\nRisk: Trial activation sends an email address to the ComPDF license activation service. <br>\nMitigation: Use an email address appropriate for vendor activation and obtain explicit user confirmation before activation. <br>\nRisk: Local PDF processing may involve sensitive documents. <br>\nMitigation: Avoid highly sensitive PDFs unless the user trusts the vendor binary and the local runtime environment. <br>\n\n\n## Reference(s): <br>\n- [ClawHub skill page](https://clawhub.ai/compdf-youna/pdf-editor-compdf) <br>\n- [ComPDF homepage](https://www.compdf.com) <br>\n- [Windows CLI download](https://download.compdf.com/skills/winCLI/win.zip) <br>\n- [Mac CLI download](https://download.compdf.com/skills/macCLI/mac.zip) <br>\n- [License activation API](https://wms.compdf.com/api/license/skillsTrial) <br>\n- [ComPDF security policy](https://www.compdf.com/security) <br>\n\n\n## Skill Output: <br>\n**Output Type(s):** [text, markdown, shell commands, configuration, guidance] <br>\n**Output Format:** [Markdown guidance with platform-specific shell commands and file paths] <br>\n**Output Parameters:** [1D] <br>\n**Other Properties Related to Output:** [Commands may create or modify local PDF files and local license files.] <br>\n\n## Skill Version(s): <br>\n1.1.0 (source: frontmatter and server release evidence) <br>\n\n## Ethical Considerations: <br>\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment. <br>\n\nFile v1.1.0:License.txt\n\nComPDFKit SDK License Agreement\n=================================\n\nCopyright (c) 2014-2026 PDF Technologies, Inc., a KDAN Company.\nAll Rights Reserved.\n\nThis skill (\"compdf-cli\") integrates the ComPDFKit SDK for PDF processing.\nThe ComPDFKit SDK is the property of PDF Technologies, Inc. and is\nprotected by copyright law and international treaties.\n\nLICENSE TERMS\n-------------\nThe ComPDFKit SDK is licensed, not sold. You are granted a non-exclusive,\nnon-transferable, non-sublicensable, revocable license to use the SDK\nsolely for the purposes described in this skill's documentation.\n\nYou retain full copyright and ownership of any products or documents you\ncreate using this skill. PDF Technologies, Inc. retains all ownership\nrights to the ComPDFKit SDK itself.\n\nTRIAL LICENSE\n-------------\nThis skill includes a 30-day free trial license. After expiration, please\ncontact ComPDFKit sales to obtain a commercial license:\n\n https://www.compdf.com/contact-sales\n\nLEGAL REFERENCES\n----------------\nTerms of Service: https://www.compdf.com/terms-of-service\nPrivacy Policy: https://www.compdf.com/privacy-policy\nSecurity Policy: https://www.compdf.com/security\n\nAFFILIATED ENTITIES\n-------------------\nPDF Technologies, Inc. operates under KDAN Company, with regional entities:\n - KDAN Mobile Software Ltd.\n - KDAN Mobile Software America Inc.\n - KDAN Japan Ltd.\n - KDAN Singapore Pte Ltd.\n - PDF Technologies Ltd.\n\nFor more information, visit: https://www.compdf.com\n\nArchive v1.0.1: 3 files, 6680 bytes\n\nFiles: License.txt (1481b), SKILL.md (15064b), _meta.json (136b)\n\nFile v1.0.1:SKILL.md\n\n---\nname: pdf-editor-compdf\nversion: 1.0.1\ndescription: >\n Tool to edit and process PDF files using the compdf_cli command-line utility. Supports advanced page manipulation (split, merge, extract, insert, rotate, delete), document comparison, file compression, format conversion, and comprehensive watermark management (add/remove). Use when reorganizing PDF structures, optimizing file sizes, editing watermarks, or comparing and converting documents for LLM processing or text analysis.\nlicense: Proprietary. ComPDFKit SDK license obtained via online activation API.\nhomepage: https://www.compdf.com\ncompatibility: \"[Windows] Requires Windows (x64/x86) and .NET Framework runtime | [Mac] Requires macOS (arm64/x86_64) with ComPDFKit.framework\"\nmetadata:\n clawdbot:\n emoji: \"📑\"\n os:\n - windows\n - macos\n requires:\n bins:\n - curl\n---\n\n# PDF Editor — PDF Document Processing CLI Tool\n\n## Platform Detection (Agent must execute automatically)\n\nBefore 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.**\n\n| Variable | [Windows] | [Mac] |\n|------|-----------|-------|\n| `<CLI>` | `{skill_root}/scripts/win/compdf_cli.exe` | `{skill_root}/scripts/mac/compdf_cli` |\n| `<LICENSE_PATH>` | `{skill_root}/scripts/win/license_key_windows.xml` | `{skill_root}/scripts/mac/license_key_mac.xml` |\n| `<LICENSE_API_BODY>` | `{\"email\":\"<email>\"}` | `{\"email\":\"<email>\"}` |\n| `<ICC_SRGB>` | `{skill_root}/scripts/win/PDFA/sRGB2014.icc` | `{skill_root}/scripts/mac/PDFA/sRGB2014.icc` |\n| `<ICC_FOGRA>` | `{skill_root}/scripts/win/PDFA/CoatedFOGRA39.icc` | `{skill_root}/scripts/mac/PDFA/CoatedFOGRA39.icc` |\n| Shell syntax | `cmd` + `REM` | `bash` + `#` |\n\n> `{skill_root}` = the absolute path of the directory containing this SKILL.md.\n\n## CLI Download & Installation (Required on first use)\n\nThe 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:\n\n1. Check whether `<CLI>` exists → skip if it does\n2. **Inform the user** that the CLI binary will be downloaded from `download.compdf.com` (official ComPDFKit CDN)\n3. Download the appropriate archive for the platform:\n - **[Windows]**: `https://download.compdf.com/skills/winCLI/win.zip`\n - **[Mac]**: `https://download.compdf.com/skills/macCLI/mac.zip`\n4. 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)\n5. **[Mac]** After extraction, run: `chmod +x {skill_root}/scripts/mac/compdf_cli`\n6. Verify: run `<CLI> --help` to confirm the binary is executable\n\n> Download is performed once on first use only; no re-download is needed on subsequent runs.\n\n## License Activation (Required on first use)\n\n1. Check whether `<LICENSE_PATH>` exists → skip if it does\n2. 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**)\n3. **After the user confirms**, send `POST https://wms.compdf.com/api/license/skillsTrial`, Body: `<LICENSE_API_BODY>`\n - `code=200`: write the `data.license` XML to `<LICENSE_PATH>`\n - `code=500`: prompt the user to retry with a different email address\n4. Run `<CLI> --help` to verify activation\n\n## Common Options\n\nThe following options apply to **all commands** (they are not repeated in individual command references):\n\n| Option | Description | Default |\n|------|------|--------|\n| `--output, -o <path>` | Output file path or directory | Directory of the input file |\n| `--name <filename>` | Output filename | `{original_filename}_{command_name}.pdf` |\n| `--overwrite` | Allow overwriting existing files | No |\n\n## Command Reference\n\n### split — Split PDF\n\n`<CLI> split <input.pdf> [options]`\n\n| Option | Description | Default |\n|------|------|--------|\n| `--mode <all\\|range>` | `all`=split into individual pages, `range`=split by range | `all` |\n| `--range <range>` | Page range, e.g. `\"1-3\"` (range mode only) | — |\n\nOutput naming: `all` → `{original_filename}_page_{page_number}.pdf`; `range` → `{original_filename}_pages_{start}-{end}.pdf`\n\n### merge — Merge PDFs\n\n`<CLI> merge <file1.pdf> <file2.pdf> [file3.pdf ...] [options]`\n\n> Encrypted PDFs are skipped automatically; if fewer than 2 unencrypted files remain, the command fails.\n\n### extract — Extract Pages\n\n`<CLI> extract <input.pdf> --range <range> [options]`\n\n| Option | Description |\n|------|------|\n| `--range <range>` | **Required**, e.g. `\"2-5\"` or `\"3\"` |\n\n### rotate — Rotate Pages\n\n`<CLI> rotate <input.pdf> --pages <range> --angle <90|180|270> [options]`\n\n| Option | Description |\n|------|------|\n| `--pages <range>` | Required, page range |\n| `--angle <90\\|180\\|270>` | Required, rotation angle |\n\n### delete — Delete Pages\n\n`<CLI> delete <input.pdf> --pages <range> [options]`\n\n| Option | Description |\n|------|------|\n| `--pages <range>` | Required, page range to delete |\n\n### insert — Insert Pages/Images\n\n```\n<CLI> insert <target.pdf> --source <source.pdf> --pages <range> --at <position> [options]\n<CLI> insert <target.pdf> --image <imagePath> --at <position> --width <width> --height <height> [options]\n```\n\n| Option | Description |\n|------|------|\n| `--source <source.pdf>` | Source PDF (mutually exclusive with `--image`) |\n| `--image <imagePath>` | Image path (mutually exclusive with `--source`) |\n| `--pages <range>` | Page range from the source PDF; `--source` mode only |\n| `--at <position>` | Required, insert before page N (1-based) |\n| `--width <width>` / `--height <height>` | Image page dimensions; `--image` mode only (A4: 595×842) |\n\n### convert — Standard Format Conversion\n\n`<CLI> convert <input.pdf> --standard <format> [options]`\n\n| Option | Description | Default |\n|------|------|--------|\n| `--standard` | **Required**: `pdfa-1a` `pdfa-1b` `pdfa-2a` `pdfa-2b` `pdfa-2u` `pdfx-4` `pdfe-1` `pdfua-1` | — |\n| `--icc <path>` | ICC profile file | `<ICC_SRGB>` or `<ICC_FOGRA>` |\n| `--title <title>` | PDF/UA title (`pdfua-1` only) | Input filename |\n| `--language <language>` | PDF/UA language (`pdfua-1` only) | Win: `en-US` / Mac: `en` |\n\n`--language` supported values: Win `en-US`/`zh-CN`/`ja-JP`/`ko-KR`/`fr-FR`/`de-DE` | Mac `en`/`zh`/`ja`/`ko`\n\n**Examples**:\n```\n<CLI> convert \"report.pdf\" --standard pdfa-1a --overwrite\n<CLI> convert \"report.pdf\" --standard pdfua-1 --title \"My Document\" --language zh-CN --overwrite\n```\n\n### optimize — Document Optimization & Compression\n\n`<CLI> optimize <input.pdf> [options]`\n\n| Option | Description | Default |\n|------|------|--------|\n| `--compress-images` | Enable image compression | No |\n| `--image-quality <0-100>` | Image quality | `50` |\n| `--target-ppi <integer>` | Target image PPI | `150` |\n| `--upper-ppi <integer>` | Compression upper-limit PPI | Win `300` / Mac `225` |\n| `--image-alg <algorithm>` | `jpeg`/`jpeg2000`/`jbig2`/`ccitt3`/`ccitt4` | `jpeg2000` |\n| `--fast-web-view` | Fast Web View optimization | No |\n| `--optimize-page-content` | Page content optimization | No |\n| `--remove-annotations` | Remove annotations | No |\n| `--remove-bookmarks` | Remove bookmarks | No |\n| `--remove-form` | Remove forms | No |\n| `--remove-metadata` | Remove metadata | No |\n| `--remove-doc-info` | Remove document info | No |\n| `--incremental` | Incremental save mode | No |\n\nDefault behavior: removes unused/empty objects and enables Flate compression. Image compression is only enabled when `--compress-images` or image-related parameters are explicitly passed.\n\n**Examples**:\n```\n<CLI> optimize \"report.pdf\" --overwrite\n<CLI> optimize \"report.pdf\" --compress-images --image-quality 55 --target-ppi 144 --overwrite\n```\n\n### compare — Overlay Document Comparison\n\n`<CLI> compare <old.pdf> <new.pdf> [options]`\n\n| Option | Description | Default |\n|------|------|--------|\n| `--old-pages` / `--new-pages` | Page range | All pages |\n| `--old-color` / `--new-color` | Stroke color `R,G,B` | `255,0,0` / `0,0,255` |\n| `--old-stroke-alpha` / `--new-stroke-alpha` | Stroke opacity 0-1 | `0.8` |\n| `--old-fill-alpha` / `--new-fill-alpha` | Fill opacity 0-1 | `0.2` |\n| `--no-fill` | Hide fill | No |\n| `--blend-mode` | `normal`/`multiply`/`screen`/`overlay`/`darken`/`lighten`/`difference` | `overlay` |\n\n### watermark-text — Add Text Watermark\n\n`<CLI> watermark-text <input.pdf> --text <content> [options]`\n\n### watermark-image — Add Image Watermark\n\n`<CLI> watermark-image <input.pdf> --image <image_path> [options]`\n\n### Shared Watermark Options\n\n| Option | Description | [Win] Default | [Mac] Default |\n|------|------|-----------|-----------|\n| `--text <content>` | Watermark text (watermark-text only) | — | — |\n| `--image <path>` | Image path (watermark-image only) | — | — |\n| `--pages <range>` | Page range to apply | All | All |\n| `--font <font>` | Font (text only) | `Helvetica` | `Helvetica` |\n| `--font-size` | Font size (text only) | `24` | `48.0` |\n| `--color <R,G,B>` | Text color (text only) | `192,192,192` | `0,0,0` |\n| `--opacity` | Opacity | `120` (0-255) | `0.5` (0-1) |\n| `--rotation` | Rotation angle | `45` | `0.0` |\n| `--scale` | Scale factor | `1.0` | `1.0` |\n| `--h-align` / `--v-align` | Alignment `left\\|center\\|right` / `top\\|center\\|bottom` | `center` | `center` |\n| `--x-offset` / `--y-offset` | Offset | `0` | `0` |\n| `--h-spacing` / `--v-spacing` | Spacing | `80` | `0.0` |\n| `--front` / `--back` | Foreground/background | Foreground | Foreground |\n| `--full-screen` / `--single` | Tiled/single | Tiled | **Must be passed explicitly** |\n\n> **⚠️ Mac**: `--full-screen` is not enabled by default; tiled watermarks must be passed explicitly.\n\n**Examples** — [Windows]:\n```cmd\n<CLI> watermark-text \"report.pdf\" --text \"CONFIDENTIAL\" --overwrite\n<CLI> watermark-image \"report.pdf\" --image \"logo.png\" --scale 0.5 --opacity 100 --overwrite\n```\n**Examples** — [Mac]:\n```bash\n<CLI> watermark-text \"report.pdf\" --text \"CONFIDENTIAL\" --full-screen --overwrite\n<CLI> watermark-image \"report.pdf\" --image \"logo.png\" --scale 0.5 --opacity 0.3 --full-screen --overwrite\n```\n\n### watermark-delete — Remove All Watermarks\n\n`<CLI> watermark-delete <input.pdf> [options]`\n\n> [Win] `DeleteWatermarks()` removes all watermarks; [Mac] iterates and removes one by one. Selective removal is not supported.\n\n## Exit Codes\n\n| Code | Meaning | Action |\n|----|------|------|\n| `0` | Success | — |\n| `1` | Parameter error | Check required parameters |\n| `2` | File not found | Check path; wrap paths with spaces in double quotes |\n| `3` | Runtime error | PDF processing failed or output directory is not writable |\n| `4` | License failure | Missing → run activation; Expired → direct user to [contact sales](https://www.compdf.com/contact-sales) |\n\n## Usage Patterns (Agent quick reference)\n\n| User says | Command |\n|--------|------|\n| \"Split into single pages\" | `<CLI> split \"input.pdf\" --mode all --overwrite` |\n| \"Merge PDFs\" | `<CLI> merge \"a.pdf\" \"b.pdf\" --output \"merged.pdf\" --overwrite` |\n| \"Extract pages X to Y\" | `<CLI> extract \"input.pdf\" --range X-Y --output \"out.pdf\" --overwrite` |\n| \"Convert to PDF/A\" | `<CLI> convert \"input.pdf\" --standard pdfa-1a --overwrite` |\n| \"Compress PDF\" | `<CLI> optimize \"input.pdf\" --compress-images --image-quality 50 --overwrite` |\n| \"Compare two PDFs\" | `<CLI> compare \"old.pdf\" \"new.pdf\" --overwrite` |\n| \"Add text watermark\" | `<CLI> watermark-text \"input.pdf\" --text \"CONFIDENTIAL\" --overwrite` |\n| \"Add image watermark\" | `<CLI> watermark-image \"input.pdf\" --image \"logo.png\" --overwrite` |\n| \"Remove watermark\" | `<CLI> watermark-delete \"input.pdf\" --overwrite` |\n| \"Rotate pages\" | `<CLI> rotate \"input.pdf\" --pages X-Y --angle 90 --overwrite` |\n| \"Delete page X\" | `<CLI> delete \"input.pdf\" --pages X --overwrite` |\n| \"Insert pages\" | `<CLI> insert \"target.pdf\" --source \"src.pdf\" --pages X --at N --overwrite` |\n| \"Insert image\" | `<CLI> insert \"target.pdf\" --image \"img.png\" --at N --width 595 --height 842 --overwrite` |\n\n> ⚠️ Mac watermark commands require `--full-screen` to be passed explicitly (when tiling is desired).\n\n## Limitations\n\n1. Page ranges only support `\"N\"` or `\"N-M\"`; comma-separated values are not supported\n2. Except for `merge` (which skips encrypted files automatically), encrypted PDFs will cause an error and exit\n3. Wildcards, output path equal to input path, and multi-threaded parallel execution are not supported\n4. Results of standard format conversion and optimization depend on the content of the input PDF\n5. `watermark-delete` removes all watermarks; selective removal is not supported\n6. `compare` performs visual overlay comparison and does not output a structured diff list\n\n## Troubleshooting\n\n| Issue | Resolution |\n|------|------|\n| Exit 4 / License error | `<LICENSE_PATH>` missing → run activation; exists but still errors → License expired, direct user to https://www.compdf.com/contact-sales |\n| File not found | Check path; wrap paths containing spaces in double quotes |\n| Page number out of range | First confirm the total page count of the PDF |\n| Standard format conversion failed | Check font embedding and whether the ICC file matches the target standard |\n| Optimize/compare/watermark failed | Confirm the input PDF can be opened and is not encrypted; check parameter format and output path permissions |\n\n---\n\n## Security & Privacy\n\n**All PDF processing is performed locally. No file content is uploaded.**\n\n| External Endpoint | Purpose | Data Sent | When | User Consent |\n|----------|------|----------|------|------|\n| `https://download.compdf.com/skills/...` | Download CLI binary | None (HTTP GET) | First use only, if CLI not present | User is informed before download |\n| `POST https://wms.compdf.com/api/license/skillsTrial` | SDK license activation | Email address only | First use only, if license not present | User provides email and confirms |\n\n- **Official Source**: Both endpoints are operated by [PDF Technologies, Inc.](https://www.compdf.com) (a KDAN Company), the publisher of ComPDFKit SDK.\n- **No Telemetry**: The CLI does not collect usage statistics, crash reports, or any anonymous data.\n- **No Network Dependency**: After initial setup, all commands run fully offline without accessing any external services.\n- **License File**: The `license_key_windows.xml` / `license_key_mac.xml` generated after activation is stored only in the local `scripts/` directory.\n\n---\n\n## Copyright & License\n\nThis Skill is built on the **ComPDFKit SDK**. © 2014-2026 PDF Technologies, Inc., a KDAN Company. All Rights Reserved.\n\n- License file: `License.txt` | Terms of Service: https://www.compdf.com/terms-of-service\n- Privacy Policy: https://www.compdf.com/privacy-policy | Commercial Licensing: https://www.compdf.com/contact-sales\n\nFile v1.0.1:_meta.json\n\n{\n \"ownerId\": \"kn75g40xmv3tgkb21e079d055n82v5h8\",\n \"slug\": \"pdf-editor-compdf\",\n \"version\": \"1.0.1\",\n \"publishedAt\": 1774421467530\n}\n\nFile v1.0.1:License.txt\n\nComPDFKit SDK License Agreement\n=================================\n\nCopyright (c) 2014-2026 PDF Technologies, Inc., a KDAN Company.\nAll Rights Reserved.\n\nThis skill (\"compdf-cli\") integrates the ComPDFKit SDK for PDF processing.\nThe ComPDFKit SDK is the property of PDF Technologies, Inc. and is\nprotected by copyright law and international treaties.\n\nLICENSE TERMS\n-------------\nThe ComPDFKit SDK is licensed, not sold. You are granted a non-exclusive,\nnon-transferable, non-sublicensable, revocable license to use the SDK\nsolely for the purposes described in this skill's documentation.\n\nYou retain full copyright and ownership of any products or documents you\ncreate using this skill. PDF Technologies, Inc. retains all ownership\nrights to the ComPDFKit SDK itself.\n\nTRIAL LICENSE\n-------------\nThis skill includes a 30-day free trial license. After expiration, please\ncontact ComPDFKit sales to obtain a commercial license:\n\n https://www.compdf.com/contact-sales\n\nLEGAL REFERENCES\n----------------\nTerms of Service: https://www.compdf.com/terms-of-service\nPrivacy Policy: https://www.compdf.com/privacy-policy\nSecurity Policy: https://www.compdf.com/security\n\nAFFILIATED ENTITIES\n-------------------\nPDF Technologies, Inc. operates under KDAN Company, with regional entities:\n - KDAN Mobile Software Ltd.\n - KDAN Mobile Software America Inc.\n - KDAN Japan Ltd.\n - KDAN Singapore Pte Ltd.\n - PDF Technologies Ltd.\n\nFor more information, visit: https://www.compdf.com\n\nArchive v1.0.0: 3 files, 6387 bytes\n\nFiles: License.txt (1481b), SKILL.md (14309b), _meta.json (136b)\n\nFile v1.0.0:SKILL.md\n\n---\nname: pdf-editor-compdf\nversion: 1.0.0\ndescription: >\n Tool to edit and process PDF files using the compdf_cli command-line utility. Supports advanced page manipulation (split, merge, extract, insert, rotate, delete), document comparison, file compression, format conversion, and comprehensive watermark management (add/remove). Use when reorganizing PDF structures, optimizing file sizes, editing watermarks, or comparing and converting documents for LLM processing or text analysis.\nlicense: Proprietary. ComPDFKit SDK license obtained via online activation API.\nhomepage: https://www.compdf.com\ncompatibility: \"[Windows] Requires Windows (x64/x86) and .NET Framework runtime | [Mac] Requires macOS (arm64/x86_64) with ComPDFKit.framework\"\nmetadata:\n clawdbot:\n emoji: \"📑\"\n os:\n - windows\n - macos\n requires:\n bins:\n - curl\n---\n\n# PDF Editor — PDF Document Processing CLI Tool\n\n## Platform Detection (Agent must execute automatically)\n\nBefore 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.**\n\n| Variable | [Windows] | [Mac] |\n|------|-----------|-------|\n| `<CLI>` | `{skill_root}/scripts/win/compdf_cli.exe` | `{skill_root}/scripts/mac/compdf_cli` |\n| `<LICENSE_PATH>` | `{skill_root}/scripts/win/license_key_windows.xml` | `{skill_root}/scripts/mac/license_key_mac.xml` |\n| `<LICENSE_API_BODY>` | `{\"email\":\"<email>\"}` | `{\"email\":\"<email>\"}` |\n| `<ICC_SRGB>` | `{skill_root}/scripts/win/PDFA/sRGB2014.icc` | `{skill_root}/scripts/mac/PDFA/sRGB2014.icc` |\n| `<ICC_FOGRA>` | `{skill_root}/scripts/win/PDFA/CoatedFOGRA39.icc` | `{skill_root}/scripts/mac/PDFA/CoatedFOGRA39.icc` |\n| Shell syntax | `cmd` + `REM` | `bash` + `#` |\n\n> `{skill_root}` = the absolute path of the directory containing this SKILL.md.\n\n## CLI Download & Installation (Required on first use)\n\nThe CLI binary is not included in the Skill package. The Agent must automatically complete the following steps before the first execution:\n\n1. Check whether `<CLI>` exists → skip if it does\n2. Download the appropriate archive for the platform:\n - **[Windows]**: `https://download.compdf.com/skills/winCLI/win.zip`\n - **[Mac]**: `https://download.compdf.com/skills/macCLI/mac.zip`\n3. 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)\n4. **[Mac]** After extraction, run: `chmod +x {skill_root}/scripts/mac/compdf_cli`\n5. Verify: run `<CLI> --help` to confirm the binary is executable\n\n> Download is performed automatically only once on first use; no re-download is needed on subsequent runs.\n\n## License Activation (Required on first use)\n\n1. Check whether `<LICENSE_PATH>` exists → skip if it does\n2. Ask the user for their email address\n3. `POST https://wms.compdf.com/api/license/skillsTrial`, Body: `<LICENSE_API_BODY>`\n - `code=200`: write the `data.license` XML to `<LICENSE_PATH>`\n - `code=500`: prompt the user to retry with a different email address\n4. Run `<CLI> --help` to verify activation\n\n## Common Options\n\nThe following options apply to **all commands** (they are not repeated in individual command references):\n\n| Option | Description | Default |\n|------|------|--------|\n| `--output, -o <path>` | Output file path or directory | Directory of the input file |\n| `--name <filename>` | Output filename | `{original_filename}_{command_name}.pdf` |\n| `--overwrite` | Allow overwriting existing files | No |\n\n## Command Reference\n\n### split — Split PDF\n\n`<CLI> split <input.pdf> [options]`\n\n| Option | Description | Default |\n|------|------|--------|\n| `--mode <all\\|range>` | `all`=split into individual pages, `range`=split by range | `all` |\n| `--range <range>` | Page range, e.g. `\"1-3\"` (range mode only) | — |\n\nOutput naming: `all` → `{original_filename}_page_{page_number}.pdf`; `range` → `{original_filename}_pages_{start}-{end}.pdf`\n\n### merge — Merge PDFs\n\n`<CLI> merge <file1.pdf> <file2.pdf> [file3.pdf ...] [options]`\n\n> Encrypted PDFs are skipped automatically; if fewer than 2 unencrypted files remain, the command fails.\n\n### extract — Extract Pages\n\n`<CLI> extract <input.pdf> --range <range> [options]`\n\n| Option | Description |\n|------|------|\n| `--range <range>` | **Required**, e.g. `\"2-5\"` or `\"3\"` |\n\n### rotate — Rotate Pages\n\n`<CLI> rotate <input.pdf> --pages <range> --angle <90|180|270> [options]`\n\n| Option | Description |\n|------|------|\n| `--pages <range>` | Required, page range |\n| `--angle <90\\|180\\|270>` | Required, rotation angle |\n\n### delete — Delete Pages\n\n`<CLI> delete <input.pdf> --pages <range> [options]`\n\n| Option | Description |\n|------|------|\n| `--pages <range>` | Required, page range to delete |\n\n### insert — Insert Pages/Images\n\n```\n<CLI> insert <target.pdf> --source <source.pdf> --pages <range> --at <position> [options]\n<CLI> insert <target.pdf> --image <imagePath> --at <position> --width <width> --height <height> [options]\n```\n\n| Option | Description |\n|------|------|\n| `--source <source.pdf>` | Source PDF (mutually exclusive with `--image`) |\n| `--image <imagePath>` | Image path (mutually exclusive with `--source`) |\n| `--pages <range>` | Page range from the source PDF; `--source` mode only |\n| `--at <position>` | Required, insert before page N (1-based) |\n| `--width <width>` / `--height <height>` | Image page dimensions; `--image` mode only (A4: 595×842) |\n\n### convert — Standard Format Conversion\n\n`<CLI> convert <input.pdf> --standard <format> [options]`\n\n| Option | Description | Default |\n|------|------|--------|\n| `--standard` | **Required**: `pdfa-1a` `pdfa-1b` `pdfa-2a` `pdfa-2b` `pdfa-2u` `pdfx-4` `pdfe-1` `pdfua-1` | — |\n| `--icc <path>` | ICC profile file | `<ICC_SRGB>` or `<ICC_FOGRA>` |\n| `--title <title>` | PDF/UA title (`pdfua-1` only) | Input filename |\n| `--language <language>` | PDF/UA language (`pdfua-1` only) | Win: `en-US` / Mac: `en` |\n\n`--language` supported values: Win `en-US`/`zh-CN`/`ja-JP`/`ko-KR`/`fr-FR`/`de-DE` | Mac `en`/`zh`/`ja`/`ko`\n\n**Examples**:\n```\n<CLI> convert \"report.pdf\" --standard pdfa-1a --overwrite\n<CLI> convert \"report.pdf\" --standard pdfua-1 --title \"My Document\" --language zh-CN --overwrite\n```\n\n### optimize — Document Optimization & Compression\n\n`<CLI> optimize <input.pdf> [options]`\n\n| Option | Description | Default |\n|------|------|--------|\n| `--compress-images` | Enable image compression | No |\n| `--image-quality <0-100>` | Image quality | `50` |\n| `--target-ppi <integer>` | Target image PPI | `150` |\n| `--upper-ppi <integer>` | Compression upper-limit PPI | Win `300` / Mac `225` |\n| `--image-alg <algorithm>` | `jpeg`/`jpeg2000`/`jbig2`/`ccitt3`/`ccitt4` | `jpeg2000` |\n| `--fast-web-view` | Fast Web View optimization | No |\n| `--optimize-page-content` | Page content optimization | No |\n| `--remove-annotations` | Remove annotations | No |\n| `--remove-bookmarks` | Remove bookmarks | No |\n| `--remove-form` | Remove forms | No |\n| `--remove-metadata` | Remove metadata | No |\n| `--remove-doc-info` | Remove document info | No |\n| `--incremental` | Incremental save mode | No |\n\nDefault behavior: removes unused/empty objects and enables Flate compression. Image compression is only enabled when `--compress-images` or image-related parameters are explicitly passed.\n\n**Examples**:\n```\n<CLI> optimize \"report.pdf\" --overwrite\n<CLI> optimize \"report.pdf\" --compress-images --image-quality 55 --target-ppi 144 --overwrite\n```\n\n### compare — Overlay Document Comparison\n\n`<CLI> compare <old.pdf> <new.pdf> [options]`\n\n| Option | Description | Default |\n|------|------|--------|\n| `--old-pages` / `--new-pages` | Page range | All pages |\n| `--old-color` / `--new-color` | Stroke color `R,G,B` | `255,0,0` / `0,0,255` |\n| `--old-stroke-alpha` / `--new-stroke-alpha` | Stroke opacity 0-1 | `0.8` |\n| `--old-fill-alpha` / `--new-fill-alpha` | Fill opacity 0-1 | `0.2` |\n| `--no-fill` | Hide fill | No |\n| `--blend-mode` | `normal`/`multiply`/`screen`/`overlay`/`darken`/`lighten`/`difference` | `overlay` |\n\n### watermark-text — Add Text Watermark\n\n`<CLI> watermark-text <input.pdf> --text <content> [options]`\n\n### watermark-image — Add Image Watermark\n\n`<CLI> watermark-image <input.pdf> --image <image_path> [options]`\n\n### Shared Watermark Options\n\n| Option | Description | [Win] Default | [Mac] Default |\n|------|------|-----------|-----------|\n| `--text <content>` | Watermark text (watermark-text only) | — | — |\n| `--image <path>` | Image path (watermark-image only) | — | — |\n| `--pages <range>` | Page range to apply | All | All |\n| `--font <font>` | Font (text only) | `Helvetica` | `Helvetica` |\n| `--font-size` | Font size (text only) | `24` | `48.0` |\n| `--color <R,G,B>` | Text color (text only) | `192,192,192` | `0,0,0` |\n| `--opacity` | Opacity | `120` (0-255) | `0.5` (0-1) |\n| `--rotation` | Rotation angle | `45` | `0.0` |\n| `--scale` | Scale factor | `1.0` | `1.0` |\n| `--h-align` / `--v-align` | Alignment `left\\|center\\|right` / `top\\|center\\|bottom` | `center` | `center` |\n| `--x-offset` / `--y-offset` | Offset | `0` | `0` |\n| `--h-spacing` / `--v-spacing` | Spacing | `80` | `0.0` |\n| `--front` / `--back` | Foreground/background | Foreground | Foreground |\n| `--full-screen` / `--single` | Tiled/single | Tiled | **Must be passed explicitly** |\n\n> **⚠️ Mac**: `--full-screen` is not enabled by default; tiled watermarks must be passed explicitly.\n\n**Examples** — [Windows]:\n```cmd\n<CLI> watermark-text \"report.pdf\" --text \"CONFIDENTIAL\" --overwrite\n<CLI> watermark-image \"report.pdf\" --image \"logo.png\" --scale 0.5 --opacity 100 --overwrite\n```\n**Examples** — [Mac]:\n```bash\n<CLI> watermark-text \"report.pdf\" --text \"CONFIDENTIAL\" --full-screen --overwrite\n<CLI> watermark-image \"report.pdf\" --image \"logo.png\" --scale 0.5 --opacity 0.3 --full-screen --overwrite\n```\n\n### watermark-delete — Remove All Watermarks\n\n`<CLI> watermark-delete <input.pdf> [options]`\n\n> [Win] `DeleteWatermarks()` removes all watermarks; [Mac] iterates and removes one by one. Selective removal is not supported.\n\n## Exit Codes\n\n| Code | Meaning | Action |\n|----|------|------|\n| `0` | Success | — |\n| `1` | Parameter error | Check required parameters |\n| `2` | File not found | Check path; wrap paths with spaces in double quotes |\n| `3` | Runtime error | PDF processing failed or output directory is not writable |\n| `4` | License failure | Missing → run activation; Expired → direct user to [contact sales](https://www.compdf.com/contact-sales) |\n\n## Usage Patterns (Agent quick reference)\n\n| User says | Command |\n|--------|------|\n| \"Split into single pages\" | `<CLI> split \"input.pdf\" --mode all --overwrite` |\n| \"Merge PDFs\" | `<CLI> merge \"a.pdf\" \"b.pdf\" --output \"merged.pdf\" --overwrite` |\n| \"Extract pages X to Y\" | `<CLI> extract \"input.pdf\" --range X-Y --output \"out.pdf\" --overwrite` |\n| \"Convert to PDF/A\" | `<CLI> convert \"input.pdf\" --standard pdfa-1a --overwrite` |\n| \"Compress PDF\" | `<CLI> optimize \"input.pdf\" --compress-images --image-quality 50 --overwrite` |\n| \"Compare two PDFs\" | `<CLI> compare \"old.pdf\" \"new.pdf\" --overwrite` |\n| \"Add text watermark\" | `<CLI> watermark-text \"input.pdf\" --text \"CONFIDENTIAL\" --overwrite` |\n| \"Add image watermark\" | `<CLI> watermark-image \"input.pdf\" --image \"logo.png\" --overwrite` |\n| \"Remove watermark\" | `<CLI> watermark-delete \"input.pdf\" --overwrite` |\n| \"Rotate pages\" | `<CLI> rotate \"input.pdf\" --pages X-Y --angle 90 --overwrite` |\n| \"Delete page X\" | `<CLI> delete \"input.pdf\" --pages X --overwrite` |\n| \"Insert pages\" | `<CLI> insert \"target.pdf\" --source \"src.pdf\" --pages X --at N --overwrite` |\n| \"Insert image\" | `<CLI> insert \"target.pdf\" --image \"img.png\" --at N --width 595 --height 842 --overwrite` |\n\n> ⚠️ Mac watermark commands require `--full-screen` to be passed explicitly (when tiling is desired).\n\n## Limitations\n\n1. Page ranges only support `\"N\"` or `\"N-M\"`; comma-separated values are not supported\n2. Except for `merge` (which skips encrypted files automatically), encrypted PDFs will cause an error and exit\n3. Wildcards, output path equal to input path, and multi-threaded parallel execution are not supported\n4. Results of standard format conversion and optimization depend on the content of the input PDF\n5. `watermark-delete` removes all watermarks; selective removal is not supported\n6. `compare` performs visual overlay comparison and does not output a structured diff list\n\n## Troubleshooting\n\n| Issue | Resolution |\n|------|------|\n| Exit 4 / License error | `<LICENSE_PATH>` missing → run activation; exists but still errors → License expired, direct user to https://www.compdf.com/contact-sales |\n| File not found | Check path; wrap paths containing spaces in double quotes |\n| Page number out of range | First confirm the total page count of the PDF |\n| Standard format conversion failed | Check font embedding and whether the ICC file matches the target standard |\n| Optimize/compare/watermark failed | Confirm the input PDF can be opened and is not encrypted; check parameter format and output path permissions |\n\n---\n\n## Security & Privacy\n\n**All PDF processing is performed locally. No file content is uploaded.**\n\n| External Endpoint | Purpose | Data Sent | When |\n|----------|------|----------|------|\n| `POST https://wms.compdf.com/api/license/skillsTrial` | SDK license activation | Email address only | Called once during initial activation only |\n\n- **No Telemetry**: The CLI does not collect usage statistics, crash reports, or any anonymous data.\n- **No Network Dependency**: After activation, all commands run offline without accessing any external services.\n- **License File**: The `license_key_windows.xml` / `license_key_mac.xml` generated after activation is stored only in the local `scripts/` directory.\n\n---\n\n## Copyright & License\n\nThis Skill is built on the **ComPDFKit SDK**. © 2014-2026 PDF Technologies, Inc., a KDAN Company. All Rights Reserved.\n\n- License file: `License.txt` | Terms of Service: https://www.compdf.com/terms-of-service\n- Privacy Policy: https://www.compdf.com/privacy-policy | Commercial Licensing: https://www.compdf.com/contact-sales\n\nFile v1.0.0:_meta.json\n\n{\n \"ownerId\": \"kn75g40xmv3tgkb21e079d055n82v5h8\",\n \"slug\": \"pdf-editor-compdf\",\n \"version\": \"1.0.0\",\n \"publishedAt\": 1774419341099\n}\n\nFile v1.0.0:License.txt\n\nComPDFKit SDK License Agreement\n=================================\n\nCopyright (c) 2014-2026 PDF Technologies, Inc., a KDAN Company.\nAll Rights Reserved.\n\nThis skill (\"compdf-cli\") integrates the ComPDFKit SDK for PDF processing.\nThe ComPDFKit SDK is the property of PDF Technologies, Inc. and is\nprotected by copyright law and international treaties.\n\nLICENSE TERMS\n-------------\nThe ComPDFKit SDK is licensed, not sold. You are granted a non-exclusive,\nnon-transferable, non-sublicensable, revocable license to use the SDK\nsolely for the purposes described in this skill's documentation.\n\nYou retain full copyright and ownership of any products or documents you\ncreate using this skill. PDF Technologies, Inc. retains all ownership\nrights to the ComPDFKit SDK itself.\n\nTRIAL LICENSE\n-------------\nThis skill includes a 30-day free trial license. After expiration, please\ncontact ComPDFKit sales to obtain a commercial license:\n\n https://www.compdf.com/contact-sales\n\nLEGAL REFERENCES\n----------------\nTerms of Service: https://www.compdf.com/terms-of-service\nPrivacy Policy: https://www.compdf.com/privacy-policy\nSecurity Policy: https://www.compdf.com/security\n\nAFFILIATED ENTITIES\n-------------------\nPDF Technologies, Inc. operates under KDAN Company, with regional entities:\n - KDAN Mobile Software Ltd.\n - KDAN Mobile Software America Inc.\n - KDAN Japan Ltd.\n - KDAN Singapore Pte Ltd.\n - PDF Technologies Ltd.\n\nFor more information, visit: https://www.compdf.com","readmeExcerpt":"Skill: PDF Editor Owner: compdf-youna Summary: PDF Editor edits and organizes PDF pages with merge, insert, reorder, exchange, and crop operations, built on ComPDF page management capabilities for fast PD... Tags: latest:1.2.0 Version history: v1.2.0 | 2026-06-24T03:49:26.701Z | user Version 1.2.0 - Updated the skill homepage URL to include UTM parameters for improved referral tracking. - Removed the file: skill-card","codeSnippets":[],"executableExamples":[{"language":"text","snippet":"<CLI> insert <target.pdf> --source <source.pdf> --pages <range> --at <position> [options]\n<CLI> insert <target.pdf> --image <imagePath> --at <position> --width <width> --height <height> [options]"},{"language":"text","snippet":"<CLI> convert \"report.pdf\" --standard pdfa-1a --overwrite\n<CLI> convert \"report.pdf\" --standard pdfua-1 --title \"My Document\" --language zh-CN --overwrite"},{"language":"text","snippet":"<CLI> optimize \"report.pdf\" --overwrite\n<CLI> optimize \"report.pdf\" --compress-images --image-quality 55 --target-ppi 144 --overwrite"},{"language":"cmd","snippet":"<CLI> watermark-text \"report.pdf\" --text \"CONFIDENTIAL\" --overwrite\n<CLI> watermark-image \"report.pdf\" --image \"logo.png\" --scale 0.5 --opacity 100 --overwrite"},{"language":"bash","snippet":"<CLI> watermark-text \"report.pdf\" --text \"CONFIDENTIAL\" --full-screen --overwrite\n<CLI> watermark-image \"report.pdf\" --image \"logo.png\" --scale 0.5 --opacity 0.3 --full-screen --overwrite"},{"language":"text","snippet":"<CLI> insert <target.pdf> --source <source.pdf> --pages <range> --at <position> [options]\n<CLI> insert <target.pdf> --image <imagePath> --at <position> --width <width> --height <height> [options]"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: pdf-editor-compdf\nversion: 1.2.0\ndescription: >\n 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.”\nlicense: Proprietary. ComPDFKit SDK license obtained via online activation API.\nhomepage: https://www.compdf.com/?utm_source=clawhub&utm_medium=skillhub&utm_campaign=pdf_skill_pdf_editor&ref_platform_id=clawhub_skills\ncompatibility: \"[Windows] Requires Windows (x64/x86) and .NET Framework runtime | [Mac] Requires macOS (arm64/x86_64) with ComPDFKit.framework\"\nmetadata:\n clawdbot:\n emoji: \"📑\"\n os:\n - windows\n - macos\n requires:\n bins:\n - curl\n---\n# PDF Editor — PDF Document Processing CLI Tool\n\n## Platform Detection (Agent must execute automatically)\n\nBefore 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.**\n\n\n| Variable | [Windows] | [Mac] |\n| -------------------- | -------------------------------------------------- | ------------------------------------------------- |\n| `<CLI>` | `{skill_root}/scripts/win/compdf_cli.exe` | `{skill_root}/scripts/mac/compdf_cli` |\n| `<LICENSE_PATH>` | `{skill_root}/scripts/win/license_key_windows.xml` | `{skill_root}/scripts/mac/license_key_mac.xml` |\n| `<LICENSE_API_BODY>` | `{\"email\":\"<email>\"}` | `{\"email\":\"<email>\"}` |\n| `<ICC_SRGB>` | `{skill_root}/scripts/win/PDFA/sRGB2014.icc` | `{skill_root}/scripts/mac/PDFA/sRGB2014.icc` |\n| `<ICC_FOGRA>` | `{skill_root}/scripts/win/PDFA/CoatedFOGRA39.icc` | `{skill_root}/scripts/mac/PDFA/CoatedFOGRA39.icc` |\n| Shell syntax | `cmd` + `REM` | `bash` + `#` |\n\n> `{skill_root}` = the absolute path of the directory containing this SKILL.md.\n\n## CLI Download & Installation (Required on first use)\n\nThe 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:\n\n1. Check whether `<CLI>` exists → skip if it does\n2. **Inform the user** that the CLI binary will be downloaded from `download.compdf.com` (official ComPDFKit CDN)\n3. Download the appropriate archive for t"},{"path":"_meta.json","content":"{\n \"ownerId\": \"kn75g40xmv3tgkb21e079d055n82v5h8\",\n \"slug\": \"pdf-editor-compdf\",\n \"version\": \"1.2.0\",\n \"publishedAt\": 1782272966701\n}"},{"path":"skill-card.md","content":"## Description:\n\nPDF Editor helps agents edit and organize PDFs with ComPDFKit page-management operations such as merge, split, extract, insert, reorder, rotate, delete, watermark, convert, optimize, and compare.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[compdf-youna](https://clawhub.ai/user/compdf-youna)\n\n### License/Terms of Use:\n\nProprietary ComPDFKit SDK License\n\n## Use Case:\n\nExternal users and developers use this skill to run local PDF cleanup, restructuring, conversion, watermarking, compression, and comparison tasks through platform-specific ComPDFKit CLI commands.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill downloads and runs a persistent native ComPDFKit CLI from mutable external URLs without hash or signature verification.\n\nMitigation: Install only when the publisher and download host are trusted, review the download URL before first use, and run the agent with access limited to the PDFs and output folders needed for the task.\n\nRisk: First-use license activation sends the user's email address to the ComPDFKit license service.\n\nMitigation: Ask for explicit user confirmation before activation and use an email address appropriate for trial licensing.\n\nRisk: PDF editing commands can overwrite or transform user documents when output paths or overwrite flags are misused.\n\nMitigation: Prefer working on copies, set explicit output paths, and use overwrite only when the requested replacement is intentional.\n\n## Reference(s):\n\n- [ClawHub PDF Editor skill page](https://clawhub.ai/compdf-youna/skills/pdf-editor-compdf)\n- [ComPDFKit homepage](https://www.compdf.com/?utm_source=clawhub&utm_medium=skillhub&utm_campaign=pdf_skill_pdf_editor&ref_platform_id=clawhub_skills)\n- [Windows CLI download](https://download.compdf.com/skills/winCLI/win.zip)\n- [macOS CLI download](https://download.compdf.com/skills/macCLI/mac.zip)\n\n## Skill Output:\n\n**Output Type(s):** [Shell commands, Files, Configuration instructions, Guidance]\n\n**Output Format:** [Markdown guidance with platform-specific shell commands and generated PDF files from the CLI]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Requires local PDF paths, curl, Windows or macOS, and one-time CLI download and license activation.]\n\n## Skill Version(s):\n\n1.2.0 (source: SKILL.md frontmatter and server release metadata)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment."},{"path":"License.txt","content":"ComPDFKit SDK License Agreement\n=================================\n\nCopyright (c) 2014-2026 PDF Technologies, Inc., a KDAN Company.\nAll Rights Reserved.\n\nThis skill (\"compdf-cli\") integrates the ComPDFKit SDK for PDF processing.\nThe ComPDFKit SDK is the property of PDF Technologies, Inc. and is\nprotected by copyright law and international treaties.\n\nLICENSE TERMS\n-------------\nThe ComPDFKit SDK is licensed, not sold. You are granted a non-exclusive,\nnon-transferable, non-sublicensable, revocable license to use the SDK\nsolely for the purposes described in this skill's documentation.\n\nYou retain full copyright and ownership of any products or documents you\ncreate using this skill. PDF Technologies, Inc. retains all ownership\nrights to the ComPDFKit SDK itself.\n\nTRIAL LICENSE\n-------------\nThis skill includes a 30-day free trial license. After expiration, please\ncontact ComPDFKit sales to obtain a commercial license:\n\nhttps://www.compdf.com/contact-sales?utm_source=clawhub&utm_medium=skillhub&utm_campaign=pdf_skill_pdf_editor&ref_platform_id=clawhub_skills\n\nLEGAL REFERENCES\n----------------\nTerms of Service: https://www.compdf.com/terms-of-service/?utm_source=clawhub&utm_medium=skillhub&utm_campaign=pdf_skill_pdf_editor&ref_platform_id=clawhub_skills\n\nPrivacy Policy: https://www.compdf.com/privacy-policy/?utm_source=clawhub&utm_medium=skillhub&utm_campaign=pdf_skill_pdf_editor&ref_platform_id=clawhub_skills\n\nSecurity Policy: https://www.compdf.com/security\n\nAFFILIATED ENTITIES\n-------------------\nPDF Technologies, Inc. operates under KDAN Company, with regional entities:\n - KDAN Mobile Software Ltd.\n - KDAN Mobile Software America Inc.\n - KDAN Japan Ltd.\n - KDAN Singapore Pte Ltd.\n - PDF Technologies Ltd.\n\nFor more information, visit: https://www.compdf.com/?utm_source=clawhub&utm_medium=skillhub&utm_campaign=pdf_skill_pdf_editor&ref_platform_id=clawhub_skills"}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":null,"editorialQuality":{"score":100,"threshold":65,"status":"thin","wordCount":1539,"uniquenessScore":43,"reasons":["uniqueness-below-45"]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-10T04:16:55.527Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-10-10T04:16:55.527Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-10T08:44:17.855Z","emptyReason":null},"items":[{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-10-09T19:11:12.944Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/clawhub","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}