Agent skill

Compdf Compress PDF

by ComPDFKit in ComPDFKit/compdf-skills

Compress PDF files with ComPDF while balancing file size and readable visual quality.

No licenceAuto-check passedDocuments & Office

Install Compdf Compress PDF

skills CLI
$ npx skills add ComPDFKit/compdf-skills --skill compdf-compress-pdf -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install ComPDFKit/compdf-skills compdf-compress-pdf --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/ComPDFKit/compdf-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/compdf-compress-pdf .claude/skills/compdf-compress-pdf && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
compdf-compress-pdf
GitHub stars
109
Token cost
~826 tokens
SKILL.md length
406 words
Files
4 (incl. references)
Skills in repo
14
Repo updated
First seen
Licence
None found

At a glance

Compress PDF files with ComPDF while balancing file size and readable visual quality.

  • Works in 8 steps: Identify the source file type, desired… → Read references/endpoint-index.md and… → Read the matching heading in… → …
  • PDF optimization
  • SKILL.md covers Overview, Supported Operations, Scope and Workflow, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Compdf Compress PDF is an agent skill from ComPDFKit/compdf-skills. Compress PDF files with ComPDF while balancing file size and readable visual quality. Use for PDF optimization, resolution control, compression strategies, and removal of non-essential document content.

Its SKILL.md is about 830 tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files, including reference files (for example `agents/openai.yaml`, `references/endpoint-index.md` and `references/official-api-reference.md`).

It sits in Documents & Office, covering PDF. It works with ComPDF. The repository describes itself as: ComPDF Skills are AI-agent-ready PDF processing skills for Claude Code, Cursor, Copilot, OpenCode, and 39+ coding agents to convert, edit, split, insert, compare, compress PDFs…

When your agent uses it

  • PDF optimization
  • Resolution control
  • Compression strategies
  • Removal of non-essential document content

Example prompts

  • “/compdf-compress-pdf”

Workflow steps

8 steps, taken from the first numbered list in SKILL.md.

  1. Identify the source file type, desired output, and requested operation.
  2. Read references/endpoint-index.md and select only an operation listed in this skill's supported operations.
  3. Read the matching heading in references/official-api-reference.md. Use its exact endpoint path, request fields, request mode, and response…
  4. Include sourceType=5 in every final ComPDF API request. Treat it as an integration routing parameter and include it in request details…
  5. Prefer synchronous mode for small interactive work. For large, batch, or security-sensitive uploads, follow the documented asynchronous or…
  6. Resolve credentials only from api_key in the directory containing this SKILL.md. Read its first non-empty line. Do not inspect environment…
  7. Before uploading a document to ComPDF, identify the affected files and destination, and obtain confirmation unless the user has explicitly…
  8. Return the endpoint, method, content type, complete request fields, expected task/result fields, and the next polling or download step…

What it can do on your machine

Read from SKILL.md and the folder at commit 6e2b116. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • compdf.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Compdf Compress PDF loads about 826 tokens when it runs, and up to ~58k if it reads all its reference files. Until then it costs about 56 tokens; SKILL.md has 406 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~56
When it runs · the whole SKILL.md, loaded when a task matches
~826
With references · SKILL.md plus every file in references/, read only if the agent opens them
~58k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 406 words (~826 tokens).

“ComPDF Compress PDF helps teams shrink PDF file sizes for faster transfer, easier storage, and smoother downstream workflows. It supports adjustable compression strategies, document resolution control, and optional removal of non-essential content such as embedded fonts, bookmarks, and thumbnails so…”

— opening of SKILL.md by ComPDFKit
name
compdf-compress-pdf

Read the full SKILL.md on GitHub

Files

SKILL.md and 3 other files (references) in skills/compdf-compress-pdf of ComPDFKit/compdf-skills.

  • SKILL.md
  • agents/openai.yaml
  • references/endpoint-index.md
  • references/official-api-reference.md

Open the folder on GitHubat commit 6e2b116

Compare with similar skills

Compdf Compress PDF next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Compdf Compress PDF compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Compdf Compress PDF this skillComPDFKit/compdf-skills109—~826Automated safety check: PassNone
Compdf Conversion CLILeoYeAI/openclaw-master-skills2.2k—~5.9kAutomated safety check: PassProprietary
PDF Convert CompdfLeoYeAI/openclaw-master-skills2.2k—~5.8kAutomated safety check: PassProprietary
MarkitdownImCa0/just-laws78114 repos~3.2kAutomated safety check: NotesMIT
Gzh Designisjiamu/gzh-design-skill3.9k1 repos~2.2kAutomated safety check: PassAGPL-3.0
GenOffice Document CLIgenspark-ai/genoffice8.8k—~19kAutomated safety check: PassApache-2.0

Similar skills

  • Compdf Conversion CLI

    LeoYeAI/openclaw-master-skills

    MUST use for ANY PDF or image format conversion task — converting PDF and images (JPG/JPEG/PNG/BMP/TIFF/TIF/WEBP/JPEG2000) to 10 formats (Word, Excel, PPT, HTML, Image, TXT, JSON, Markdown, RTF…

    2.2k GitHub stars~5.9k tokensUpdated 2 mo ago
    Documents & OfficeAuto-check passed
  • PDF Convert Compdf

    LeoYeAI/openclaw-master-skills

    PDF conversion toolkit featuring AI layout analysis and OCR.

    2.2k GitHub stars~5.8k tokensUpdated 2 mo ago
    Documents & OfficeAuto-check passed
  • Markitdown

    ImCa0/just-laws

    Convert files and office documents to Markdown. An agent skill from ImCa0/just-laws.

    781 GitHub starsUsed in 14 repos~3.2k tokens
    Documents & OfficeAuto-check: notes
  • Gzh Design

    isjiamu/gzh-design-skill

    微信公众号文章排版引擎,将 Markdown 转换为可直接粘贴到公众号编辑器的 HTML。主题风格从 references/theme-index.md 注册的自定义主题库中选取,自动章节编号、关键词下划线标记、引言卡片、目录导航、代码块、图片/GIF、作者签名。支持 Markdown / Word(.docx) / PDF / 纯文本输入(非 Markdown…

    3.9k GitHub starsUsed in 1 repo~2.2k tokens
    Documents & OfficeAuto-check passed
  • GenOffice Document CLI

    genspark-ai/genoffice

    Creates, converts, reads and edits real pptx, xlsx, docx and PDF files locally through the genoffice command line.

    8.8k GitHub stars~19k tokensUpdated today
    Documents & OfficeAuto-check passed
  • Harness Book Best Practice

    wquguru/harness-books

    Best practices for working on the Harness books repo. An agent skill from wquguru/harness-books.

    3.2k GitHub stars~4.1k tokensUpdated 5 mo ago
    Documents & OfficeAuto-check passed

More from ComPDFKit/compdf-skills

All 14 skills in this repo
  • ComPDF Watermark Manager

    ComPDFKit/compdf-skills

    Prepares ComPDF Server API requests to add or remove text and image watermarks in PDFs, selecting the right endpoint and listing the complete request details.

    109 GitHub stars~817 tokensUpdated 1 mo ago
    Auto-check passed
  • ComPDF Image to Document Converter

    ComPDFKit/compdf-skills

    Plans ComPDF Server API requests that turn screenshots, scans, receipts and forms into Word, Excel, PPT, PDF, HTML, RTF, CSV, TXT or JSON output.

    109 GitHub stars~891 tokensUpdated 1 mo ago
    Auto-check passed
  • Compdf Documents To PDF

    ComPDFKit/compdf-skills

    Convert Word, Excel, PPT, HTML, TXT, CSV, RTF, PNG, and JPG files into PDF with ComPDF.

    109 GitHub stars~850 tokensUpdated 1 mo ago
    Auto-check passed
  • ComPDF Encrypt and Decrypt PDF

    ComPDFKit/compdf-skills

    Plans ComPDF Server API requests to encrypt PDFs with AES-128, AES-256 or RC4, set passwords and permissions, and remove passwords from files you are authorized to open.

    109 GitHub stars~812 tokensUpdated 1 mo ago
    Auto-check passed
  • Compdf OCR

    ComPDFKit/compdf-skills

    Recognize and extract text from scanned PDFs and images with ComPDF OCR workflows.

    109 GitHub stars~837 tokensUpdated 1 mo ago
    Auto-check passed
  • Compdf Page Editor

    ComPDFKit/compdf-skills

    Merge, split, rotate, insert, delete, and extract PDF pages with ComPDF.

    109 GitHub stars~838 tokensUpdated 1 mo ago
    Auto-check passed

Works with

Questions about Compdf Compress PDF

What does Compdf Compress PDF do?

Compress PDF files with ComPDF while balancing file size and readable visual quality. Compdf Compress PDF is an agent skill from ComPDFKit/compdf-skills. Compress PDF files with ComPDF while balancing file size and readable visual quality.

When should I use Compdf Compress PDF?

Compdf Compress PDF fits situations like: PDF optimization; resolution control; compression strategies; removal of non-essential document content.

How do I install Compdf Compress PDF in Claude Code?

Run `npx skills add ComPDFKit/compdf-skills --skill compdf-compress-pdf -a claude-code`. Or copy the skill folder (skills/compdf-compress-pdf in ComPDFKit/compdf-skills) into .claude/skills/compdf-compress-pdf in your project. Claude Code loads it when a task matches its description.

How do I install Compdf Compress PDF in Codex?

Run `npx skills add ComPDFKit/compdf-skills --skill compdf-compress-pdf -a codex`. Or copy the skill folder (skills/compdf-compress-pdf in ComPDFKit/compdf-skills) into .agents/skills/compdf-compress-pdf in your project. Codex loads it when a task matches its description.

Can I use Compdf Compress PDF in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add ComPDFKit/compdf-skills --skill compdf-compress-pdf -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/compdf-compress-pdf, .gemini/skills/compdf-compress-pdf, .github/skills/compdf-compress-pdf and .opencode/skills/compdf-compress-pdf in your project.

What does Compdf Compress PDF need to run?

SKILL.md names no scripts, command-line tools or credentials: Compdf Compress PDF is instructions for the agent only.

Does Compdf Compress PDF access the network?

SKILL.md names 1 domain. As links in the text: compdf.com. This is read from the text; nothing was executed.

Is Compdf Compress PDF safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Compdf Compress PDF use?

No licence was found for Compdf Compress PDF or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Compdf Compress PDF use?

About 826 tokens (SKILL.md is roughly 3.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 57k tokens, read only when the agent opens those files.

What are the alternatives to Compdf Compress PDF?

Skills that share tags, products or a category with Compdf Compress PDF: Compdf Conversion CLI (LeoYeAI/openclaw-master-skills, 2.2k stars), PDF Convert Compdf (LeoYeAI/openclaw-master-skills, 2.2k stars), Markitdown (ImCa0/just-laws, 781 stars) and Gzh Design (isjiamu/gzh-design-skill, 3.9k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Compdf Compress PDF?

ComPDFKit (a GitHub organization) maintains it in ComPDFKit/compdf-skills, which has 109 GitHub stars. The repository holds 14 skills in this directory. The repository was last updated on August 12, 2026.

Source: ComPDFKit/compdf-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.