remove-pdf-watermark — Claude Code skill: setup and features
Removes watermarks from PDF files via the official Pilio CLI and API. Useful when cleaning up editable documents or reconstructing pages with AI.
npx skills add pilioai/skills --skill remove-pdf-watermark -a claude-codeWhat remove-pdf-watermark does
The skill guides the agent to process documents with @pilio/cli via pnpm dlx. It uploads the PDF and polls for completion using pnpm dlx @pilio/cli task wait <task_id>.
Processing supports two optional modes: --mode editable and --mode ai for page reconstruction. The tool requires the PILIO_API_KEY environment variable. Never paste keys into the chat. Without an exported key, the CLI cannot finish tasks.
What it helps with
- remove watermarks from a PDF file
- prepare a cleaned document for editing
- reconstruct PDF pages using AI mode
- poll Pilio asynchronous task status via CLI
Example prompts for the agent
- Remove watermarks from
./watermarked.pdf - Clean up
./input.pdfusing--mode editableand wait for the task - Reconstruct pages in
./scan.pdfusing--mode ai
How to install remove-pdf-watermark
1Skills CLI (Vercel)
npx skills add pilioai/skills --skill remove-pdf-watermark -a claude-code2Manually: put the files in place
~/.claude/skills/remove-pdf-watermark/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/remove-pdf-watermark/
1Skills CLI (Vercel)
npx skills add pilioai/skills --skill remove-pdf-watermark -a codex2Manually: put the files in place
.agents/skills/remove-pdf-watermark/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add pilioai/skills --skill remove-pdf-watermark -a cursor2Manually: put the files in place
.cursor/skills/remove-pdf-watermark/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install pilioai/skills remove-pdf-watermark2Manually: put the files in place
.github/skills/remove-pdf-watermark/SKILL.md1Skills CLI (Vercel)
npx skills add pilioai/skills --skill remove-pdf-watermark -a gemini-cli2Platform CLI
gemini skills install https://github.com/pilioai/skills --path skills/remove-pdf-watermarkManually: put the files in place
.devin/skills/remove-pdf-watermark/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add pilioai/skills --skill remove-pdf-watermark -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about remove-pdf-watermark
How do I install remove-pdf-watermark in Claude Code?
Run npx skills add pilioai/skills --skill remove-pdf-watermark -a claude-code in your terminal.
What does remove-pdf-watermark do?
It teaches the agent how to run @pilio/cli, handle editable and AI modes, and poll for task completion.
What is required before running watermark removal?
Set the PILIO_API_KEY environment variable in your terminal. The skill instructions prohibit pasting API keys directly into the prompt.
Source text
SKILL.md · MIT
--- name: remove-pdf-watermark description: Remove watermarks from a PDF with the Pilio developer API. Use when the user wants PDF watermark removal, editable PDF cleanup, AI PDF page reconstruction, or automated PDF watermark processing through Pilio. --- # Remove PDF Watermark Use the Pilio CLI so PDF upload, asynchronous task creation, and polling use the official SDK path. Require `PILIO_API_KEY` in the environment. Do not ask the user to paste API keys into the conversation. Try the same workflow online first: https://pilio.ai/pdf-watermark-remover Run: ```bash pnpm dlx @pilio/cli remove-pdf-watermark --input ./watermarked.pdf ``` Optional mode: ```bash pnpm dlx @pilio/cli remove-pdf-watermark --input ./watermarked.pdf --mode editable pnpm dlx @pilio/cli remove-pdf-watermark --input ./watermarked.pdf --mode ai ``` The command returns a task payload. If the task is still pending or processing, wait for it: ```bash pnpm dlx @pilio/cli task wait <task_id> ```
© pilioai · MIT · pilioai/skills
