What is add-pdf-reader?

A skill that adds PDF reading to Deus agents by extracting text with the `pdftotext` command-line tool. It handles PDFs from WhatsApp attachments, web addresses, and local files.

Use it to read PDF attachments, URLs, and local PDF files, including PDFs received through WhatsApp.

It removes the need to open and copy text from PDF files manually. WhatsApp PDF attachments are downloaded into the group's workspace for processing.

add-pdf-reader — Skill for Claude Code and Codex by sliamh11: A skill that adds PDF reading to Deus agents…

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods

npx agentmods add skills/sliamh11/deus/add-pdf-reader

Any agent

npx skills add sliamh11/Deus --skill add-pdf-reader

Clone the repo

git clone --depth 1 https://github.com/sliamh11/Deus

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

README.md

[![agentmods](https://agentmods.dev/badge/skills/sliamh11/deus/add-pdf-reader.svg)](https://agentmods.dev/skills/sliamh11/deus/add-pdf-reader)

Your own site

<a href="https://agentmods.dev/skills/sliamh11/deus/add-pdf-reader"><img src="https://agentmods.dev/badge/skills/sliamh11/deus/add-pdf-reader.svg" alt="Measured on agentmods" height="20"></a>

Per session 35 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.

When invoked 653 The whole file, excluding the scripts and references it only reads on demand.

Security scan A 0 findings. Scan, not verified.

Origin original No closer match found in the catalogue.

Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

Model	Per session	Once invoked
Fable 5	$0.00035	$0.00653
Opus 5	$0.00017	$0.00327
Sonnet 5	$0.00007	$0.00131
Haiku 4.5	$0.00003	$0.00065

Measured 5d ago against content hash 88e1e96a25ad, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

add-pdf-reader scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 5d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

Origin

Copies of this mod

7 near-identical copies found in the catalogue:

add-pdf-reader — 88% identical, 34 lines differ
add-pdf-reader — 86% identical, 34 lines differ
add-pdf-reader — 86% identical, 34 lines differ
add-pdf-reader — 86% identical, 34 lines differ
add-pdf-reader — 86% identical, 34 lines differ
add-pdf-reader — 86% identical, 34 lines differ
add-pdf-reader — 86% identical, 34 lines differ

.claude/skills/add-pdf-reader/SKILL.md · 91 lines

How it starts

The opening of the file, as written. The whole thing — 91 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Add PDF Reader

Adds PDF reading capability to all container agents using poppler-utils (pdftotext/pdfinfo). PDFs sent as WhatsApp attachments are auto-downloaded to the group workspace.

Phase 1: Pre-flight

Check if container/skills/pdf-reader/pdf-reader exists — skip to Phase 3 if already applied
Confirm WhatsApp is installed first (via /add-whatsapp). This skill modifies WhatsApp channel files.

Phase 2: Apply Code Changes

PDF reading is part of the WhatsApp MCP package in packages/. Check if the PDF reader already exists:

test -f container/skills/pdf-reader/pdf-reader && echo "Already present" || echo "Not present"

If not present, the WhatsApp MCP package should include PDF reading support. Ensure the WhatsApp channel is installed and up to date by running /add-whatsapp.

The following files are involved:

container/skills/pdf-reader/SKILL.md (agent-facing documentation)
container/skills/pdf-reader/pdf-reader (CLI script)
poppler-utils in container/Dockerfile
PDF attachment download in src/channels/whatsapp.ts
PDF tests in src/channels/whatsapp.test.ts

If the merge reports conflicts, resolve them by reading the conflicted files and understanding the intent of both sides.

Validate

npm run build
npx vitest run src/channels/whatsapp.test.ts

Rebuild container

./container/build.sh

Restart service

launchctl kickstart -k gui/$(id -u)/com.deus  # macOS
# Linux: systemctl --user restart deus

Phase 3: Verify

Test PDF extraction

Send a PDF file in any registered WhatsApp chat. The agent should:

Download the PDF to attachments/
Respond acknowledging the PDF
Be able to extract text when asked

Test URL fetching

Ask the agent to read a PDF from a URL. It should use pdf-reader fetch <url>.

Check logs if needed

tail -f logs/deus.log | grep -i pdf

Look for:

Downloaded PDF attachment — successful download
Failed to download PDF attachment — media download issue

Read the full file on GitHub · 91 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

5d ago First seen · 91 lines · 35 tokens per session scan A 88e1e96a25ad

Subscribe to this mod's changes

add-pdf-reader is a skill published in the GitHub repository sliamh11/Deus (51 stars, last pushed yesterday), licensed MIT. It adds 35 tokens to every session and 653 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Documents PDF ai-assistant ai-memory claude-code persistent memory self-improving-ai semantic-memory

wowerpoint

Turn one document into a kawaii NotebookLM slide-deck PDF. Use for "wowerpoint this", "make a deck about ", "turn this report into slides", or any request to render a single document as shareable narrative slides.

thedotmack/claude-mem · 55 tokens

pdf-analysis

PDF 文档解析。自动区分文字型 PDF 与扫描型 PDF，覆盖：文本/表格提取、多页全量扫描、嵌入图表 caption、单位感知数值计算。.

OpenSenseNova/SenseNova-Skills · 48 tokens

sn-da-non-spreadsheet-analysis

Word / PDF / PPT 文档解析与数据分析引擎。覆盖三类文件格式的全量提取、表格数值化、图表理解与跨文档汇总分析。遇到以下任一情况就主动使用本 skill：①用户上传或指定了 .docx / .doc / .pdf / .pptx / .ppt 文件并要求分析、提取或统计其中内容；②用户出现触发词：Word分析 / PDF解析 / PPT提取 / 文档分析 / 报告解析 / 幻灯片分析 / 发票提取 / 合同分析 / 文档统计 / 错别字 / 语病 / 字号检查 / 简历分析 / 多文档对比；③任务涉及从文档中提取表格、数值、图表、格式（颜色/高亮/字号）、组织架构、时间线等结构化信息。仅不用于：Excel/CSV…

OpenSenseNova/SenseNova-Skills · 234 tokens

pdf-toolkit

PDF 工具箱 - 合并/拆分/提取文字/转图片，纯命令行处理本地 PDF.

dongsheng123132/u-claw · 30 tokens

chat-complex-documents

Chat with and search your complex documents — ask questions, extract tables and fields, and get answers grounded in the source. Connects the hosted Unstructured Transform MCP server to parse, structure, and enrich PDFs, Word/Excel/PowerPoint, images, scanned files, emails, and 60+ other formats into clean, AI-ready…

vellum-ai/vellum-assistant · 90 tokens

pdf-editing

Use the bundled tools; do not install nano-pdf, pypdf, qpdf, Poppler, or another PDF package during a task.

Orkas-AI/Orkas · 3 tokens