Docsagent
docsagent/docsagent
Search and manage private, local document collections (PDF, PPTX, DOCX) offline.
Edit or create PDFs with natural-language instructions using the nano-pdf CLI.
Install Nano PDF
$ npx skills add swarmclawai/swarmclaw --skill nano-pdf -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install swarmclawai/swarmclaw nano-pdf --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/swarmclawai/swarmclaw.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/nano-pdf .claude/skills/nano-pdf && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "nano-pdf" agent skill from https://github.com/swarmclawai/swarmclaw/tree/main/skills/nano-pdf into .claude/skills/nano-pdf/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "nano-pdf", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/swarmclawai/swarmclaw/tree/main/skills/nano-pdfType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add swarmclawai/swarmclaw --skill nano-pdf -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install swarmclawai/swarmclaw nano-pdf --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/swarmclawai/swarmclaw.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/nano-pdf .agents/skills/nano-pdf && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "nano-pdf" agent skill from https://github.com/swarmclawai/swarmclaw/tree/main/skills/nano-pdf into .agents/skills/nano-pdf/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "nano-pdf", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add swarmclawai/swarmclaw --skill nano-pdf -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install swarmclawai/swarmclaw nano-pdf --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/swarmclawai/swarmclaw.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/nano-pdf .cursor/skills/nano-pdf && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "nano-pdf" agent skill from https://github.com/swarmclawai/swarmclaw/tree/main/skills/nano-pdf into .cursor/skills/nano-pdf/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "nano-pdf", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/swarmclawai/swarmclaw.git --path skills/nano-pdf--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add swarmclawai/swarmclaw --skill nano-pdf -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install swarmclawai/swarmclaw nano-pdf --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/swarmclawai/swarmclaw.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/nano-pdf .gemini/skills/nano-pdf && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "nano-pdf" agent skill from https://github.com/swarmclawai/swarmclaw/tree/main/skills/nano-pdf into .gemini/skills/nano-pdf/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "nano-pdf", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install swarmclawai/swarmclaw nano-pdfInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add swarmclawai/swarmclaw --skill nano-pdf -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/swarmclawai/swarmclaw.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/nano-pdf .github/skills/nano-pdf && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "nano-pdf" agent skill from https://github.com/swarmclawai/swarmclaw/tree/main/skills/nano-pdf into .github/skills/nano-pdf/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "nano-pdf", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add swarmclawai/swarmclaw --skill nano-pdf -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install swarmclawai/swarmclaw nano-pdf --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/swarmclawai/swarmclaw.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/nano-pdf .opencode/skills/nano-pdf && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "nano-pdf" agent skill from https://github.com/swarmclawai/swarmclaw/tree/main/skills/nano-pdf into .opencode/skills/nano-pdf/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "nano-pdf", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
nano-pdf- GitHub stars
- 689
- Token cost
- ~379 tokens
- SKILL.md length
- 111 words
- Files
- 1
- Skills in repo
- 12
- Repo updated
- First seen
- Licence
- MIT
At a glance
Edit or create PDFs with natural-language instructions using the nano-pdf CLI.
- Works in 4 steps: Check if nano-pdf is installed: which… → If not installed, install via uv tool… → Run the appropriate command → …
- Asked to make a PDF
- SKILL.md covers Quick Start, Creating a New PDF, Usage in SwarmClaw and Notes
- Calls uv and pip
What it does
Nano PDF is an agent skill from swarmclawai/swarmclaw. Edit or create PDFs with natural-language instructions using the nano-pdf CLI. Use when asked to make a PDF, edit a PDF, add pages, change text in a PDF, or convert content to PDF format.
Its SKILL.md is about 380 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
It sits in Documents & Office, covering PDF and Building AI agents. It works with Model Context Protocol. The repository describes itself as: Open-source self-hosted AI agent runtime and multi-agent framework for autonomous agent swarms. Agent memory, MCP tools, schedules, delegation, and 23+ LLM providers (Claude… The licence is MIT.
When your agent uses it
- Asked to make a PDF
- Change text in a PDF
- Convert content to PDF format
Example prompts
- “/nano-pdf”
Requirements
- Python 3
Workflow steps
4 steps, taken from the first numbered list in SKILL.md.
- Check if nano-pdf is installed: which nano-pdf
- If not installed, install via uv tool install nano-pdf or pip install nano-pdf
- Run the appropriate command
- Report the output file path to the user
What it can do on your machine
Read from SKILL.md and the folder at commit ed38ba5. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
uvpip
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md. Its commands use uv and pip, which can reach the network depending on how they are called.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Nano PDF loads about 379 tokens when it runs. Until then it costs about 49 tokens; SKILL.md has 111 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from swarmclawai/swarmclaw at commit ed38ba5, republished under its MIT licence (© swarmclawai). 111 words, ~379 tokens.
Download SKILL.mdSave it as
.claude/skills/nano-pdf/SKILL.md (or your agent's skills folder).- name
- nano-pdf
- description
- Edit or create PDFs with natural-language instructions using the nano-pdf CLI. Use when asked to make a PDF, edit a PDF, add pages, change text in a PDF, or convert content to PDF format.
nano-pdf
Use nano-pdf to apply edits to a specific page in a PDF using a natural-language instruction.
Quick Start
nano-pdf edit deck.pdf 1 "Change the title to 'Q3 Results' and fix the typo in the subtitle"Creating a New PDF
nano-pdf create output.pdf "Create a one-page summary of quarterly results with a header, bullet points, and a footer"Usage in SwarmClaw
When a user asks to create or edit a PDF:
- Check if
nano-pdfis installed:which nano-pdf - If not installed, install via
uv tool install nano-pdforpip install nano-pdf - Run the appropriate command
- Report the output file path to the user
Notes
- Page numbers are 0-based or 1-based depending on the tool's version; if the result looks off by one, retry with the other.
- Always sanity-check the output PDF before reporting success.
- For multi-page edits, run separate commands per page.
© swarmclawai, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
Just SKILL.md in skills/nano-pdf of swarmclawai/swarmclaw.
Open the folder on GitHubat commit ed38ba5
Compare with similar skills
Nano PDF next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Nano PDF this skillswarmclawai/swarmclaw | 689 | — | ~379 | Automated safety check: Pass | MIT | |
| Docsagentdocsagent/docsagent | 625 | — | ~834 | Automated safety check: Pass | None | |
| PDF Tools WorkflowOpen-Document-Alliance/PDF-Tools | 160 | — | ~4.7k | Automated safety check: Pass | MIT | |
| PDF FormsOpen-Document-Alliance/PDF-Tools | 160 | — | ~729 | Automated safety check: Pass | MIT | |
| PDF ToolsOpen-Document-Alliance/PDF-Tools | 160 | — | ~1k | Automated safety check: Pass | MIT | |
| Nutrient Document Processingaffaan-m/ECC | 277k | 4 repos | ~1.5k | Automated safety check: Pass | MIT |
Similar skills
PDF Tools Workflow
Open-Document-Alliance/PDF-Tools
Read, compare, fill, stamp, organize, and prepare PDFs for signing with PDF Tools.
PDF Forms
Open-Document-Alliance/PDF-Tools
Help inspect and fill PDF forms, find signature locations, add a visible signature stamp with the person's confirmation, and flatten a reviewed form using the hosted PDF Forms tools.
PDF Tools
Open-Document-Alliance/PDF-Tools
Read and search PDFs, turn selected pages into Markdown, fill PDF forms, and create new copies with selected, reordered, rotated or merged pages.
Nutrient Document Processing
affaan-m/ECC
Process, convert, OCR, extract, redact, sign, and fill documents using the Nutrient DWS API.
Nutrient Document Processing
affaan-m/ECC
使用Nutrient DWS API处理、转换、OCR识别、提取、编辑、签名和填写文档。支持PDF、DOCX、XLSX、PPTX、HTML和图像格式。
More from swarmclawai/swarmclaw
All 12 skills in this repoOpenai Image Gen
swarmclawai/swarmclaw
Generate images via OpenAI Images API (GPT Image, DALL-E 3, DALL-E 2).
Skill Creator
swarmclawai/swarmclaw
Create, edit, improve, or audit skills for SwarmClaw agents.
Nano Banana Pro
swarmclawai/swarmclaw
Generate or edit images via Gemini 3 Pro Image (Nano Banana Pro).
Coding Agent
swarmclawai/swarmclaw
Delegate coding tasks to external coding agents (Claude Code, Codex, Pi, OpenCode) via shell.
GitHub
swarmclawai/swarmclaw
GitHub operations via gh CLI: issues, PRs, CI runs, code review, API queries.
Swarmclaw
swarmclawai/swarmclaw
AI agent runtime and multi-agent orchestration platform. An agent skill from swarmclawai/swarmclaw.
Related
Works with
Categories
Questions about Nano PDF
What does Nano PDF do?
Edit or create PDFs with natural-language instructions using the nano-pdf CLI. Nano PDF is an agent skill from swarmclawai/swarmclaw. Edit or create PDFs with natural-language instructions using the nano-pdf CLI.
When should I use Nano PDF?
Nano PDF fits situations like: asked to make a PDF; change text in a PDF; convert content to PDF format.
How do I install Nano PDF in Claude Code?
Run `npx skills add swarmclawai/swarmclaw --skill nano-pdf -a claude-code`. Or copy the skill folder (skills/nano-pdf in swarmclawai/swarmclaw) into .claude/skills/nano-pdf in your project. Claude Code loads it when a task matches its description.
How do I install Nano PDF in Codex?
Run `npx skills add swarmclawai/swarmclaw --skill nano-pdf -a codex`. Or copy the skill folder (skills/nano-pdf in swarmclawai/swarmclaw) into .agents/skills/nano-pdf in your project. Codex loads it when a task matches its description.
Can I use Nano PDF in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add swarmclawai/swarmclaw --skill nano-pdf -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/nano-pdf, .gemini/skills/nano-pdf, .github/skills/nano-pdf and .opencode/skills/nano-pdf in your project.
What does Nano PDF need to run?
Going by SKILL.md and its folder, Nano PDF needs the command-line tools its instructions call (uv and pip). Our summary lists: Python 3.
Does Nano PDF access the network?
SKILL.md contains no URLs. Its commands use uv and pip, which can reach the network depending on how they are called. This is read from the text; nothing was executed.
Is Nano PDF safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Nano PDF use?
Nano PDF is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Nano PDF use?
About 379 tokens (SKILL.md is roughly 1.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Nano PDF?
Skills that share tags, products or a category with Nano PDF: Docsagent (docsagent/docsagent, 625 stars), PDF Tools Workflow (Open-Document-Alliance/PDF-Tools, 160 stars), PDF Forms (Open-Document-Alliance/PDF-Tools, 160 stars) and PDF Tools (Open-Document-Alliance/PDF-Tools, 160 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Nano PDF?
swarmclawai (a GitHub organization) maintains it in swarmclawai/swarmclaw, which has 689 GitHub stars. The repository holds 12 skills in this directory. The repository was last updated on June 30, 2026.
Source: swarmclawai/swarmclaw on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.