Agent skill

DOCX

by zai-org in zai-org/ZCode

Complete DOCX document creation, editing, and analysis capabilities with support for revisions, comments, formatting preservation, and text extraction.

ProprietaryAuto-check: notesDocuments & Office

Install DOCX

skills CLI
$ npx skills add zai-org/ZCode --skill docx -a claude-code

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

GitHub CLI
$ gh skill install zai-org/ZCode 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/zai-org/ZCode.git skills-src && mkdir -p .claude/skills && cp -r skills-src/apps/zcode-cli/packages/documents-plugin/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
7.7k
Token cost
~4.9k tokens
SKILL.md length
2,221 words
Files
44 (incl. scripts, references)
Skills in repo
5
Repo updated
First seen
Licence
Proprietary

At a glance

Complete DOCX document creation, editing, and analysis capabilities with support for revisions, comments, formatting preservation, and text extraction.

  • Works in 5 steps: Explain the necessity to the user.… → Tell them the download is large (roughly… → Install it now. Preferred source —… → …
  • Creating new documents
  • SKILL.md covers Quick Setup, Overview, Quick Route — Read This First and Formatting Standards (Always…, plus 6 more sections
  • Runs Shell and PowerShell scripts from its folder; calls python3, bash and bun; reaches mirrors.tuna.tsinghua.edu.cn

What it does

DOCX is an agent skill from zai-org/ZCode. Complete DOCX document creation, editing, and analysis capabilities with support for revisions, comments, formatting preservation, and text extraction. Also handles Word format conversion: legacy .doc → .docx, DOCX → PDF, DOCX → images (PNG/JPG) for visual review or previews, and DOCX → Markdown/plain text extraction. Use for creating new documents, modifying content, handling revisions, adding comments, other professional Word document tasks, or when the user asks to convert, export, or render a Word document to…

Its SKILL.md is about 4.9k tokens, which your agent loads only when the skill is triggered. The skill folder holds 46 other files, including scripts and reference files (for example `env_setup/env_check.sh`, `env_setup/setup.md` and `env_setup/setup_mac_linux.sh`).

It sits in Documents & Office, covering Word documents. It works with Microsoft Word. The repository describes itself as: Z.ai's coding agent harness. Powerful, intelligent, extensible.

When your agent uses it

  • Creating new documents
  • Modifying content
  • Handling revisions
  • Adding comments

Example prompts

  • “Word转PDF”
  • “doc转docx”
  • “export this docx as PDF/images”
  • “/docx”

Requirements

  • Python 3
  • A Bash shell
  • PowerShell

Workflow steps

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

  1. Explain the necessity to the user. LibreOffice is the conversion engine that preserves the
  2. Tell them the download is large (roughly several hundred MB) and may take a while. This is
  3. Install it now. Preferred source — Tsinghua TUNA mirror (fast in China, current build)
  4. Register the binary on PATH, then re-verify. An install that leaves soffice off the
  5. Only after that install has actually been attempted AND failed may you use software already

What it can do on your machine

Read from SKILL.md and the folder at commit aac4755. 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

    Ships 1 file in scripts/ (Shell and PowerShell, from the files we listed), which the agent can run.

    Shell commands in SKILL.md call:

    • python3
    • bash
    • bun
    • npm
    • brew
    • apt
    • winget
    • soffice

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

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • mirrors.tuna.tsinghua.edu.cn

    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 4.9k tokens when it runs, and up to ~54k if it reads all its reference files. Until then it costs about 151 tokens; SKILL.md has 2,221 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~151
When it runs · the whole SKILL.md, loaded when a task matches
~4.9k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~54k

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: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteRuns commands with sudoSKILL.md:252
    - Linux (Debian/Ubuntu): `sudo apt install libreoffice-core`

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); the scripts in this folder are not scanned.

SKILL.md

Its licence (Proprietary) doesn't allow us to republish the file, so here is its outline and opening line. It has 2,221 words (~4,931 tokens).

“A .docx file is a ZIP archive containing XML files. This skill provides tools for creating, editing, reading, and reviewing Word documents.”

— opening of SKILL.md by zai-org, Proprietary
name
docx
metadata.author
Z.AI
metadata.version
1.1
license
Proprietary. LICENSE.txt has complete terms

Read the full SKILL.md on GitHub

Files

SKILL.md and 43 other files (scripts, references) in apps/zcode-cli/packages/documents-plugin/skills/docx of zai-org/ZCode.

  • SKILL.md
  • LICENSE.txt
  • env_setup/env_check.sh
  • env_setup/font_list.txt
  • env_setup/setup.md
  • env_setup/setup_mac_linux.sh
  • env_setup/setup_windows.ps1
  • references/chart-templates.md
  • references/common-rules.md
  • references/decorations.md
  • references/design-system.md
  • references/docx-js-advanced.md
  • references/docx-js-core.md
  • references/faq.md
  • references/math-formulas.md
  • references/ooxml.md
  • references/toc.md
  • routes/comment.md
  • … and 26 more

Open the folder on GitHubat commit aac4755

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 skillzai-org/ZCode7.7k—~4.9kAutomated safety check: NotesProprietary
MarkitdownImCa0/just-laws78114 repos~3.2kAutomated safety check: NotesMIT
DOCXrvdbreemen/OTGW-firmware20733 repos~4.3kAutomated safety check: PassProprietary
Word Document Reader and WriterHKUDS/DeepTutor41k—~2.5kAutomated safety check: PassApache-2.0
Gzh Designisjiamu/gzh-design-skill4k—~2.2kAutomated safety check: PassAGPL-3.0
GenOffice Document CLIgenspark-ai/genoffice9.2k—~19kAutomated safety check: PassApache-2.0

Similar skills

  • Markitdown

    ImCa0/just-laws

    Convert files and office documents to Markdown. An agent skill from ImCa0/just-laws.

    781 GitHub starsUsed in 14 repos~3.2k tokens
    Documents & OfficeAuto-check: notes
  • DOCX

    rvdbreemen/OTGW-firmware

    A skill your agent uses whenever the user wants to create, read, edit, or manipulate Word documents (.docx files).

    207 GitHub starsUsed in 33 repos~4.3k tokens
    Documents & OfficeAuto-check passed
  • Reads, creates and edits Word .docx files with python-docx, and drops to raw OOXML for tracked changes, comments and byte-exact edits.

    41k GitHub stars~2.5k tokensUpdated 3 days ago
    Documents & OfficeAuto-check passed
  • Gzh Design

    isjiamu/gzh-design-skill

    微信公众号文章排版引擎,将 Markdown 转换为可直接粘贴到公众号编辑器的 HTML。主题风格从 references/theme-index.md 注册的自定义主题库中选取,自动章节编号、关键词下划线标记、引言卡片、目录导航、代码块、图片/GIF、作者签名。支持 Markdown / Word(.docx) / PDF / 纯文本输入(非 Markdown…

    4k GitHub stars~2.2k tokensUpdated 2 days ago
    Documents & OfficeAuto-check passed
  • GenOffice Document CLI

    genspark-ai/genoffice

    Creates, converts, reads and edits real pptx, xlsx, docx and PDF files locally through the genoffice command line.

    9.2k GitHub stars~19k tokensUpdated yesterday
    Documents & OfficeAuto-check passed
  • BiSheng DOCX Builder

    dataelement/bisheng

    Builds or edits Word .docx documents inside BiSheng's code executor with python-docx, handling Chinese fonts, tables of contents, page numbers and official-document layout.

    12k GitHub stars~2.7k tokensUpdated yesterday
    Documents & OfficeAuto-check passed

More from zai-org/ZCode

All 25 skills in this repo
  • Visualize

    zai-org/ZCode

    Create visualizations and interactive tools directly in conversation.

    7.7k GitHub stars~8.7k tokensUpdated today
    Auto-check passed
  • PDF

    zai-org/ZCode

    Professional PDF toolkit covering four production workflows: reports, creative visuals, academic LaTeX, and existing PDF processing.

    7.7k GitHub stars~18k tokensUpdated today
    Auto-check: notes
  • A skill your agent uses when ZCode needs to inspect, plan, or execute restoration of old ACP-era ZCode sessions from ~/.zcode/v2/sessions into the new ZCode task/session stores.

    7.7k GitHub stars~1.2k tokensUpdated today
    Auto-check passed
  • Generate, verify, or remove large synthetic ZCode task fixtures in local ~/.zcode persistence for UI/session performance testing.

    7.7k GitHub stars~698 tokensUpdated today
    Auto-check passed
  • Check ZCode module and layer boundaries for code changes. An agent skill from zai-org/ZCode.

    7.7k GitHub stars~1.3k tokensUpdated today
    Auto-check passed
  • XLSX

    zai-org/ZCode

    Use this skill any time a spreadsheet file is the primary input or output.

    7.7k GitHub starsUsed in 1 repo~4.4k tokens
    Auto-check: notes

Works with

Questions about DOCX

What does DOCX do?

Complete DOCX document creation, editing, and analysis capabilities with support for revisions, comments, formatting preservation, and text extraction. DOCX is an agent skill from zai-org/ZCode. Complete DOCX document creation, editing, and analysis capabilities with support for revisions, comments, formatting preservation, and text extraction.

When should I use DOCX?

DOCX fits situations like: creating new documents; modifying content; handling revisions; adding comments.

How do I install DOCX in Claude Code?

Run `npx skills add zai-org/ZCode --skill docx -a claude-code`. Or copy the skill folder (apps/zcode-cli/packages/documents-plugin/skills/docx in zai-org/ZCode) 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 zai-org/ZCode --skill docx -a codex`. Or copy the skill folder (apps/zcode-cli/packages/documents-plugin/skills/docx in zai-org/ZCode) 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 zai-org/ZCode --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?

Going by SKILL.md and its folder, DOCX needs a shell and PowerShell for the scripts in its folder and the command-line tools its instructions call (python3, bash, bun, npm, brew and apt). Our summary lists: Python 3; A Bash shell; PowerShell.

Does DOCX access the network?

SKILL.md names 1 domain. In commands or code: mirrors.tuna.tsinghua.edu.cn; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is DOCX safe to install?

Our automated static check of SKILL.md found notes only (runs commands with sudo), nothing it rates as a warning. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does DOCX use?

DOCX carries a proprietary licence (declared in SKILL.md). It is published on GitHub, but it is not open source: read the licence file before using or sharing it.

How many tokens does DOCX use?

About 4.9k tokens (SKILL.md is roughly 20k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 49k tokens, read only when the agent opens those files.

What are the alternatives to DOCX?

Skills that share tags, products or a category with DOCX: Markitdown (ImCa0/just-laws, 781 stars), DOCX (rvdbreemen/OTGW-firmware, 207 stars), Word Document Reader and Writer (HKUDS/DeepTutor, 41k stars) and Gzh Design (isjiamu/gzh-design-skill, 4k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains DOCX?

zai-org (a GitHub organization) maintains it in zai-org/ZCode, which has 7,659 GitHub stars. The repository holds 5 skills in this directory. The repository was last updated on October 10, 2026.

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