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.
npx skills add gausoft/markpdf-skill --skill markpdfgit clone --depth 1 https://github.com/gausoft/markpdf-skillWrote 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.
[](https://agentmods.dev/skills/gausoft/markpdf-skill/markpdf)<a href="https://agentmods.dev/skills/gausoft/markpdf-skill/markpdf"><img src="https://agentmods.dev/badge/skills/gausoft/markpdf-skill/markpdf/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/skills/gausoft/markpdf-skill/markpdf"><img src="https://agentmods.dev/badge/skills/gausoft/markpdf-skill/markpdf.svg" alt="Reviewed on agentmods" width="80" height="20"></a>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.1 | $0.00056 | $0.02419 |
| Opus 5.5 | $0.00022 | $0.00968 |
| Sonnet 5.5 | $0.00011 | $0.00484 |
| Haiku 4.5 | $0.00006 | $0.00242 |
Grade A, and why
markpdf scanned grade A with 1 finding 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 1mo 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.
Makes network callslowCapability
Not a fault in itself. Listed so you know the mod talks to something, and to what.
- `scripts/render.sh` — curl fallback when MCP isn't installed How it starts
The opening of the file, as written. The whole thing — 187 lines — stays where its author put it; the contents beside it link to each section on GitHub.
MarkPDF Skill
MarkPDF turns Markdown into production-grade PDFs, decks, and HTML through a hosted MCP server. This skill teaches Claude:
- The default opinionated workflow (what to do when the user just says "make a PDF")
- The decision tree for variations (custom theme, sharing, password, email gate, etc.)
- The OS-aware delivery step (auto-open the result when possible)
Read
references/workflows.mdfor the full playbook with copy-paste recipes. This file is the index + golden rules.
When to use this skill
Trigger on requests like:
- "Make this a PDF / printable / executive report / brochure"
- "Turn this into slides / a pitch deck / a PowerPoint / a Marp deck"
- "Style this as a Notion-like doc / academic paper / corporate report"
- "Share this document with a link" / "Send to alice@…"
- "Apply theme X to this Markdown"
Do not use this skill for:
- Plain in-chat Markdown rendering (no export needed)
- PDFs of arbitrary HTML/CSS unrelated to Markdown
- Editing existing PDFs (MarkPDF only generates)
The 7 MCP tools
| Tool | Use it when | Quota |
|---|---|---|
whoami |
Always call first if unsure of tier/quota | Free |
list_themes |
User asks "what themes are available?" or you need to verify a slug | Free |
redeem_license |
User has a Pro license key and wants to upgrade in-place | Free |
convert_markdown_to_html |
Iterating on styling, embedding, previewing | Free |
convert_markdown_to_pdf |
Final document export | Yes |
convert_markdown_to_slides |
Slide deck (PDF or PPTX) — Marp-compatible | Yes |
create_share_link |
Default delivery channel — clean URL, optional gating | Free |
🎯 The default workflow (do this unless told otherwise)
When a user gives you Markdown content and asks for any kind of styled output:
┌─ 1. Detect intent (PDF | slides | HTML) ──────────────────┐
│ │
│ 2. Pick a theme (intent → theme map, see below) │
│ │
│ 3. whoami (skip if already done this session) │
│ │
│ 4. If user has a Pro license key in context AND they're │
│ on free tier → propose redeem_license (don't force) │
│ │
│ 5. Generate the artifact: │
│ - PDF → convert_markdown_to_pdf │
│ - Slides → convert_markdown_to_slides │
│ - HTML → convert_markdown_to_html │
│ │
│ 6. Create a share link (always, in parallel) │
│ → create_share_link returns markpdf.app/d/<id> │
│ │
│ 7. Deliver to the user: │
│ a) Show the SHARE link prominently (markpdf.app/d/…) │
│ b) Show the download link as a secondary option │
│ c) Auto-open the share link in the browser if possible │
│ (see "OS-aware open" below) │
│ │
│ 8. Report quota status if free tier (X/2 today, 00:00 UTC) │
└──────────────────────────────────────────────────────────────┘
What ships with it
16 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.
- examples/academic.md 3.7 KB
- examples/pitch-deck.md 1.8 KB
- examples/report.md 2.1 KB
- previews/aurora.png 51 KB
- previews/consul.png 47 KB
- previews/midnight.png 41 KB
- previews/obsidian.png 40 KB
- previews/paper.png 57 KB
- previews/slate.png 50 KB
- references/customization.md 4.2 KB
- references/frontmatter.md 2.5 KB
- references/slides.md 3.9 KB
- references/themes.md 4.9 KB
- references/workflows.md 9.9 KB
- scripts/open-url.sh 890 B runs code
- scripts/render.sh 2.2 KB runs code
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.
- 1mo ago First seen · 187 lines · 56 tokens per session scan A 006e44839abf
markpdf is a skill published in the GitHub repository gausoft/markpdf-skill (5 stars, last pushed 5mo ago), licensed MIT. It adds 56 tokens to every session and 2,419 once invoked, about $0.0002 per session on Opus 5.5. A static security scan graded it A with 1 finding (makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.
Other skills, from other repositories
wong
Compile everything Claude did today across ALL sessions and repos into one dated teaching-guide markdown saved in "/Daily Log", render it as a phone-readable PDF, and upload to Google Drive. Safe to run multiple times a day — it appends only newly-uncovered work to that day's single file rather than overwriting. Use…
claude-students
Transforma una carpeta cruda de material de un parcial universitario (PDFs, DOC/DOCX, PPT, audios .ogg de WhatsApp, capturas) en un material de estudio polished y completo — HTML SOTA autocontenido + paquete de artefactos de NotebookLM (podcast en español, infografía, guía de estudio, briefing doc, mind map, quiz…
PDF files: create, read, merge, fill, OCR, edit text.
wowerpoint
Turn one document into a kawaii NotebookLM slide deck. 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.
save-as-pdf
Reformat the current HTML design into a paginated, paper-ready PDF. The "Instant" export already gives the user a PDF at the design's native pixel size — this path is for when they want real pages.
Use this skill whenever the user wants to do anything with PDF files. This includes reading or extracting text/tables from PDFs, combining or merging multiple PDFs into one, splitting PDFs apart, rotating pages, adding watermarks, creating new PDFs, filling PDF forms, encrypting/decrypting PDFs, extracting images, and…