Index of every page on this site: llms.txt
All skills
github avatar

/pdftk-server

@f10fdb8 official
by githubgithub/awesome-copilot41k stars
5,399
Run it yourself

Skill for using the command-line tool pdftk (PDFtk Server) for working with PDF files. Use when asked to merge PDFs, split PDFs, rotate pages, encrypt or decrypt PDFs, fill PDF forms, apply watermarks, stamp overlays, extract metadata, burst documents into pages, repair corrupted PDFs, attach or extract files, or perform any PDF manipulation from the command line.

Use this Skill: https://skilld.dev/gh/github/awesome-copilot/pdftk-server

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

SKILL.md

≈95 tokens for metadata: the name and description. ≈1.1k when used: this file. ≈6.1k more on demand in 5 files.

Description uses 4.8% of example budget

Before choosing a Skill, your Agent reads its name and description. All available Skills share that space.

  • A shorter description leaves more room for other Skills. This entry exceeds our 1% size suggestion.

In our Claude Code example, all Skill names and descriptions share 8,000 characters. This Skill uses ≈381 characters, or 4.8%.

The 1% threshold is a size suggestion. Longer descriptions can still fit.

Your model, settings, and other Skills decide how much text your Agent can read.

Example settings and source

The example uses a 200k-token context and default Claude Code settings. The count includes the name, description, separators, and when_to_use when present. Codex also counts local file paths.

Skit's source and limits: Codex 0.160.1, Claude Code 2.1.292.

PDFtk Server

PDFtk Server is a command-line tool for working with PDF documents. It can merge, split, rotate, encrypt, decrypt, watermark, stamp, fill forms, extract metadata, and manipulate PDFs in a variety of ways.

When to Use This Skill

  • Merging or joining multiple PDF files into one
  • Splitting or bursting a PDF into individual pages
  • Rotating PDF pages
  • Encrypting or decrypting PDF files
  • Filling PDF form fields from FDF/XFDF data
  • Applying background watermarks or foreground stamps
  • Extracting PDF metadata, bookmarks, or form field information
  • Repairing corrupted PDF files
  • Attaching or extracting files embedded in PDFs
  • Removing specific pages from a PDF
  • Collating separately scanned even/odd pages
  • Compressing or decompressing PDF page streams

Prerequisites

  • PDFtk Server must be installed on the system
    • Windows: winget install --id PDFLabs.PDFtk.Server
    • macOS: brew install pdftk-java
    • Linux (Debian/Ubuntu): sudo apt-get install pdftk
    • Linux (Red Hat/Fedora): sudo dnf install pdftk
  • Access to a terminal or command prompt
  • Verify installation by running pdftk --version

Step-by-Step Workflows

Merge Multiple PDFs

pdftk file1.pdf file2.pdf cat output merged.pdf

Using handles for more control:

pdftk A=file1.pdf B=file2.pdf cat A B output merged.pdf

Split a PDF into Individual Pages

pdftk input.pdf burst

Extract Specific Pages

Extract pages 1-5 and 10-15:

pdftk input.pdf cat 1-5 10-15 output extracted.pdf

Remove Specific Pages

Remove page 13:

pdftk input.pdf cat 1-12 14-end output output.pdf

Rotate Pages

Rotate all pages 90 degrees clockwise:

pdftk input.pdf cat 1-endeast output rotated.pdf

Encrypt a PDF

Set an owner password and a user password with 128-bit encryption (default):

pdftk input.pdf output secured.pdf owner_pw mypassword user_pw userpass

Decrypt a PDF

Remove encryption using the known password:

pdftk secured.pdf input_pw mypassword output unsecured.pdf

Fill a PDF Form

Populate form fields from an FDF file and flatten to prevent further edits:

pdftk form.pdf fill_form data.fdf output filled.pdf flatten

Apply a Background Watermark

Place a single-page PDF behind every page of the input (input should have transparency):

pdftk input.pdf background watermark.pdf output watermarked.pdf

Stamp an Overlay

Place a single-page PDF on top of every page of the input:

pdftk input.pdf stamp overlay.pdf output stamped.pdf

Extract Metadata

Export bookmarks, page metrics, and document information:

pdftk input.pdf dump_data output metadata.txt

Repair a Corrupted PDF

Pass a broken PDF through pdftk to attempt automatic repair:

pdftk broken.pdf output fixed.pdf

Collate Scanned Pages

Interleave separately scanned even and odd pages:

pdftk A=even.pdf B=odd.pdf shuffle A B output collated.pdf

Troubleshooting

Issue Solution
pdftk command not found Verify installation; check that pdftk is in your system PATH
Cannot decrypt PDF Ensure you are providing the correct owner or user password via input_pw
Output file is empty or corrupt Check input file integrity; try running pdftk input.pdf output repaired.pdf first
Form fields not visible after fill Use the flatten flag to merge fields into the page content
Watermark not appearing Ensure the input PDF has transparent regions; use stamp for opaque overlays
Permission denied errors Check file permissions on input and output paths

References

Bundled reference documents in the references/ folder:

Source: SKILL.md on GitHub

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

1 warning2mo5 checks · Risk SAFE
  • Gen Agent Trust Hub2mo

    This skill provides comprehensive instructions for using the pdftk command-line tool to manipulate PDF files. It includes standard installation procedures for multiple operating systems and guides for common tasks like merging, splitting, and encrypting PDFs. While it involves processing external PDF documents and executing commands, these activities are central to the tool's legitimate purpose and are documented safely using illustrative examples.

  • Socket2mo

    No alerts

  • Snyk2mo

    Risk: LOW · No issues

  • Runlayer9mo

    6/6 files flagged

  • ZeroLeaks7mo

    Score: 93/100 · 2 sections analyzed

Signed by skilld at f10fdb8. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub yesterday.

Activeupdated 9 months ago
  • CLI
  • pdftk
  • pdf
  • command-line
  • merge
  • encryption
  • forms
  • watermark

README badge

README badge for github/awesome-copilot/pdftk-server

Wraps the pdftk command-line tool for PDF manipulation tasks like merging, splitting, rotating, encrypting, decrypting, filling forms, watermarking, and extracting metadata. Use this skill when you need to perform batch PDF operations from the command line without a GUI tool.

Generated from the current SKILL.md.

Does pdftk work on Windows, macOS, and Linux?
Yes. Installation differs by platform: Windows uses winget, macOS uses Homebrew (pdftk-java), and Linux uses apt or dnf depending on the distribution.
Can this skill encrypt and decrypt PDFs?
Yes. You can encrypt with owner and user passwords using the owner_pw and user_pw flags, and decrypt by providing the password with input_pw.
Does this handle PDF form filling?
Yes. You can populate form fields from FDF/XFDF data files and flatten the result to prevent further edits.
Can I repair corrupted PDF files?
Yes. Running pdftk on a broken PDF and writing the output often repairs corruption automatically.
What is required to use this skill?
PDFtk Server must be installed on your system and accessible from the command line. Verify installation by running pdftk --version.

Generated from the current SKILL.md. These answers refresh after source changes.