← Back to Skills Marketplace
pdf-compress-tool
by
JohnsonKlose
· GitHub ↗
· v1.0.2
· MIT-0
185
Downloads
0
Stars
0
Active Installs
3
Versions
Install in OpenClaw
/install pdf-compress-tool
Description
Compress PDF files to a target size or by percentage, using a Ghostscript + pikepdf + QPDF multi-stage pipeline.
Usage Guidance
This skill appears to do what it says: compress PDFs using pikepdf/Ghostscript/qpdf. Before installing or running it: (1) review the included compress_pdf.py (you already have it) to verify behavior — the script is local and readable; (2) be aware the script will try to run pip install pikepdf at runtime, which fetches a package from PyPI — if you prefer, preinstall pikepdf in a controlled virtualenv or system environment instead of letting the script auto-install; (3) run the tool on non-sensitive/test PDFs first to confirm results; (4) ensure Ghostscript and qpdf are installed from trusted package sources when needed; and (5) if you require stronger isolation, execute the script in a sandbox/container or VM so runtime dependency installation cannot affect your host environment.
Capability Analysis
Type: OpenClaw Skill
Name: pdf-compress-tool
Version: 1.0.2
The pdf-compress-tool is a legitimate utility designed to compress PDF files using a multi-stage pipeline involving pikepdf, Ghostscript, and QPDF. While the script performs high-privilege actions such as executing external binaries via subprocess.run and auto-installing the 'pikepdf' library via pip, these behaviors are transparently documented and directly support the tool's stated purpose. There is no evidence of data exfiltration, unauthorized network access, persistence mechanisms, or malicious prompt injection in the SKILL.md or compress_pdf.py files.
Capability Assessment
Purpose & Capability
Name/description, SKILL.md, and the included compress_pdf.py are consistent: the tool compresses PDFs using pikepdf, Ghostscript, and qpdf. Requiring python3 and recommending ghostscript/qpdf is proportional to the described functionality.
Instruction Scope
SKILL.md instructs the agent to run the included script and to install the listed tools; it does not ask the agent to read unrelated files, harvest environment variables, or transmit data to external endpoints beyond installing dependencies. The runtime instructions and script behavior are narrowly scoped to file compression and dependency checks.
Install Mechanism
There is no formal install spec; the script will attempt to auto-install the Python dependency pikepdf at runtime via pip (subprocess.run [sys.executable, '-m', 'pip', 'install', 'pikepdf']). Auto-installing from PyPI is expected for a Python tool but is a point of caution because it fetches and executes third‑party code.
Credentials
The skill requests no environment variables, no credentials, and no config paths. Its runtime actions (checking PATH for gs/qpdf, running subprocesses) are consistent with its purpose and do not access unrelated secrets.
Persistence & Privilege
The skill is not always-enabled and does not request permanent or system-wide privileges. It does not modify other skills or system-wide agent settings. Autonomous invocation is allowed by default but is not combined with other concerning flags.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install pdf-compress-tool - After installation, invoke the skill by name or use
/pdf-compress-tool - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.2
Version 1.0.2 of pdf-compress-tool
- No file changes detected from the previous version.
- No updates to features, documentation, or dependencies.
- Functionality and usage remain unchanged from the last release.
v1.0.1
- Added Windows to the list of supported operating systems.
- Refined dependency requirements: python3 is now the only required dependency; ghostscript and qpdf are marked as optional.
- Updated installation instructions and added a platform-specific dependency table.
- Dependency guidance now includes Windows install commands and links.
- The script now auto-detects your platform to suggest appropriate installation commands if dependencies are missing.
v1.0.0
Initial release of pdf-compress-tool.
- Compress PDF files by target size or percentage.
- Utilizes a three-stage pipeline: pikepdf, Ghostscript, and QPDF.
- Offers batch processing for directories.
- Supports adjustable quality levels with protection against over-compression.
- Automatically detects and adapts to available dependencies (Ghostscript, QPDF, pikepdf).
Metadata
Frequently Asked Questions
What is pdf-compress-tool?
Compress PDF files to a target size or by percentage, using a Ghostscript + pikepdf + QPDF multi-stage pipeline. It is an AI Agent Skill for Claude Code / OpenClaw, with 185 downloads so far.
How do I install pdf-compress-tool?
Run "/install pdf-compress-tool" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is pdf-compress-tool free?
Yes, pdf-compress-tool is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does pdf-compress-tool support?
pdf-compress-tool is cross-platform and runs anywhere OpenClaw / Claude Code is available (macos, linux, windows).
Who created pdf-compress-tool?
It is built and maintained by JohnsonKlose (@johnsonklose); the current version is v1.0.2.
More Skills