How do I install the Qmd Converter skill?

Run npx skillmds@latest add tomevault-io/qmd-converter 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 Qmd Converter safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Qmd Converter?

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 Qmd Converter free to use?

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

Who published Qmd Converter?

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

Qmd Converter by tomevault-io — Agent Skill

Name: Qmd Converter
Author: tomevault-io

File contents

Quarto Book Converter

This skill converts PDF or EPUB files into a structured Quarto book project (specifically targeting the mybook/ directory). It handles text extraction, chapter splitting, image management, and configuration updates.

Workflow

Check Environment: The script relies on pymupdf, ebooklib, beautifulsoup4, pyyaml, and html2text. ALWAYS check if these are installed in the current pixi environment before running the script.

If you are unsure or if the user hasn't explicitly set up the environment, run:
```
pixi add pymupdf ebooklib beautifulsoup4 pyyaml html2text
```
Execute Conversion: Run the python conversion script. Assume the script is located at scripts/convert_to_book.py relative to this skill.
```
pixi run python <path-to-skill>/scripts/convert_to_book.py <input_file_path> --output-dir mybook
```
(Replace <input_file_path> with the actual file path provided by the user)
Verify Output:
- List files in mybook/ to confirm .qmd chapters were created.
- Check mybook/images/ for extracted images.
- Read mybook/_quarto.yml to confirm the chapters list was updated.

Usage Guidelines

Input Files: Ensure the user provides a valid path to a .pdf or .epub file.
Chapter Splitting:
- EPUB: Splits automatically based on internal structure.
- PDF: Splits based on the Table of Contents (Outline). If no TOC exists, it creates a single large chapter.
Images: Images are extracted to mybook/images/ and referenced in the Markdown as ![](images/filename.ext).

Troubleshooting

"ModuleNotFoundError": Run the pixi add ... command listed in Step 1.
"No chapters generated": The PDF might be image-only (scanned) without OCR, or the EPUB structure is non-standard.

Converted and distributed by TomeVault — claim your Tome and manage your conversions.

---name: qmd-converterdescription: Convert PDF/EPUB documents into multi-chapter Quarto book projects using Pixi. Use when the user asks to "Convert this PDF/EPUB to a Quarto book" or "Make a qmd book from this file". Use when this capability is needed.---# Quarto Book ConverterThis skill converts PDF or EPUB files into a structured Quarto book project (specifically targeting the `mybook/` directory). It handles text extraction, chapter splitting, image management, and configuration updates.## Workflow1. **Check Environment**: The script relies on `pymupdf`, `ebooklib`, `beautifulsoup4`, `pyyaml`, and `html2text`. **ALWAYS** check if these are installed in the current `pixi` environment before running the script. If you are unsure or if the user hasn't explicitly set up the environment, run: ```bash pixi add pymupdf ebooklib beautifulsoup4 pyyaml html2text ```2. **Execute Conversion**: Run the python conversion script. Assume the script is located at `scripts/convert_to_book.py` relative to this skill. ```bash pixi run python <path-to-skill>/scripts/convert_to_book.py <input_file_path> --output-dir mybook ``` *(Replace `<input_file_path>` with the actual file path provided by the user)*3. **Verify Output**: - List files in `mybook/` to confirm `.qmd` chapters were created. - Check `mybook/images/` for extracted images. - Read `mybook/_quarto.yml` to confirm the `chapters` list was updated.## Usage Guidelines- **Input Files**: Ensure the user provides a valid path to a `.pdf` or `.epub` file.- **Chapter Splitting**: - **EPUB**: Splits automatically based on internal structure. - **PDF**: Splits based on the Table of Contents (Outline). If no TOC exists, it creates a single large chapter.- **Images**: Images are extracted to `mybook/images/` and referenced in the Markdown as `![](images/filename.ext)`.## Troubleshooting- **"ModuleNotFoundError"**: Run the `pixi add ...` command listed in Step 1.- **"No chapters generated"**: The PDF might be image-only (scanned) without OCR, or the EPUB structure is non-standard.---> Converted and distributed by [TomeVault](https://tomevault.io/claim/partrita) — claim your Tome and manage your conversions.

Frequently asked questions

Qmd Converter