Vellum Prep

Convert markdown manuscripts into Vellum-ready .docx files via pandoc.

9|2|Updated Feb 4, 2026
One-click install
npx skills add https://github.com/cdeistopened/content-os --skill vellum-prep
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Vellum Prep
Source: https://github.com/cdeistopened/content-os/tree/main/skills/productivity/vellum-prep
Command: npx skills add https://github.com/cdeistopened/content-os --skill vellum-prep

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pandoc, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the conversion of raw markdown manuscripts into a clean, Vellum-ready format, saving significant time and effort in the book production workflow.

Core Features & Use Cases

  • Automated Formatting: Cleans OCR artifacts, normalizes chapter headings, and converts section breaks for Vellum import.
  • Programmatic Cleanup: Performs text transformations without consuming AI tokens.
  • Use Case: You have a markdown file generated from an OCR scan of an old book. Use this Skill to clean up the text, format chapters correctly, and prepare it for import into Vellum for professional typesetting.

Quick Start

Run the vellum_prep.py script on your manuscript.md file to prepare it for Vellum.

Frequently Asked Questions about Vellum Prep

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I format a markdown manuscript for Vellum import?

To format a markdown manuscript for Vellum import, run the vellum_prep.py script to automatically normalize chapter headings, clean up OCR artifacts, and convert the file to a Vellum-ready .docx format using pandoc.

What is the best way to clean up OCR artifacts in a book manuscript?

Cleaning up OCR artifacts in a book manuscript is handled programmatically by this Skill's script, which performs text transformations to remove scan errors and normalize formatting without consuming any AI tokens.

Do I need pandoc to convert markdown to a Vellum-ready format?

Yes, you need pandoc installed to convert markdown to a Vellum-ready format, as the script relies on it to produce the final .docx file required for importing into Vellum book software.

Can I use Python to automate Vellum preparation for OCR scans?

You can use Python to automate Vellum preparation for OCR scans by running the included Python 3 script, which programmatically cleans text and converts section breaks for professional typesetting.

Does converting markdown to docx for Vellum use AI tokens for text cleanup?

Converting markdown to docx for Vellum does not use AI tokens for text cleanup, because the Skill performs programmatic text transformations to handle OCR artifacts and formatting rules locally.

Why are my chapter headings not normalizing when preparing a markdown file for Vellum?

Chapter headings may not normalize when preparing a markdown file for Vellum if the vellum_prep.py script is not run correctly or if Python 3 and pandoc dependencies are not properly installed in your environment.