跳到正文
cccskills
免费在 GitHub 公开

office-utils

Unpack Word and PowerPoint files to inspect and edit their internal XML, the markup that stores document content. Repack targeted changes with XML syntax checks while preserving the original archive entry order.

中文简介正在准备中。当前显示英语简介。

原文查看原文说明

Low-level support skill for hand-editing the raw XML inside a .docx or .pptx file (both formats are just ZIP archives of XML parts). Use this directly only when you need to unpack, inspect, or repack Open XML yourself — for example fixing a validation error in generated markup, or making one small targeted edit without regenerating a whole document from scratch. The docx and pptx skills already use this internally for their 'edit an existing file' workflow, so you rarely need to load this on its own.

集成工具WordPowerPoint
查看安装方法

适用场景

  • Make a small edit inside a Word or PowerPoint file
  • Investigate errors in generated document XML
  • Inspect internal document parts and image references
  • Repack edited files with XML syntax validation

包含的文件(3)

  • SKILL.md4.5 KB
  • scripts/pack.py2.4 KB
  • scripts/unpack.py2.2 KB

SKILL.md(原文)

安装前可以查看交给 AI 代理的指令内容。

Office Open XML utilities

Overview

A .docx or .pptx file is a ZIP archive containing a tree of XML parts (word/document.xml, ppt/slides/slide1.xml, relationship files, content-type manifests, ...). Editing it directly means: unpack the ZIP, edit the XML text, repack the ZIP. No LibreOffice or other converter is required for this — it is pure zipfile + text editing.

Note on language: the docx/pptx/xlsx/pdf skills default to Node (docx/pptxgenjs/exceljs/pdfkit) for creating a file from scratch, per this environment's Node-first policy for office-document generation. This skill stays Python: it's invoked by writing a subprocess call from your sandbox program (whichever coding tool runs it), and the Python invocation (python skills/office-utils/scripts/unpack.py ...) is guaranteed to resolve the same way across every sandbox backend, whereas the TypeScript runtime's binary (tsx) is installed per-sandbox and its exact invocation differs across backends — not worth the portability risk for a script that's about editing XML, not about which language "creates" the file.

Quick Reference

TaskCommand
Unpack a file to a directory treepython skills/office-utils/scripts/unpack.py <file.docx|pptx> <out_dir/>
Repack a directory tree back to a filepython skills/office-utils/scripts/pack.py <out_dir/> <file.docx|pptx>

Workflow

  1. Unpack: python skills/office-utils/scripts/unpack.py presentation.pptx unpacked/. This extracts every part into unpacked/, pretty-printing every .xml file (one element per line) so edits are readable and diffable. A _unpack_manifest.json file records the original entry order and compression — pack.py reads it back so re-zipping doesn't accidentally change part ordering, which some Office readers are picky about.
  2. Edit: make targeted edits to the relevant XML file(s) under unpacked/ (e.g. unpacked/word/document.xml, unpacked/ppt/slides/slide1.xml). Prefer the smallest possible edit — a single attribute or run of text — over rewriting a whole XML subtree, so you're less likely to break sibling elements you didn't intend to touch.
  3. Repack: python skills/office-utils/scripts/pack.py unpacked/ output.pptx. This re-zips using the manifest's original entry order, and validates that every .xml part is still well-formed (parses cleanly) before writing the final file — if any part is malformed, it fails loudly with the offending file name and line instead of silently producing a corrupt document.

Common pitfalls

  • Don't reorder ZIP entries. Some parsers (notably older Office/PowerPoint) are sensitive to [Content_Types].xml and _rels/.rels being near the start of the archive. pack.py's manifest-driven ordering exists specifically to avoid this — don't hand-roll your own zipping.
  • Keep relationship IDs (r:id) consistent. If you add a new part (e.g. an image), you must add both a <Relationship> entry in the owning part's _rels/*.rels file AND a reference to that same ID from the XML that uses it. Adding one without the other produces a file that "opens" but shows a broken-image icon or corruption warning.
  • Escape XML special characters (&, <, >) in any text you insert into a <w:t>/<a:t> run — a raw ampersand will make the part invalid XML and fail the pack-time validation.
  • This skill has no way to render a preview. Visual verification (rendering the file to an image) requires LibreOffice, which is not available in this environment yet — verify structurally (does it still parse? do the relationship IDs still resolve?) rather than visually.

Dependencies

Pure Python standard library (zipfile, xml.dom.minidom, json) — no packages to install.

评价

还没有评价。欢迎分享你的使用感受。

评论

无需登录即可发表。欢迎分享使用感受、提问,或说明在哪些环境下无法运行。

还没有评论。来写第一条吧。

提交后会立即公开。请勿填写邮箱、电话等个人信息。URL 最多 2 个。

0 / 1000 字

此表单受 reCAPTCHA 保护,适用 Google 的隐私权政策和服务条款。

同一仓库的技能

Build or extend a PipesHub connector, an integration that syncs content from an external service or database. The skill guides API research, design decisions, permission mapping, implementation, testing, and documentation of what was actually verified.

中文简介正在准备中。当前显示英语简介。

  • Build a connector for an external service
  • Add a new content type to an existing connector
  • Review how source permissions map to PipesHub
pipeshub-ai/pipeshub-ai38432026年10月22日 更新

Load, clean, summarize, and join tabular data from CSV, Excel, JSON, or database exports using pandas. Check missing values, data types, and row counts, then independently verify key figures before reporting numbers printed by the code.

中文简介正在准备中。当前显示英语简介。

  • Summarizing revenue by region
  • Cleaning missing values and duplicate rows
  • Joining files by customer ID
pipeshub-ai/pipeshub-ai38432026年10月22日 更新

Turn data into charts suited to comparisons, trends, distributions, relationships, or shares. Add clear titles, units, and accessible colors, then export a static PNG or interactive HTML with hover details and zoom controls.

中文简介正在准备中。当前显示英语简介。

  • Charting monthly revenue trends
  • Comparing totals across regions or categories
  • Examining order-size distributions
pipeshub-ai/pipeshub-ai38432026年10月22日 更新

docx

免费

Create Word reports, memos, letters, and proposals with headings, tables, lists, and a table of contents. Also supports targeted edits to existing .docx files and reading or summarizing their text and tables.

中文简介正在准备中。当前显示英语简介。

  • Create a Word report or proposal
  • Edit selected passages in an existing document
  • Read and summarize document text and tables
pipeshub-ai/pipeshub-ai38432026年10月22日 更新

Choose suitable libraries for converting spreadsheet data and image files, or extracting text and tables from documents. Covers supported format pairs and identifies conversions unavailable in the described environment before work begins.

中文简介正在准备中。当前显示英语简介。

  • Convert tabular data between CSV, Excel, and JSON
  • Change image formats or resize images
  • Extract text from Word documents
pipeshub-ai/pipeshub-ai38432026年10月22日 更新

pdf

免费

Create PDF reports, invoices, and letters, extract text or tables from existing PDFs, and fill interactive form fields. The skill also guides table layout, text wrapping, and page breaks so generated documents fit their pages.

中文简介正在准备中。当前显示英语简介。

  • Create a PDF report or invoice
  • Extract text and tables from an existing PDF
  • Fill fields in a PDF form
pipeshub-ai/pipeshub-ai38432026年10月22日 更新

查看 pipeshub-ai 的全部技能

报告此技能的问题