Agent skill

DOCX

by holon-run in holon-run/holon

Create, inspect, edit, render, and validate Word documents with local open-source tools while preserving source files and making unsupported OOXML features explicit.

Apache-2.0Auto-check passedDocuments & Office

Install DOCX

skills CLI
$ npx skills add holon-run/holon --skill docx -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install holon-run/holon docx --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/holon-run/holon.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/docx .claude/skills/docx && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
docx
GitHub stars
153
Token cost
~986 tokens
SKILL.md length
506 words
Files
1
Skills in repo
13
Repo updated
First seen
Licence
Apache-2.0

At a glance

Create, inspect, edit, render, and validate Word documents with local open-source tools while preserving source files and making unsupported OOXML features explicit.

  • Works in 8 steps: Confirm the document type, audience,… → Inspect an existing package before… → Plan the heading hierarchy, sections,… → …
  • Tasks that involve Word documents
  • SKILL.md covers Summary, When To Use, Safety Boundaries and Backend Selection, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

DOCX is an agent skill from holon-run/holon. Create, inspect, edit, render, and validate Word documents with local open-source tools while preserving source files and making unsupported OOXML features explicit.

Its SKILL.md is about 990 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Documents & Office, covering Word documents. It works with Microsoft Word and LibreOffice. The repository describes itself as: An agent workbench for ongoing work: preserve goals and progress, connect events and schedules, and resume when the next condition is met. The licence is Apache-2.0.

When your agent uses it

  • Tasks that involve Word documents

Example prompts

  • “/docx”

Requirements

  • Python 3

Workflow steps

8 steps, taken from the first numbered list in SKILL.md.

  1. Confirm the document type, audience, language, page or word target, style
  2. Inspect an existing package before editing. Record styles, sections, headers
  3. Plan the heading hierarchy, sections, tables, figures, references, and page
  4. Select a backend and restrict changes to features it represents reliably.
  5. Write a new output file. Avoid raw OOXML edits unless the relationship and
  6. Reopen the result and verify expected headings, paragraph and table counts,
  7. Render to PDF or pages when possible. Inspect page breaks, widows and orphans,
  8. Sample-check important facts, citations, figures, and tables against source

What it can do on your machine

Read from SKILL.md and the folder at commit 671bd7a. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

DOCX loads about 986 tokens when it runs. Until then it costs about 43 tokens; SKILL.md has 506 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~43
When it runs · the whole SKILL.md, loaded when a task matches
~986

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from holon-run/holon at commit 671bd7a, republished under its Apache-2.0 licence (© holon-run). 506 words, ~986 tokens.

Download SKILL.mdSave it as .claude/skills/docx/SKILL.md (or your agent's skills folder).
name
docx
description
Create, inspect, edit, render, and validate Word documents with local open-source tools while preserving source files and making unsupported OOXML features explicit.

DOCX

Summary

Use this skill for .docx reports, memos, letters, meeting notes, proposals, and other word-processing documents. Prefer python-docx for common document structures and use an available local LibreOffice renderer for pagination and visual review.

This skill does not imply complete support for every Word or OOXML feature.

When To Use

  • Creating a structured document from notes, Markdown, or source material
  • Inspecting paragraphs, headings, tables, images, styles, and metadata
  • Making bounded edits to a conventional DOCX
  • Converting a DOCX to PDF for review
  • Checking document structure, pagination, and consistency

Safety Boundaries

  • Preserve the source and write a new .docx by default.
  • Treat macros, links, fields, embedded files, OLE objects, comments, revisions, and custom XML as untrusted input.
  • Never execute macros, update external fields, open embedded objects, or follow document links automatically.
  • Ask before resolving external assets or uploading content.
  • Do not claim lossless editing for content controls, complex fields, tracked changes, equations, signatures, embedded objects, or package parts not modeled by the selected library.

Use read-only analysis or create a new document when preserving unsupported features is material to the request.

Backend Selection

  • Use python-docx for common paragraphs, styles, lists, sections, tables, headers, footers, and images.
  • Use LibreOffice headless only when installed and approved as a local renderer or converter. Record the actual backend.
  • Use package-level XML inspection for risk inventory or verification, not as a default editing strategy.

Do not silently install Python packages, fonts, LibreOffice, or converters.

Show full SKILL.md (267 more words)Show less

Workflow

  1. Confirm the document type, audience, language, page or word target, style guide, template, citations, output path, and whether comments or revisions must be preserved.
  2. Inspect an existing package before editing. Record styles, sections, headers and footers, tables, fields, links, comments, revisions, macros, signatures, embedded objects, and unknown parts.
  3. Plan the heading hierarchy, sections, tables, figures, references, and page furniture before generation.
  4. Select a backend and restrict changes to features it represents reliably.
  5. Write a new output file. Avoid raw OOXML edits unless the relationship and namespace effects are fully understood.
  6. Reopen the result and verify expected headings, paragraph and table counts, relationships, images, sections, headers, and footers.
  7. Render to PDF or pages when possible. Inspect page breaks, widows and orphans, clipped tables, heading placement, list numbering, headers, footers, and font substitution.
  8. Sample-check important facts, citations, figures, and tables against source material.

Quality Rules

  • Use semantic styles rather than formatting every paragraph independently.
  • Maintain a coherent heading hierarchy and consistent spacing.
  • Keep tables within page bounds and repeat header rows when appropriate.
  • Do not fabricate quotations, citations, legal language, or factual claims.
  • Record unresolved comments, revisions, fields, or links that remain.
  • Treat automatic tables of contents and fields as needing an actual update backend; writing field instructions alone does not prove displayed values.

Delivery

Report the output path, whether the source was unchanged, backend and fonts used, structural and rendered checks, citation or data sampling, and any impact on comments, revisions, fields, links, macros, signatures, or unsupported OOXML features. If rendering was unavailable, state that pagination was not verified.

© holon-run, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/docx of holon-run/holon.

Open the folder on GitHubat commit 671bd7a

Compare with similar skills

DOCX next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

DOCX compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
DOCX this skillholon-run/holon153—~986Automated safety check: PassApache-2.0
DOCX ToolkitXiaomiMiMo/MiMo-Code14k—~2.4kAutomated safety check: PassApache-2.0
Word DOCX ToolkitNousResearch/hermes-agent252k—~2.6kAutomated safety check: PassMIT
DOCXguyi-a/pi-ling106—~1.1kAutomated safety check: PassMIT
Z Md To Wordtjxj/z-skills546—~815Automated safety check: PassNone
Fill ProtocolAperivue/medsci-skills329—~1.7kAutomated safety check: PassMIT

Similar skills

  • DOCX Toolkit

    XiaomiMiMo/MiMo-Code

    Produces, edits and reads Microsoft Word files through python-docx and lxml, with a decision table for picking the lightest workflow for a given task.

    14k GitHub stars~2.4k tokensUpdated 5 days ago
    Documents & OfficeAuto-check passed
  • Word DOCX Toolkit

    NousResearch/hermes-agent

    Creates, reads, edits and templates Word .docx files with python-docx scripts, including tracked changes, comments, tables of contents and health checks.

    252k GitHub stars~2.6k tokensUpdated today
    Documents & OfficeAuto-check passed
  • DOCX

    guyi-a/pi-ling

    Word 文档(.docx)的日常处理:md → docx(生成简历/报告)、docx → PDF/图片(分享预览)、.doc → .docx(老格式升级)。触发场景:用户说"生成 Word 版" / "做份 Word 简历" / "把这份报告转 Word" / "这份 .doc 打不开" / "docx 转 PDF" 等。读 docx 内容走 agent 已有的…

    106 GitHub stars~1.1k tokensUpdated 22 days ago
    Documents & OfficeAuto-check passed
  • Z Md To Word

    tjxj/z-skills

    Convert local Markdown files into Word documents. An agent skill from tjxj/z-skills.

    546 GitHub stars~815 tokensUpdated 16 days ago
    Documents & OfficeAuto-check passed
  • Fill Protocol

    Aperivue/medsci-skills

    A skill your agent uses when an institutional Word form (.doc/.docx IRB protocol, ethics application, grant template) must be filled without breaking its styles, tables, fonts or page layout.

    329 GitHub stars~1.7k tokensUpdated 3 days ago
    Documents & OfficeAuto-check passed
  • Liteparse

    Prismer-AI/PrismerCloud

    Parse local document files into LLM-ready content on the daemon itself — PDFs → Markdown / structured JSON (with bounding boxes) / page screenshots via the bundled lit CLI.

    1.6k GitHub stars~2.1k tokensUpdated 8 days ago
    Documents & OfficeAuto-check passed

More from holon-run/holon

All 13 skills in this repo
  • Video Production

    holon-run/holon

    Assemble existing local images, videos, audio and subtitles into preview/final videos with FFmpeg, technical QC and provenance.

    153 GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • GitHub Issue Solve

    holon-run/holon

    Solve a GitHub issue by collecting context, implementing a fix, and opening or updating a pull request.

    153 GitHub stars~912 tokensUpdated today
    Auto-check passed
  • GitHub PR Fix

    holon-run/holon

    Fix a GitHub pull request by addressing feedback or CI failures, pushing changes, and publishing replies.

    153 GitHub stars~1k tokensUpdated today
    Auto-check passed
  • Code Health Audit

    holon-run/holon

    Audit code-health and technical-debt signals with evidence, rank proportionate interventions from focused cleanup to broad coordinated refactors, and draft implementation-ready plans without…

    153 GitHub stars~1.3k tokensUpdated today
    Auto-check passed
  • Code Review

    holon-run/holon

    Review a set of code changes using evidence-backed findings, explicit confidence, and a clear coverage summary.

    153 GitHub stars~1.6k tokensUpdated today
    Auto-check passed
  • Ghx

    holon-run/holon

    Guidance for safe, reliable GitHub CLI workflows across issues, pull requests, and reviews.

    153 GitHub stars~1k tokensUpdated today
    Auto-check passed

Questions about DOCX

What does DOCX do?

Create, inspect, edit, render, and validate Word documents with local open-source tools while preserving source files and making unsupported OOXML features explicit. DOCX is an agent skill from holon-run/holon. Create, inspect, edit, render, and validate Word documents with local open-source tools while preserving source files and making unsupported OOXML features explicit.

When should I use DOCX?

DOCX fits situations like: tasks that involve Word documents.

How do I install DOCX in Claude Code?

Run `npx skills add holon-run/holon --skill docx -a claude-code`. Or copy the skill folder (skills/docx in holon-run/holon) into .claude/skills/docx in your project. Claude Code loads it when a task matches its description.

How do I install DOCX in Codex?

Run `npx skills add holon-run/holon --skill docx -a codex`. Or copy the skill folder (skills/docx in holon-run/holon) into .agents/skills/docx in your project. Codex loads it when a task matches its description.

Can I use DOCX in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add holon-run/holon --skill docx -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/docx, .gemini/skills/docx, .github/skills/docx and .opencode/skills/docx in your project.

What does DOCX need to run?

SKILL.md names no scripts, command-line tools or credentials: DOCX is instructions for the agent only. Our summary lists: Python 3.

Does DOCX access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is DOCX safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does DOCX use?

DOCX is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does DOCX use?

About 986 tokens (SKILL.md is roughly 3.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to DOCX?

Skills that share tags, products or a category with DOCX: DOCX Toolkit (XiaomiMiMo/MiMo-Code, 14k stars), Word DOCX Toolkit (NousResearch/hermes-agent, 252k stars), DOCX (guyi-a/pi-ling, 106 stars) and Z Md To Word (tjxj/z-skills, 546 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains DOCX?

holon-run (a GitHub organization) maintains it in holon-run/holon, which has 153 GitHub stars. The repository holds 13 skills in this directory. The repository was last updated on October 8, 2026.

Source: holon-run/holon on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.