菜单
Produces a typeset PDF artifact from any source file — code, Markdown, HTML, chat JSON, or structured Dojo files (specs, ADRs, skills). Use when: "export this to PDF", "generate a PDF of this file", "make a PDF from this".
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Produces a dispatch plan — isolation model, agent count, sequencing, and model assignments — for multi-agent parallel work. Use when: "dispatch agents in parallel", "run multiple tracks simultaneously", "plan parallel agent strategy", "should this be foreground or background".
Produces a structured background-dispatch handoff — task description, output contract, success criteria, and timeout — so long-running work completes without blocking the user. Use when: "run this in the background", "dispatch agent for long task", "I need this to run async", "parallel agent dispatch".
Routes health-audit findings to the correct execution path — main thread, foreground fix, or parallel agent waves. Use when health-audit findings need to be sorted by effort and dispatched as agent waves.
Produces a granular todo list where each item maps to one discrete deliverable or decision point, maintained at real-time accuracy throughout execution. Use when: 'what is the status', 'too many items in the list', 'simplify the progress tracking', 'long todo list'.
Conductor agent pattern that decomposes complex tasks, dispatches specialist sub-agents, manages dependencies, and synthesizes results into a unified deliverable. Use when: 'coordinate multiple specialist agents', 'orchestrate a complex multi-phase task', 'run a conductor pattern across agents', 'this task needs live agent coordination', 'decompose and dispatch to sub-agents'.
Selects the correct multi-agent orchestration pattern for a task using an 11-signal selection matrix. Use when choosing which orchestration pattern fits a multi-agent task.
| name | pdf-export |
| description | Produces a typeset PDF artifact from any source file — code, Markdown, HTML, chat JSON, or structured Dojo files (specs, ADRs, skills). Use when: "export this to PDF", "generate a PDF of this file", "make a PDF from this". |
| model | sonnet |
| category | publishing |
| triggers | ["export this to PDF","generate a PDF of this file","make a PDF from this"] |
| tier | 1 |
| agents | ["primary"] |
| tool_dependencies | ["file_system"] |
| inputs | [{"name":"source_path","type":"string","description":"Path or glob pattern to the source file(s) to export","required":true},{"name":"output_path","type":"string","description":"Output path for the generated PDF file","required":false},{"name":"theme","type":"string","description":"Typography theme — light or dark","required":false}] |
| outputs | [{"name":"pdf_artifact","type":"ref","format":"cas-ref","description":"Typeset PDF file written to the specified output path"}] |
Version: 0.1.0 Created: 2026-04-08 Author: Dojo Genesis Purpose: Convert any file into a beautifully typeset PDF using Pretext's Canvas-based typography engine for precise text measurement and layout.
A PDF is a permanent artifact. Unlike a terminal dump or a browser render, a PDF says "this was worth preserving." Pretext-powered export treats every character with the same care a typesetter would — measuring widths on a real Canvas, computing line breaks honestly, and placing glyphs with sub-pixel precision. The result: PDFs that are not just functional, but beautiful.
Determine the files to export and their types. Supported formats:
| Format | Renderer | Features |
|---|---|---|
.ts, .js, .go, .py, .rs, etc. | Code | Syntax highlighting via Shiki, line numbers, theme support |
.md | Markdown | Heading hierarchy, code blocks, tables, links as footnotes |
.html | HTML | DOM-faithful rendering, CSS preservation |
| Chat JSON | Chat | Bubble layout, Pretext shrink-wrap, disposition typography |
SKILL.md, ADR-*.md | Structured | Section-aware layout, metadata headers, cross-references |
Choose typography settings or accept defaults:
Use the MCP tool pretext-pdf.export or the slash command:
/export-pdf path/to/file.md --output ./exports/
/export-pdf src/**/*.ts --output ./code-review.pdf --bundle
/export-pdf chat-export.json --theme dark
Check the generated PDF for:
The PDF is written to the specified output path. Share it, archive it, or upload it via a file storage connector.
## headings; code breaks every 60 lines.--theme dark for code-centric exports.Single file, default settings, quick output:
/export-pdf README.md
Multiple source files with dark theme and line numbers:
/export-pdf src/lib/**/*.ts --bundle --theme dark --line-numbers
DojoChat conversation with Pretext typography:
/export-pdf conversation.json --renderer chat --disposition-typography
All skills in a plugin as a reference manual:
/export-pdf plugins/agent-orchestration/skills/*/SKILL.md --bundle --toc
Scenario: Export the handoff protocol skill as a distributable PDF for a new team member.
plugins/agent-orchestration/skills/handoff-protocol/SKILL.md## headingsexports/handoff-protocol.pdf (12 pages, 45KB)pdf-typography — Fine-tune Pretext typography settings for specific content typeshandoff-protocol (agent-orchestration) — Export handoff packages as PDFsspecification-writer (specification-driven-development) — Generate specs then export as PDFstatus-writing (system-health) — Export STATUS.md as formatted PDF reports.pdf file written to the specified --output path (default: ./exports/<source-basename>.pdf)Scenario 1: "Export this ADR as a PDF for the client" → reads ADR-007.md, applies structured renderer with Inter 11pt, generates exports/ADR-007.pdf with section headings and a ToC.
Scenario 2: "Make a PDF of all the TypeScript source files in src/lib" → bundles src/lib/**/*.ts with dark theme, syntax highlighting, line numbers; outputs exports/src-lib-bundle.pdf.