# DOCX

> Create, inspect, edit, and verify Word DOCX files with python-docx, including Markdown conversion, text replacement, metadata inspection, and optional PDF render.

- Skill: `rylaispirit/docx` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add rylaispirit/docx`
- Raw SKILL.md: https://api.skillmd.com/api/skills/rylaispirit/docx/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: Rylaispirit (https://skillmd.com/u/rylaispirit)
- Updated: 2026-09-21
- Page: https://skillmd.com/skills/rylaispirit/docx

---


# Rylai DOCX

This is an original Rylai Codex-Hermes-Claude workflow. Use the open-source
`python-docx` package for document work and LibreOffice only when local
rendering is useful.

## Runtime

- Required for the bundled script: Python 3 and `python-docx`.
- Optional: LibreOffice (`soffice`) for PDF rendering.
- Resolve `scripts/docx_tool.py` relative to this skill folder.
- Do not install packages unless the user approves installation.
- Set new or modified document author metadata to `Rylai` unless the user
  explicitly requests another author.

## Workflow

1. Inspect source files and identify the requested document structure.
2. Keep instructions out of the final document body.
3. Create a new output path instead of overwriting the user's source.
4. Reopen the saved DOCX to verify that it is readable.
5. For layout-sensitive work, render to PDF with LibreOffice and inspect the
   result.

## Bundled CLI

Create a styled DOCX from simple Markdown:

```bash
python scripts/docx_tool.py create input.md output.docx --title "Report"
```

Supported Markdown includes headings, paragraphs, bullet lists, numbered
lists, block quotes, simple emphasis, inline code, and pipe tables.

Inspect structure and metadata:

```bash
python scripts/docx_tool.py inspect output.docx
python scripts/docx_tool.py inspect output.docx --text
```

Replace text while keeping the source unchanged:

```bash
python scripts/docx_tool.py replace input.docx output.docx \
  --set "{{client}}=Rylai Studio" \
  --set "{{date}}=2026-08-09"
```

Render to PDF when LibreOffice is available:

```bash
python scripts/docx_tool.py render output.docx rendered
```

## Quality Rules

- Preserve the visual conventions of an existing document unless the user
  asks for a redesign.
- Use real heading styles instead of visually enlarged body paragraphs.
- Keep tables readable and avoid squeezing too many columns onto one page.
- Verify metadata, paragraph count, table count, and extracted text with the
  `inspect` command.
- Report that visual verification was skipped when LibreOffice is unavailable.