Back to Skills

batch-convert

Batch convert documents between multiple formats using a unified pipeline

190stars49forksUpdated 6/5/2026

Security Assessment

Medium Risk(60/100)

Detected risks:

Command Injection([SKILL.md] subprocess.run)
Security Score60/100

About batch-convert

The batch-convert skill is designed to streamline the process of converting large numbers of documents between various formats using a unified pipeline. By automating batch conversions, it addresses the common problem of manually handling multiple files with different formats, which can be time-consuming and prone to errors. This skill ensures consistent output, supports automatic format detection, and allows users to process hundreds of files simultaneously, making document conversion efficient and reliable for both individual users and organizational workflows.

The skill offers several key features and capabilities. It supports a wide range of formats including DOCX, PDF, Markdown (MD), HTML, XLSX, and PPTX, allowing conversions such as DOCX to PDF, PDF to Markdown, and HTML to PDF, among others. Users can specify source folders or individual files, choose target formats, and configure conversion options. The skill supports parallel processing to optimize performance and tracks progress throughout the conversion process. Its integration with MCP tools and compatibility with models like claude-sonnet-4, claude-opus-4, gpt-4, and gpt-4o ensures smooth interoperability in different AI environments.

Typical use cases include converting large sets of PDFs to editable Word documents for content editing, transforming Markdown files into multiple formats for publication, or compiling images into a single PDF report. Target users range from office professionals and content creators to developers and automation engineers who require efficient bulk document processing. By reducing repetitive manual tasks and ensuring format consistency, batch-convert is particularly valuable for teams managing diverse document workflows in both corporate and educational settings.

FAQ

How do I perform a batch conversion using this skill?

You can perform a batch conversion by specifying the source folder or files, selecting the desired target format(s), optionally configuring conversion options, and then executing the process. The skill will handle all files with progress tracking.

Which document formats are supported for conversion?

The skill supports DOCX, PDF, Markdown (MD), HTML, XLSX, and PPTX formats. Not all conversions between formats are supported, but common combinations like DOCX to PDF or MD to HTML are included.

Can I convert files recursively in subfolders?

Yes, the batch conversion method allows you to process files in subdirectories if you enable the recursive option when specifying the input directory.

Which AI models are compatible with batch-convert?

The recommended models are claude-sonnet-4 and claude-opus-4. It is also compatible with claude-3-5-sonnet, gpt-4, and gpt-4o.

Are there any limitations or requirements for using this skill?

The skill requires access to the MCP server and tools for batch conversion. It also relies on supported file formats and may raise an error if an unsupported format conversion is requested.

Install batch-convert

Download and extract the skill files to your .claude/skills/ directory.

Quick Setup:

  1. Copy the skill folder to .claude/skills/
  2. Claude will automatically detect and use the skill