# Nano Pdf

> A Claude skill from Orkas-AI/Orkas-Awesome-AgentSkills.

- **Type:** Skill
- **Install:** `agentstack add skill-orkas-ai-orkas-awesome-agentskills-nano-pdf`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [Orkas-AI](https://agentstack.voostack.com/s/orkas-ai)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [Orkas-AI](https://github.com/Orkas-AI)
- **Source:** https://github.com/Orkas-AI/Orkas-Awesome-AgentSkills/tree/main/office/skills/nano-pdf
- **Website:** https://orkas.ai

## Install

```sh
agentstack add skill-orkas-ai-orkas-awesome-agentskills-nano-pdf
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Nano PDF

## When to Use

Use when the user asks to edit a PDF and the local `nano-pdf` CLI is available.

Good fits:

- change text on a specific page
- add a watermark
- remove or redact a small visible element
- apply a narrow natural-language edit to a page

Do not use when the task requires full document re-layout, legal-grade redaction guarantees, OCR-heavy reconstruction, form extraction, or arbitrary PDF generation.

## Preflight

Before editing:

```bash
command -v nano-pdf
nano-pdf --help
```

If the CLI is unavailable, do not claim the edit was completed. Return a fallback plan or ask whether the user wants to install/configure the tool.

## Workflow

1. Confirm the source PDF path and requested output behavior.
2. Create a backup or work on a copy. Never overwrite the only source PDF.
3. Confirm the intended page number with the user-facing page label if possible.
4. Run a small test or inspect output when page indexing may be ambiguous. Some versions/configurations may treat page numbers as 0-based while users expect 1-based.
5. Run the edit.
6. Open, render, or visually inspect the affected pages before delivery.
7. If the edit landed on the wrong page, restore from backup and retry with the corrected index.

## Command Pattern

```bash
nano-pdf edit   ""
```

Example:

```bash
nano-pdf edit deck.pdf 3 "Change the title to Q3 Results and add a Confidential watermark"
```

Prefer working-copy names such as:

```text
source.pdf
source.working.pdf
source.edited.pdf
```

## Return Format

Return:

- output PDF path
- backup path
- affected pages
- command summary
- visual verification status
- known risks or manual checks

If the CLI is missing or the edit cannot be verified, return:

- `ok: false`
- reason
- suggested fallback
- any prepared but unexecuted instruction

## Limits and Known Issues

- Page numbering may be 0-based or 1-based depending on the installed CLI version/configuration. Verify before final delivery.
- Natural-language edits may not preserve exact typography or layout.
- PDF redaction is high risk. For sensitive redaction, require visual verification and consider a specialized redaction workflow.
- Scanned PDFs may require OCR and may not be editable as text.
- Always inspect output pages; a successful CLI exit is not enough.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [Orkas-AI](https://github.com/Orkas-AI)
- **Source:** [Orkas-AI/Orkas-Awesome-AgentSkills](https://github.com/Orkas-AI/Orkas-Awesome-AgentSkills)
- **License:** MIT
- **Homepage:** https://orkas.ai

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-orkas-ai-orkas-awesome-agentskills-nano-pdf
- Seller: https://agentstack.voostack.com/s/orkas-ai
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.
