home / skills / openclaw / skills / nano-pdf

nano-pdf skill

safe

This skill lets you edit a specific PDF page using natural-language instructions via the nano-pdf CLI, streamlining document updates.

npx playbooks add skill openclaw/skills --skill nano-pdf

Review the files below or copy the command above to add this skill to your agents.

Files (2)

SKILL.md

765 B

---
name: nano-pdf
description: Edit PDFs with natural-language instructions using the nano-pdf CLI.
homepage: https://pypi.org/project/nano-pdf/
metadata: {"clawdbot":{"emoji":"📄","requires":{"bins":["nano-pdf"]},"install":[{"id":"uv","kind":"uv","package":"nano-pdf","bins":["nano-pdf"],"label":"Install nano-pdf (uv)"}]}}
---

# nano-pdf

Use `nano-pdf` to apply edits to a specific page in a PDF using a natural-language instruction.

## Quick start

```bash
nano-pdf edit deck.pdf 1 "Change the title to 'Q3 Results' and fix the typo in the subtitle"
```

Notes:
- Page numbers are 0-based or 1-based depending on the tool’s version/config; if the result looks off by one, retry with the other.
- Always sanity-check the output PDF before sending it out.

Overview

This skill provides a simple CLI tool, nano-pdf, that applies edits to a specific page inside a PDF using plain-language instructions. It lets you change text, correct typos, or adjust page content without opening a full PDF editor. The interface is optimized for quick, focused edits from the terminal.

How this skill works

You run the nano-pdf CLI with the target file, a page identifier, and a natural-language instruction. The tool inspects the specified page, interprets the instruction, applies the edit, and writes an updated PDF. Page numbering may be 0-based or 1-based depending on the installed version, so verify results and retry with the alternate index if edits appear shifted.

When to use it

Make a quick text correction on a single page without launching a GUI editor
Update a slide title or subtitle in a deck before sharing
Fix a misspelling, change a label, or tweak a small paragraph
Automate simple PDF page edits in shell scripts or CI pipelines
Apply last-minute copy changes prior to distribution

Best practices

Always keep a backup of the original PDF before editing
Sanity-check the output PDF immediately after each edit
If edits appear on the wrong page, retry with the other page-numbering convention
Provide concise, specific instructions to avoid unintended changes
Test the tool on a copy when using it in automated workflows

Example use cases

nano-pdf edit deck.pdf 1 "Change the title to 'Q3 Results' and fix the typo in the subtitle"
Correct a product spec page header without re-exporting the whole document
Script batch edits to update a date or version string across multiple PDFs
Quickly adjust a slide's bullet text before a presentation

FAQ

How do I know if page numbers are 0-based or 1-based?

If the edit targets the wrong page, rerun the command with the page index shifted by one. Try both conventions on a copy to determine which your installation uses.

Can I undo an edit?

The CLI writes a new PDF. Keep a backup of the original file to revert. Consider scripting edits to write to a separate output filename.