EPUB to Markdown

Convert EPUB books into an AI-ready Markdown library with a first-read META.md navigation index, per-chapter Markdown files, and extracted images. Use when t...

Security Scan

The skill's code, instructions, and requirements are consistent with its stated purpose (converting EPUBs to Markdown); it doesn't request secrets, network endpoints, or unrelated system access.

Purpose & Capability

Name/description match the included script and docs. The only artifacts are a conversion script and reference docs; nothing asks for unrelated credentials, binaries, or system access.

Instruction Scope

SKILL.md instructs running the bundled script on a local .epub, explains output layout, and warns about overwrite behavior. The script only reads the provided EPUB and writes a local output directory; it does not read other system files or send data externally.

Install Mechanism

This is an instruction-only skill that includes a Python script. The script declares Python dependencies in inline metadata and relies on the 'uv run' behavior to install them on first use (which will pull packages from PyPI). That is expected for a Python-based converter but does imply runtime package installation from the network.

Credentials

No environment variables, credentials, or config paths are requested. The script operates on files provided by the user and writes output locally.

Persistence & Privilege

The skill does not set always:true, does not modify other skills or global agent settings, and only writes to the chosen output directory. It only removes an existing output directory when '--overwrite' is explicitly passed.

Assessment

This skill appears coherent and implements an EPUB→Markdown converter. Before installing/running: (1) review the included convert.py if you want to verify behavior (it is bundled and readable), (2) know that 'uv run' will install Python dependencies from PyPI at runtime (network access), (3) the script writes files beside the EPUB or to an output directory you choose — avoid running it on sensitive system paths and do not pass an important directory unless you explicitly want to overwrite it with --overwrite, and (4) DRM‑protected books won't be converted. If you need offline-only installs or want to vet third-party packages, audit the listed dependencies (ebooklib, beautifulsoup4, markdownify) before use.

EPUB to Markdown Conversion

Convert an EPUB into a structured Markdown workspace using the bundled script.

Run

uv run scripts/convert.py <path/to/book.epub> [output_dir]

• Omit output_dir to write beside the EPUB as {epub_stem}/.
• If output_dir already exists, the script stops instead of deleting it.
• Pass --overwrite only when the user explicitly wants to replace an existing generated directory.
• Dependencies are declared inline in the script, so uv run installs them automatically on first use.

Output

{output_dir}/
├── META.md
├── images/
└── chapters/
    ├── 001_{slug}.md
    ├── 002_{slug}.md
    └── ...

• Read META.md first. It contains book metadata, total chapter and word counts, and a chapter index pointing at the generated files.
• Read files in chapters/ only when the user asks about specific content.

Reply Format

After a successful conversion, report:

✅ Conversion complete

Title   : {title}
Authors : {authors}
Chapters: {total_chapters}
Words   : {total_words}
Output  : {output_dir}/

If chapter titles look wrong, the TOC is sparse, or the user needs edge-case behavior details, read references/reference.md.