Agent skill

DOCX Processing Toolkit

by telagod in telagod/code-abyss

Routes Word document tasks to the right tool: pandoc for text, raw OOXML for structure and comments, docx-js for new files, and a mandatory redlining flow for edits to others' documents.

MITAuto-check: notesDocuments & Office

Install DOCX Processing Toolkit

skills CLI
$ npx skills add telagod/code-abyss --skill processing-docx -a claude-code

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

GitHub CLI
$ gh skill install telagod/code-abyss processing-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/telagod/code-abyss.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/processing-docx .claude/skills/processing-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
processing-docx
GitHub stars
244
Token cost
~668 tokens
SKILL.md length
208 words
Files
69 (incl. scripts, references)
Skills in repo
38
Repo updated
First seen
Licence
MIT

At a glance

Routes Word document tasks to the right tool: pandoc for text, raw OOXML for structure and comments, docx-js for new files, and a mandatory redlining flow for edits to others' documents.

  • Works in 3 steps: MANDATORY — READ ENTIRE FILE: docx-js.md… → Create JS/TS file using Document,… → Export with Packer.toBuffer().
  • Creating a new Word document from scratch with JavaScript or TypeScript
  • SKILL.md covers Workflow Decision, Text Extraction (Quick), Create New Document and Edit Existing Document (Own,…, plus 3 more sections
  • Calls apt, python and pandoc

What it does

Since a .docx file is a ZIP archive of XML and resources, the skill picks a workflow by intent rather than one generic path. Reading or analyzing text only goes through pandoc straight to Markdown, including a track-changes mode; reading structure, comments, media or formatting instead unpacks the raw XML; visual analysis converts through soffice to PDF and then to images with pdftoppm.

Creating a new document uses docx-js in JavaScript or TypeScript with Document, Paragraph and TextRun components, exported with Packer.toBuffer, while editing an existing document the user owns uses a Python document library after unpacking with ooxml/scripts/unpack.py and repacking afterward. Before either path the skill requires reading the relevant reference file in full, docx-js.md or ooxml.md, with no partial range limits.

Editing someone else's document is treated differently: it must go through a tracked-changes redlining workflow with a batching strategy and RSID preservation, called required for legal, academic, business or government documents specifically. A dependency table lists what each path needs: pandoc, the docx npm package, LibreOffice for PDF conversion, Poppler for image extraction, and defusedxml for secure XML parsing.

When your agent uses it

  • Creating a new Word document from scratch with JavaScript or TypeScript
  • Extracting text, comments or formatting from an existing .docx file
  • Making tracked-changes edits to a legal, academic or business document

Example prompts

  • “Create a new Word document for this proposal using docx-js.”
  • “Extract the text and comments from contract-draft.docx.”
  • “Redline the changes to this legal document and preserve the RSIDs.”

Requirements

  • pandoc
  • The docx npm package, for creating new documents
  • LibreOffice and Poppler, for visual PDF conversion
  • Pre-approved tools (allowed-tools): Bash, Read, Write, Edit, Glob

Workflow steps

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

  1. MANDATORY — READ ENTIRE FILE: docx-js.md (~500 lines). NEVER set range limits.
  2. Create JS/TS file using Document, Paragraph, TextRun components.
  3. Export with Packer.toBuffer().

What it can do on your machine

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

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Bash
    • Read
    • Write
    • Edit
    • Glob

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/, which the agent can run.

    Shell commands in SKILL.md call:

    • apt
    • python
    • pandoc
    • npm
    • pip

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

  • Network

    No URLs in SKILL.md. Its commands use npm and pip, which can reach the network depending on how they are called.

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

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

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.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Bash, Read, Write, Edit, Glob

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

The full file from telagod/code-abyss at commit 2544577, republished under its MIT licence (© telagod). 208 words, ~668 tokens.

Download SKILL.mdSave it as .claude/skills/processing-docx/SKILL.md (or your agent's skills folder). This skill also uses 68 other files; get the full folder from GitHub.
name
processing-docx
description
Processes Word document files (.docx). Creates, edits, annotates, tracks revisions, analyzes OOXML structure, and preserves formatting for contracts, policies, academic papers, and business documents. Use when working with .docx files or Word documents. Do NOT use for PDFs, spreadsheets, presentations, or plain text files.
allowed-tools
Bash, Read, Write, Edit, Glob
user-invocable
false
argument-hint
<file.docx | task>

DOCX Processing

.docx is a ZIP archive of XML and resources. Different tasks have different tools and workflows.

Workflow Decision

IntentWorkflowReference
Read/analyze text onlypandoc → markdownraw-xml-access.md
Read structure, comments, media, formattingunpack → raw XMLraw-xml-access.md
Create new documentdocx-js (JS/TS)docx-js.md
Edit own document, simple changesDocument library (Python)ooxml.md
Edit someone else's documentRedlining (tracked changes)redlining.md
Legal / academic / business / gov docsRedlining — REQUIREDredlining.md
Visual analysissoffice → PDF → pdftoppmraw-xml-access.md

Text Extraction (Quick)

bash
pandoc --track-changes=all path-to-file.docx -o output.md
# --track-changes=accept/reject/all

Create New Document

  1. MANDATORY — READ ENTIRE FILE: docx-js.md (~500 lines). NEVER set range limits.
  2. Create JS/TS file using Document, Paragraph, TextRun components.
  3. Export with Packer.toBuffer().

Edit Existing Document (Own, Simple)

  1. MANDATORY — READ ENTIRE FILE: ooxml.md (~600 lines). NEVER set range limits.
  2. python ooxml/scripts/unpack.py <office_file> <output_dir>
  3. Run Python script using Document library.
  4. python ooxml/scripts/pack.py <input_dir> <office_file>

Edit Someone Else's Document → Redlining

See redlining.md for full 6-step workflow with batching strategy and RSID preservation.

Code Style

  • Write concise code, no verbose variable names, no unnecessary print statements.

Dependencies

PackageInstallPurpose
pandocapt install pandocText extraction
docxnpm i -g docxCreate new docs
LibreOfficeapt install libreofficePDF conversion
Popplerapt install poppler-utilspdftoppm for images
defusedxmlpip install defusedxmlSecure XML parsing

© telagod, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 68 other files (scripts, references) in skills/processing-docx of telagod/code-abyss.

  • SKILL.md
  • docx-js.md
  • ooxml.md
  • ooxml/schemas/ISO-IEC29500-4_2016/dml-chart.xsd
  • ooxml/schemas/ISO-IEC29500-4_2016/dml-chartDrawing.xsd
  • ooxml/schemas/ISO-IEC29500-4_2016/dml-diagram.xsd
  • ooxml/schemas/ISO-IEC29500-4_2016/dml-lockedCanvas.xsd
  • ooxml/schemas/ISO-IEC29500-4_2016/dml-main.xsd
  • ooxml/schemas/ISO-IEC29500-4_2016/dml-picture.xsd
  • ooxml/schemas/ISO-IEC29500-4_2016/dml-spreadsheetDrawing.xsd
  • ooxml/schemas/ISO-IEC29500-4_2016/dml-wordprocessingDrawing.xsd
  • ooxml/schemas/ISO-IEC29500-4_2016/pml.xsd
  • ooxml/schemas/ISO-IEC29500-4_2016/shared-additionalCharacteristics.xsd
  • ooxml/schemas/ISO-IEC29500-4_2016/shared-bibliography.xsd
  • ooxml/schemas/ISO-IEC29500-4_2016/shared-commonSimpleTypes.xsd
  • ooxml/schemas/ISO-IEC29500-4_2016/shared-customXmlDataProperties.xsd
  • ooxml/schemas/ISO-IEC29500-4_2016/shared-customXmlSchemaProperties.xsd
  • ooxml/schemas/ISO-IEC29500-4_2016/shared-documentPropertiesCustom.xsd
  • … and 51 more

Open the folder on GitHubat commit 2544577

Compare with similar skills

DOCX Processing Toolkit 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 Processing Toolkit compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
DOCX Processing Toolkit this skilltelagod/code-abyss244—~668Automated safety check: NotesMIT
DOCX ToolkitXiaomiMiMo/MiMo-Code14k—~2.4kAutomated safety check: PassApache-2.0
Office DOCXsingula-ai/alego1091 repos~1.5kAutomated safety check: PassMIT
Tdoc DOCXLeoYeAI/openclaw-master-skills2.2k—~3.6kAutomated safety check: NotesMIT
DOCX Creation and Editinganthropics/skills180k6 repos~1.7kAutomated safety check: PassProprietary
DOCX Creation and Editingagentscope-ai/QwenPaw35k—~3.3kAutomated safety check: PassProprietary

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 4 days ago
    Documents & OfficeAuto-check passed
  • Office DOCX

    singula-ai/alego

    Create, read, edit, and check Word documents (.docx), including reports, letters, and formatted tables.

    109 GitHub starsUsed in 1 repo~1.5k tokens
    Documents & OfficeAuto-check passed
  • Tdoc DOCX

    LeoYeAI/openclaw-master-skills

    Word 文档全能处理技能 | Complete Word Document Processing Skill. An agent skill from LeoYeAI/openclaw-master-skills.

    2.2k GitHub stars~3.6k tokensUpdated 2 mo ago
    Documents & OfficeAuto-check: notes
  • DOCX Creation and Editing

    anthropics/skills

    Official

    Creates, edits and reviews Word documents: new files with docx-js, edits through the underlying XML, plus tracked changes, comments and conversions.

    180k GitHub starsUsed in 6 repos~1.7k tokens
    Documents & OfficeAuto-check passed
  • DOCX Creation and Editing

    agentscope-ai/QwenPaw

    Creates, reads and edits Word .docx files, including tracked changes and comments, using docx-js for new files and XML editing for existing ones.

    35k GitHub stars~3.3k tokensUpdated 7 days ago
    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 21 days ago
    Documents & OfficeAuto-check passed

More from telagod/code-abyss

All 38 skills in this repo
  • Security Gate Scanner

    telagod/code-abyss

    Scans code with a bundled Node scanner for injection, secret leaks and other dangerous patterns, and requires documented decisions for accepted risks.

    244 GitHub stars~552 tokensUpdated 2 mo ago
    Auto-check: notes
  • Persona Voice Card Builder

    telagod/code-abyss

    Distills a recurring agent voice from conversations into a restricted Persona Voice Card, validates it for schema, safety and distinctness, and prepares it for community submission.

    244 GitHub stars~716 tokensUpdated 2 mo ago
    Auto-check: notes
  • Skill Cultivation Funnel

    telagod/code-abyss

    Distills repeated workflows into new skills, improves existing ones and promotes them through local, project and community tiers after a default-deny safety scan.

    244 GitHub stars~794 tokensUpdated 2 mo ago
    Auto-check: notes
  • PDF Processing Toolkit

    telagod/code-abyss

    Picks the right Python library or CLI tool for a PDF task, text and table extraction, merging, splitting, OCR, watermarking or form filling, and points to a matching recipe.

    244 GitHub stars~532 tokensUpdated 2 mo ago
    Auto-check: notes
  • Code Change Analysis Gate

    telagod/code-abyss

    Checks what a code change touched, how far its impact reaches and whether design docs, tests and README files kept up, before commit or in review.

    244 GitHub stars~532 tokensUpdated 2 mo ago
    Auto-check: notes
  • Code Quality Gate Checker

    telagod/code-abyss

    Checks cyclomatic complexity, function and file length, parameter count, nesting depth and naming conventions against fixed thresholds, with a bundled Node.js script and hotspot integration.

    244 GitHub stars~609 tokensUpdated 2 mo ago
    Auto-check: notes

Questions about DOCX Processing Toolkit

What does DOCX Processing Toolkit do?

Routes Word document tasks to the right tool: pandoc for text, raw OOXML for structure and comments, docx-js for new files, and a mandatory redlining flow for edits to others' documents. docx file is a ZIP archive of XML and resources, the skill picks a workflow by intent rather than one generic path. Reading or analyzing text only goes through pandoc straight to Markdown, including a track-changes mode; reading structure, comments, media or formatting instead unpacks the raw XML; visual analysis converts through soffice to PDF and then to images with pdftoppm.

When should I use DOCX Processing Toolkit?

DOCX Processing Toolkit fits situations like: creating a new Word document from scratch with JavaScript or TypeScript; extracting text, comments or formatting from an existing .docx file; making tracked-changes edits to a legal, academic or business document.

How do I install DOCX Processing Toolkit in Claude Code?

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

How do I install DOCX Processing Toolkit in Codex?

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

Can I use DOCX Processing Toolkit 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 telagod/code-abyss --skill processing-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/processing-docx, .gemini/skills/processing-docx, .github/skills/processing-docx and .opencode/skills/processing-docx in your project.

What does DOCX Processing Toolkit need to run?

Going by SKILL.md and its folder, DOCX Processing Toolkit needs the command-line tools its instructions call (apt, python, pandoc, npm and pip). Our summary lists: pandoc; The docx npm package, for creating new documents; LibreOffice and Poppler, for visual PDF conversion. Its frontmatter pre-approves these tools: Bash, Read, Write, Edit, Glob.

Does DOCX Processing Toolkit access the network?

SKILL.md contains no URLs. Its commands use npm and pip, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is DOCX Processing Toolkit safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), 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 Processing Toolkit use?

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

How many tokens does DOCX Processing Toolkit use?

About 668 tokens (SKILL.md is roughly 2.7k 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 1.3k tokens, read only when the agent opens those files.

What are the alternatives to DOCX Processing Toolkit?

Skills that share tags, products or a category with DOCX Processing Toolkit: DOCX Toolkit (XiaomiMiMo/MiMo-Code, 14k stars), Office DOCX (singula-ai/alego, 109 stars), Tdoc DOCX (LeoYeAI/openclaw-master-skills, 2.2k stars) and DOCX Creation and Editing (anthropics/skills, 180k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains DOCX Processing Toolkit?

telagod (a GitHub user) maintains it in telagod/code-abyss, which has 244 GitHub stars. The repository holds 38 skills in this directory. The repository was last updated on July 19, 2026.

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