How do I install the Convert Doc skill?

Run npx skillmds@latest add carlvellotti/convert-doc in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Convert Doc safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Convert Doc?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Convert Doc free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Convert Doc?

carlvellotti (@carlvellotti) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Convert Doc by carlvellotti — Agent Skill

Name: Convert Doc
Rating: 4.2 (5 reviews)
Author: carlvellotti

Convert Doc

Convert documents between formats using pandoc with custom styling. Supports markdown to PDF, HTML, Word, and more. Use when the user says 'convert to PDF', 'convert doc', 'export as PDF', 'make a PDF', 'convert doc <file>'.

carlvellotti 7accfc4 4 files · 7.3 KB Updated Sep 10, 2026

File contents

Convert Document

Convert a document between formats using pandoc with custom styling from this skill's templates.

Style Templates

Three styles are available in .agents/skills/convert-doc/templates/:

Style	File	Description
Professional	`clean-report.css`	Clean sans-serif, minimal design, business-appropriate
Fun	`fun.css`	Bright colors, rounded corners, playful feel
Whimsical	`whimsical.css`	Elegant serif, airy spacing, soft earth tones

Default: Professional (clean-report.css) if the user does not specify a style.

Process

Identify the source file and target format. If the user doesn't specify a target format, default to PDF.
Ask which style the user wants. Present the three options as a lettered menu in the thread:
- A) Professional — clean and business-appropriate
- B) Fun — bright and playful
- C) Whimsical — elegant serif, soft earth tones
Tell the user they can reply with just the letter. If the user already specified a style in their request, skip this step. If the user declines to choose, use Professional.
Read the chosen CSS template from .agents/skills/convert-doc/templates/.
Run pandoc with the template and these default options:
- --standalone (always)
- --css=.agents/skills/convert-doc/templates/<chosen-style>.css (for HTML and PDF output)
- --pdf-engine=wkhtmltopdf or --pdf-engine=weasyprint (for PDF, use whichever is available)
- --toc (include table of contents for documents with 3+ headings)
- --metadata title="<document title>" (extract from first H1 or filename)
Output the converted file in the same directory as the source, with the new extension.

Supported Conversions

Markdown → PDF (default)
Markdown → HTML (styled)
Markdown → Word (.docx)
HTML → PDF
HTML → Markdown

Notes

Pandoc must be installed (brew install pandoc)
For PDF output, a PDF engine must be available (weasyprint or wkhtmltopdf). If neither is installed, ask the user for permission to install one (brew install weasyprint), or offer a styled HTML file instead.
The CSS templates in this folder control the visual styling of HTML and PDF output

---name: convert-docdescription: Convert documents between formats using pandoc with custom styling. Supports markdown to PDF, HTML, Word, and more. Use when the user says 'convert to PDF', 'convert doc', 'export as PDF', 'make a PDF', 'convert doc <file>'.---# Convert DocumentConvert a document between formats using pandoc with custom styling from this skill's templates.## Style TemplatesThree styles are available in `.agents/skills/convert-doc/templates/`:| Style | File | Description ||-------|------|-------------|| **Professional** | `clean-report.css` | Clean sans-serif, minimal design, business-appropriate || **Fun** | `fun.css` | Bright colors, rounded corners, playful feel || **Whimsical** | `whimsical.css` | Elegant serif, airy spacing, soft earth tones |**Default:** Professional (`clean-report.css`) if the user does not specify a style.## Process1. Identify the source file and target format. If the user doesn't specify a target format, default to PDF.2. **Ask which style the user wants.** Present the three options as a lettered menu in the thread: - **A)** Professional — clean and business-appropriate - **B)** Fun — bright and playful - **C)** Whimsical — elegant serif, soft earth tones Tell the user they can reply with just the letter. If the user already specified a style in their request, skip this step. If the user declines to choose, use Professional.3. Read the chosen CSS template from `.agents/skills/convert-doc/templates/`.4. Run pandoc with the template and these default options: - `--standalone` (always) - `--css=.agents/skills/convert-doc/templates/<chosen-style>.css` (for HTML and PDF output) - `--pdf-engine=wkhtmltopdf` or `--pdf-engine=weasyprint` (for PDF, use whichever is available) - `--toc` (include table of contents for documents with 3+ headings) - `--metadata title="<document title>"` (extract from first H1 or filename)5. Output the converted file in the same directory as the source, with the new extension.## Supported Conversions- Markdown → PDF (default)- Markdown → HTML (styled)- Markdown → Word (.docx)- HTML → PDF- HTML → Markdown## Notes- Pandoc must be installed (`brew install pandoc`)- For PDF output, a PDF engine must be available (weasyprint or wkhtmltopdf). If neither is installed, ask the user for permission to install one (`brew install weasyprint`), or offer a styled HTML file instead.- The CSS templates in this folder control the visual styling of HTML and PDF output

Frequently asked questions