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.
Word 文档(.docx)的日常处理:md → docx(生成简历/报告)、docx → PDF/图片(分享预览)、.doc → .docx(老格式升级)。触发场景:用户说"生成 Word 版" / "做份 Word 简历" / "把这份报告转 Word" / "这份 .doc 打不开" / "docx 转 PDF" 等。读 docx 内容走 agent 已有的…
$ npx skills add guyi-a/pi-ling --skill docx -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install guyi-a/pi-ling docx --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/guyi-a/pi-ling.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/docx .claude/skills/docx && rm -rf skills-srcUse ~/.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/
Install the "docx" agent skill from https://github.com/guyi-a/pi-ling/tree/main/.agents/skills/docx into .claude/skills/docx/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "docx", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/guyi-a/pi-ling/tree/main/.agents/skills/docxType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add guyi-a/pi-ling --skill docx -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install guyi-a/pi-ling docx --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/guyi-a/pi-ling.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.agents/skills/docx .agents/skills/docx && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "docx" agent skill from https://github.com/guyi-a/pi-ling/tree/main/.agents/skills/docx into .agents/skills/docx/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "docx", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add guyi-a/pi-ling --skill docx -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install guyi-a/pi-ling docx --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/guyi-a/pi-ling.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.agents/skills/docx .cursor/skills/docx && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "docx" agent skill from https://github.com/guyi-a/pi-ling/tree/main/.agents/skills/docx into .cursor/skills/docx/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "docx", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/guyi-a/pi-ling.git --path .agents/skills/docx--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add guyi-a/pi-ling --skill docx -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install guyi-a/pi-ling docx --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/guyi-a/pi-ling.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.agents/skills/docx .gemini/skills/docx && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "docx" agent skill from https://github.com/guyi-a/pi-ling/tree/main/.agents/skills/docx into .gemini/skills/docx/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "docx", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install guyi-a/pi-ling docxInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add guyi-a/pi-ling --skill docx -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/guyi-a/pi-ling.git skills-src && mkdir -p .github/skills && cp -r skills-src/.agents/skills/docx .github/skills/docx && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "docx" agent skill from https://github.com/guyi-a/pi-ling/tree/main/.agents/skills/docx into .github/skills/docx/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "docx", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add guyi-a/pi-ling --skill docx -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install guyi-a/pi-ling docx --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/guyi-a/pi-ling.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.agents/skills/docx .opencode/skills/docx && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "docx" agent skill from https://github.com/guyi-a/pi-ling/tree/main/.agents/skills/docx into .opencode/skills/docx/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "docx", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
docxWord 文档(.docx)的日常处理:md → docx(生成简历/报告)、docx → PDF/图片(分享预览)、.doc → .docx(老格式升级)。触发场景:用户说"生成 Word 版" / "做份 Word 简历" / "把这份报告转 Word" / "这份 .doc 打不开" / "docx 转 PDF" 等。读 docx 内容走 agent 已有的…
DOCX is an agent skill from guyi-a/pi-ling. Word 文档(.docx)的日常处理:md → docx(生成简历/报告)、docx → PDF/图片(分享预览)、.doc → .docx(老格式升级)。触发场景:用户说"生成 Word 版" / "做份 Word 简历" / "把这份报告转 Word" / "这份 .doc 打不开" / "docx 转 PDF" 等。读 docx 内容走 agent 已有的 extractdocumenttext 工具,不走本 skill。编辑现有 docx / 修订跟踪 / 批注这些重工作流本 skill 不支持。
Its SKILL.md is about 1.1k 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, LibreOffice, Pandoc and LaTeX. The licence is MIT.
2 steps, taken from the first numbered list in SKILL.md.
Read from SKILL.md and the folder at commit 17a71f6. It shows what the files ask for, not the result of running them.
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.
Shell commands in SKILL.md call:
pandocsofficepdftoppmbrewFrom the folder's file list and the shell code blocks in SKILL.md.
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
DOCX loads about 1.1k tokens when it runs. Until then it costs about 66 tokens; SKILL.md has 347 words of instructions outside code blocks.
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.
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.
The full file from guyi-a/pi-ling at commit 17a71f6, republished under its MIT licence (© guyi-a). 347 words, ~1,106 tokens.
.claude/skills/docx/SKILL.md (or your agent's skills folder).面试助手场景里 Word 用得不多,本 skill 只做生成 + 格式转换这两件高频事,不做重型的编辑/修订/批注(那是法务级工作流,跟本产品定位不匹配)。
能力清单:
| 任务 | 路径 | 依赖 |
|---|---|---|
| md → docx(生成简历/报告) | pandoc a.md -o a.docx | pandoc |
| md → docx(精调样式) | pandoc a.md -o a.docx --reference-doc=模板.docx | pandoc |
| docx → PDF(分享/归档) | soffice --headless --convert-to pdf a.docx | LibreOffice |
| docx → PDF(兜底:没装 LibreOffice) | pandoc a.docx -o a.pdf --pdf-engine=xelatex ... | pandoc + xelatex |
| docx → 图片(预览) | docx → PDF 再 pdftoppm -jpeg -r 150 a.pdf page | LibreOffice + poppler |
| .doc → .docx(老格式升级) | soffice --headless --convert-to docx a.doc | LibreOffice |
| 读 docx 内容 | 用 agent 已有的 extract_document_text 工具 | 不走本 skill |
| 不支持 | 告诉用户在 Word 里手动改 |
默认命令:
pandoc INPUT.md -o OUTPUT.docxpandoc 默认样式对中文简历/报告已经够用(宋体、A4、标准页边距)。生成后必跑自检 SOP。
用户想要特定字体/间距/边距,走 --reference-doc:
pandoc a.md -o a.docx --reference-doc=/path/to/template.docxpandoc 会继承模板里的样式定义(字体、字号、Heading 样式、页边距),把 md 内容按对应样式渲染进去。用户拿到的 Word 打开就是模板的样式。
造模板的兜底做法(用户没有现成模板时):
# 先让 pandoc 吐一份默认模板出来
pandoc -o template.docx --print-default-data-file reference.docx
# 或者
pandoc -o template.docx /dev/null # 生成一个空的默认样式 docx然后告诉用户:用 Word 打开 template.docx,改字体/字号/边距,保存回来,再传给 pandoc --reference-doc 参数。不要 agent 自己去改模板 docx 的 XML —— 那是重工作流,本 skill 不做。
首选(推荐):
soffice --headless --convert-to pdf INPUT.docx --outdir OUT_DIRmacOS 上 soffice 二进制通常在 /Applications/LibreOffice.app/Contents/MacOS/soffice。如果 which soffice 找不到,就用绝对路径调。
首次运行注意:LibreOffice headless 首次会创建 user profile,可能慢 3-5 秒,第二次就快。
兜底路径(用户没装 LibreOffice):
pandoc INPUT.docx -o OUTPUT.pdf \
--pdf-engine=xelatex \
-V CJKmainfont='PingFang SC' \
-V geometry:margin=2cmpandoc 走 xelatex 时 docx → PDF 支持基础样式,复杂图片/表格可能丢格式。soffice 保真度更高。
两步走:
soffice --headless --convert-to pdf INPUT.docx --outdir /tmp
pdftoppm -jpeg -r 150 /tmp/INPUT.pdf /tmp/page
ls /tmp/page-*.jpg-r 150 DPI 够读,太大文件飙升pdftoppm 会 zero-pad 页码到总页数宽度(12 页文档产出 page-01.jpg..page-12.jpg),用 ls 拿真实文件名再读,别硬拼用户上传 .doc(Word 97-2003 老格式)时,extract_document_text 读不了、pandoc 也不认。先升级:
soffice --headless --convert-to docx INPUT.doc --outdir OUT_DIR升完再走 extract_document_text 或后续处理。
必需:pandoc(pdf skill 已经要求装过)
推荐:LibreOffice
brew install --cask libreoffice推荐:Poppler(pdftoppm)
brew install poppler(pdf skill 已要求过)soffice 装了就直接调 —— 先 which soffice 或 command -v soffice,没装走 pandoc 兜底或告诉用户装生成完必跑:
ls -lh <output.docx> && file <output.docx>ls -lh 看文件存在 + 大小合理(<1KB 是空文件)file 应看到 Microsoft Word 2007+ 或 Zip archive data(.docx 本质是 ZIP)想更保险,跑一次转 PDF 打开看:
soffice --headless --convert-to pdf <output.docx> --outdir /tmp && open /tmp/<output>.pdf打得开就交付。
soffice 转 PDF 后 pdfinfo 拿)pandoc / soffice)用户如果要:
告诉用户:本 skill 不覆盖这些场景,建议做法:
extract_document_text 读出简历内容pandoc → docx 或直接给用户 md这条边界要跟用户说清楚,别硬撑着上重工作流。
© guyi-a, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Just SKILL.md in .agents/skills/docx of guyi-a/pi-ling.
Open the folder on GitHubat commit 17a71f6
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.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| DOCX this skillguyi-a/pi-ling | 106 | — | ~1.1k | Automated safety check: Pass | MIT | |
| DOCX ToolkitXiaomiMiMo/MiMo-Code | 14k | — | ~2.4k | Automated safety check: Pass | Apache-2.0 | |
| Pandic OfficeTeam-Commonly/commonly | 1.4k | — | ~642 | Automated safety check: Pass | Apache-2.0 | |
| Article Format Adjustmentaipoch/medical-research-skills | 2k | — | ~2.4k | Automated safety check: Pass | MIT | |
| Converting Filesoaustegard/claude-skills | 150 | — | ~1.6k | Automated safety check: Pass | MIT | |
| Office ToolsTai609/NebulaMat | 100 | — | ~1k | Automated safety check: Pass | Custom licence |
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.
Team-Commonly/commonly
Convert Markdown to PDF (or DOCX/EPUB/HTML) using the pandoc CLI.
aipoch/medical-research-skills
Adjust academic paper formatting and convert between DOCX/LaTeX/Markdown when you need to meet a journal or school template requirement.
oaustegard/claude-skills
Convert a file from one format to another inside the container — documents, images, audio, video.
Tai609/NebulaMat
A skill your agent uses when 需要处理 WPS/Office/PDF 文件——"Excel 数据处理"、"转成 Excel"、"提取 PDF 里的图"、"markdown 转 xlsx/docx/pptx"。触发词含 xlsx/docx/pptx/Excel/表格/配图。
anthropics/skills
Creates, edits and reviews Word documents: new files with docx-js, edits through the underlying XML, plus tracked changes, comments and conversions.
guyi-a/pi-ling
PDF 相关的所有操作:从零生成(reportlab / pypdf)、格式转化(md/html → PDF)、修改(合并 / 拆分 / 旋转 / 加水印 / 提图片 / 元数据)、读内容(pdfplumber / extractdocumenttext)、OCR 扫描件、加密解密。触发场景:用户说"生成 PDF" / "做份 PDF 简历" / "合并这几份 PDF" / "给 PDF…
guyi-a/pi-ling
PowerPoint 幻灯片(.pptx / .potx)的所有操作:从零生成(pptxgenjs Node 库)、基于模板编辑(unpack XML → 改 → clean → pack)、格式转化(pptx → PDF / 图片、.ppt → .pptx)、读取分析。触发场景:用户说"做份 PPT" / "生成幻灯片" / "演讲 slide" / "培训材料" / "项目汇报" /…
guyi-a/pi-ling
Boss 直聘岗位搜索的完整操作手册。触发场景:用户说"找工作"/"看岗位"/"搜招聘"/"投简历"/"跳槽"/"Boss 直聘"/"看看有什么工作"/"帮我看下 XX 岗位"等。前提:必须走 browserbridge(Boss 需要用户 Chrome 登录态;browseruse 独立环境登不上)。包含 URL 模板、城市编码表、Vue data 抽取…
guyi-a/pi-ling
当回答涉及流程、架构、机制、因果、对比、时间线、状态机、层级关系,或用户明确要求画图 / 图解 / 示意图时使用。把内容画成对话内直接渲染的图(自包含 HTML/SVG),而不是用文字罗列。不承接数值图表(折线/柱状/饼图,当前无图表库)、海报、头像、写实插画、地图。
Categories
Word 文档(.docx)的日常处理:md → docx(生成简历/报告)、docx → PDF/图片(分享预览)、.doc → .docx(老格式升级)。触发场景:用户说"生成 Word 版" / "做份 Word 简历" / "把这份报告转 Word" / "这份 .doc 打不开" / "docx 转 PDF" 等。读 docx 内容走 agent 已有的…. DOCX is an agent skill from guyi-a/pi-ling.
DOCX fits situations like: tasks that involve Word documents.
Run `npx skills add guyi-a/pi-ling --skill docx -a claude-code`. Or copy the skill folder (.agents/skills/docx in guyi-a/pi-ling) into .claude/skills/docx in your project. Claude Code loads it when a task matches its description.
Run `npx skills add guyi-a/pi-ling --skill docx -a codex`. Or copy the skill folder (.agents/skills/docx in guyi-a/pi-ling) into .agents/skills/docx in your project. Codex loads it when a task matches its description.
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add guyi-a/pi-ling --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.
Going by SKILL.md and its folder, DOCX needs the command-line tools its instructions call (pandoc, soffice, pdftoppm and brew).
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.
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.
DOCX is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
About 1.1k tokens (SKILL.md is roughly 4.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
Skills that share tags, products or a category with DOCX: DOCX Toolkit (XiaomiMiMo/MiMo-Code, 14k stars), Pandic Office (Team-Commonly/commonly, 1.4k stars), Article Format Adjustment (aipoch/medical-research-skills, 2k stars) and Converting Files (oaustegard/claude-skills, 150 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
guyi-a (a GitHub user) maintains it in guyi-a/pi-ling, which has 106 GitHub stars. The repository holds 5 skills in this directory. The repository was last updated on September 16, 2026.
Source: guyi-a/pi-ling on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.