# Document Converter Suite

> Convert local PDF, Office, Markdown, HTML, text, CSV, TSV, and JSON files with dependency-aware fallbacks; batch-convert folders; extract tables; fill templates; and perform focused PDF page operations. Use when Codex or Hermes needs editable document output and can accept best-effort semantic conversion rather than guaranteed pixel-perfect reproduction.

- **Type:** Skill
- **Install:** `agentstack add skill-rylaispirit-rylai-codex-hermes-skills-document-converter-suite`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [Rylaispirit](https://agentstack.voostack.com/s/rylaispirit)
- **Installs:** 0
- **Category:** [Data & Analytics](https://agentstack.voostack.com/c/data-and-analytics)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [Rylaispirit](https://github.com/Rylaispirit)
- **Source:** https://github.com/Rylaispirit/rylai-codex-hermes-skills/tree/main/skills/document-converter-suite

## Install

```sh
agentstack add skill-rylaispirit-rylai-codex-hermes-skills-document-converter-suite
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Document Converter Suite

Original portable workflow by Rylai.

Use the bundled scripts for deterministic local-file work. Keep source files unchanged and inspect every generated artifact.

## Start With A Dependency Check

```powershell
python scripts/rylai_convert.py doctor

The report distinguishes required Python support from optional routes provided by MarkItDown, Pandoc, LibreOffice, `pypdf`, `python-docx`, `python-pptx`, `openpyxl`, and `pdfplumber`.

## Convert One File

```powershell
python scripts/rylai_convert.py convert input.docx output.md
python scripts/rylai_convert.py convert notes.md notes.docx
python scripts/rylai_convert.py convert workbook.xlsx workbook.pdf

Add `--overwrite` only after checking that replacing the destination is intended.

## Convert A Folder

```powershell
python scripts/rylai_convert.py batch source output --to md --recursive
python scripts/rylai_convert.py batch source output --to pdf --include docx --include pptx

The batch command preserves relative paths and reports every failed file.

## Focused Utilities

PDF page operations:

```powershell
python scripts/rylai_pdf_pages.py info report.pdf
python scripts/rylai_pdf_pages.py extract report.pdf excerpt.pdf --pages 1,3-5
python scripts/rylai_pdf_pages.py merge combined.pdf part-a.pdf part-b.pdf
python scripts/rylai_pdf_pages.py split report.pdf split-pages
python scripts/rylai_pdf_pages.py rotate report.pdf rotated.pdf --pages all --degrees 90

Table extraction:

```powershell
python scripts/rylai_tables.py data.xlsx table.csv --sheet Summary
python scripts/rylai_tables.py report.pdf table.md --table 2

Template filling:

```powershell
python scripts/rylai_template_fill.py template.docx filled.docx --values values.json
python scripts/rylai_template_fill.py template.md filled.md --set project=Rylai --set status=Ready

Read `references/routes.md` when choosing between conversion engines or explaining limitations.

## Operating Rules

- Resolve scripts relative to this skill folder.
- Accept local files only; do not download a URL and convert it without explicit user approval.
- Never execute macros, embedded programs, or document attachments.
- Treat OCR as a separate step. A scanned PDF may contain no extractable text.
- Prefer semantic extraction for editing and LibreOffice or Pandoc routes for format conversion.
- Do not promise exact fonts, pagination, animation, chart, formula, or layout preservation.
- Use a dedicated format skill when visual fidelity or advanced editing is the primary requirement.
- Report the selected route, missing dependency, and any known loss in the final answer.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [Rylaispirit](https://github.com/Rylaispirit)
- **Source:** [Rylaispirit/rylai-codex-hermes-skills](https://github.com/Rylaispirit/rylai-codex-hermes-skills)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-rylaispirit-rylai-codex-hermes-skills-document-converter-suite
- Seller: https://agentstack.voostack.com/s/rylaispirit
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.