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 agentmods add skills/gausoft/markpdf-skill/markpdfnpx skills add gausoft/markpdf-skill --skill markpdfgit clone --depth 1 https://github.com/gausoft/markpdf-skillWhat 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.00056 | $0.02419 |
| Opus 5 | $0.00028 | $0.01210 |
| Sonnet 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 2d 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.
- 2d 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 3mo ago), licensed MIT. It adds 56 tokens to every session and 2,419 once invoked, about $0.0003 per session on Opus 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
cv-update-review
Run a confirmation-gated CV update workflow for Word CV documents: set up a reusable profile, scan configured local activity sources plus public evidence such as PubMed through NCBI E-utilities and configured website/RSS feeds, prepare a CV update packet, ask the user to approve completed/public/accepted items, create…
cite-them-all
Academic reference agent that identifies claims needing citations, searches PubMed/bioRxiv/medRxiv via MCP tools, and adds properly formatted references to Markdown manuscripts.
md-to-xhs-cards
Convert a Markdown file into Xiaohongshu (Little Red Book) image cards with deterministic layout, preserving markdown structure order and embedded local images. Use when users ask for direct MD-to-XHS card conversion, markdown poster cards, 图文卡片拆分, or preserving original markdown text/format in social image outputs.
illustration-production
Use when the user asks to create, revise, review, prompt, art-direct, style-match, or make consistent BaseCamp illustrations and image-generation assets. Trigger for requests mentioning illustration prompts, image prompts, visual style guide, house style, style lane, taste, art direction, poster, cover art, comic…
manuscript-production
Use this skill when helping produce a scholarly, clinical, or research manuscript from idea through submission. Trigger for manuscript planning, source packet creation, article digestion, atomic claim extraction, evidence matrices, outlines, drafting, claim calibration, reference audits, reviewer responses, coauthor…
report
Render a research, documentation, or analysis report as a designed HTML document using the project template, instead of emitting a raw .md file. Use whenever the user asks for a report, analysis, deep-dive, investigation, postmortem, summary, write-up, briefing, or any structured long-form (>500 words, multiple…