book-converter

80 / 100 · Low risk

Fine to try. Some of what it can do is expected: a coding skill usually runs build and test commands.

By bmad-labs/skills (GitHub) · coding · 19 stars · scanned at commit c636fe5

Convert EPUB books (.epub) to high-quality formatted Markdown using pandoc and AI-assisted formatting. Use when the user provides an EPUB file path and wants it converted to professionally formatted Markdown (ebook to markdown, epub to md). This skill handles the complete workflow from EPUB extraction through AI-driven content formatting, including joining split paragraphs, correcting code blocks, standardizing headers, and creating a proper Table of Contents.

Works with any agent that supports SKILL.md skills.

What this skill can do

Runs commands on your computer

The author does not mention this. Expected for a coding skill.

Found in 6 places.

skills/book-converter/SKILL.md, line 35python3 <skill-dir>/scripts/convert_book.py "/path/to/book.epub" # -> ./books/<book-name>/
skills/book-converter/SKILL.md, line 57python3 <skill-dir>/scripts/analyze_structure.py <book-dir>
skills/book-converter/SKILL.md, line 121python3 <skill-dir>/scripts/merge_book.py <book-dir>

Show 3 more

skills/book-converter/scripts/convert_book.py, line 84subprocess.run(cmd, check=True, capture_output=True, text=True)
skills/book-converter/scripts/convert_book.py, line 94except subprocess.CalledProcessError as e:
skills/book-converter/scripts/convert_book.py, line 187content = content.replace('{DATE}', subprocess.run(['date', '+%Y-%m-%d'], capture_output=True, text=True).stdout.strip())

Downloads and installs other software

The author does not mention this.

Found in 2 places.

skills/book-converter/scripts/convert_book.py, line 22macOS: brew install pandoc
skills/book-converter/scripts/convert_book.py, line 23Linux: sudo apt install pandoc (or dnf/pacman install pandoc)

Install

Paste this into your terminal. It downloads exactly the version we scanned, not whatever is newest.

if [ -e ~/.agents/skills/'book-converter' ] || [ -L ~/.agents/skills/'book-converter' ]; then echo 'A skill folder named book-converter already exists — not replacing it' >&2; false; else d=$(mktemp -d) && git clone --quiet --filter=blob:none --no-checkout 'https://github.com/bmad-labs/skills' "$d" && git -C "$d" checkout --quiet 'c636fe5b40f0f6a5fb1fd3a14e7735bd2428eef5' -- 'skills/book-converter' && mkdir -p ~/.agents/skills && cp -R "$d"/'skills/book-converter' ~/.agents/skills/'book-converter' && rm -rf "$d"; fi

Codex reads ~/.agents/skills directly. For Claude Code, Cursor, Copilot, Gemini CLI, Antigravity or OpenCode, also link it. For Claude Code: ln -s ~/.agents/skills/'book-converter' ~/.claude/skills/'book-converter' (other agents: ~/.cursor/skills, ~/.copilot/skills, ~/.gemini/skills, ~/.gemini/config/skills, ~/.config/opencode/skills). Or install through the finder skill, which does both.

Badge for your README

The badge for bmad-labs/skills shows the score of its lowest-scoring skill.

SkillTrust badge for bmad-labs/skills

[![SkillTrust](https://zalavijaysinh.github.io/skilltrust/badges/bmad-labs/skills.svg)](https://zalavijaysinh.github.io/skilltrust/repos/bmad-labs/skills/)

Score history

Date	Version	Score
2026-11-11	`c636fe5`	80
2026-11-08	`c965156`	100