Skip to content

The agent that grows with you

refactor(skills): fold docx, powerpoint and xlsx into one microsoft-office skill

Teknium6fdc365d4bf9
diff --git a/Dockerfile b/Dockerfile
index c5fd7f509dc..d51e9774d1a 100644
--- a/Dockerfile
+++ b/Dockerfile
@@ -287,7 +287,7 @@ FROM runtime_base AS python_deps
# restores this baseline into volumes that already lost it.
#
# The [documents] extra (python-docx, openpyxl, python-pptx, reportlab, pypdf;
-# ~25 MB) is baked so the docx/xlsx/powerpoint/pdf skills work out of the box:
+# ~25 MB) is baked so the microsoft-office and pdf skills work out of the box:
# this venv is sealed and has no pip, so the agent could not add them itself.
#
# Source binding is created after the source copy below.
diff --git a/optional-skills/finance/dcf-model/SKILL.md b/optional-skills/finance/dcf-model/SKILL.md
index 9a823196a12..0d04b10e0cb 100644
--- a/optional-skills/finance/dcf-model/SKILL.md
+++ b/optional-skills/finance/dcf-model/SKILL.md
@@ -622,7 +622,7 @@ B105: =B88/(1+(E48-0.07)) // Doesn't recalculate full DCF
**Why it's wrong:**
- Can't verify where data came from
-- Fails xlsx skill requirements
+- Fails `microsoft-office` skill requirements
- Not audit-ready
- Wastes time fixing later
@@ -687,7 +687,7 @@ This vertical layout makes it hard to see the progression across years within ea
**Why it's wrong:**
- Can't distinguish inputs from formulas
- Auditing becomes impossible
-- Violates xlsx skill requirements
+- Violates `microsoft-office` skill requirements
**Instead:** Blue text for ALL hardcoded inputs, black text for ALL formulas, green for sheet links
@@ -747,13 +747,13 @@ In addition, be aware of these errors:
## Excel File Creation
-**This skill uses the `xlsx` skill for all spreadsheet operations.** The xlsx skill provides:
+**This skill uses the `microsoft-office` skill for all spreadsheet operations.** It provides:
- Standardized formula construction rules
- Number formatting conventions
- Automated formula recalculation via `recalc.py` script
- Comprehensive error checking and validation
-All Excel files created by this skill must follow xlsx skill requirements, including zero formula errors and proper recalculation.
+All Excel files created by this skill must follow `microsoft-office` skill requirements, including zero formula errors and proper recalculation.
## Quality Rubric
@@ -834,11 +834,11 @@ The script will:
### Formatting Standards
-**IMPORTANT**: Follow the xlsx skill for formula construction rules and number formatting conventions. The DCF skill adds specific visual presentation standards.
+**IMPORTANT**: Follow the `microsoft-office` skill for formula construction rules and number formatting conventions. The DCF skill adds specific visual presentation standards.
**Color Scheme - Two Layers**:
-**Layer 1: Font Colors (MANDATORY from xlsx skill)**
+**Layer 1: Font Colors (MANDATORY from `microsoft-office` skill)**
- **Blue text (RGB: 0,0,255)**: ALL hardcoded inputs (stock price, shares, historical data, assumptions)
- **Black text (RGB: 0,0,0)**: ALL formulas and calculations
- **Green text (RGB: 0,128,0)**: Links to other sheets (WACC sheet references)
@@ -884,7 +884,7 @@ The script will:
**Borders are mandatory** - models without professional borders are not client-ready.
-**Number Formats** (follows xlsx skill standards):
+**Number Formats** (follows `microsoft-office` skill standards):
- **Years**: Format as text strings (e.g., "2024" not "2,024")
- **Percentages**: `0.0%` (one decimal place)
- **Currency**: `$#,##0` for millions; `$#,##0.00` for per-share - ALWAYS specify units in headers ("Revenue ($mm)")
@@ -894,7 +894,7 @@ The script will:
**Cell Comments (MANDATORY for all hardcoded inputs)**:
-Per the xlsx skill, ALL hardcoded values must have cell comments documenting the source. Format: "Source: [System/Document], [Date], [Reference], [URL if applicable]"
+Per the `microsoft-office` skill, ALL hardcoded values must have cell comments documenting the source. Format: "Source: [System/Document], [Date], [Reference], [URL if applicable]"
**CRITICAL**: Add comments AS CELLS ARE CREATED. Do not defer to the end.
@@ -1199,7 +1199,7 @@ This approach centralizes scenario logic, making the model easier to audit and m
### During Model Construction
1. **Build Excel model** using openpyxl with formulas (not hardcoded values)
-2. **Follow xlsx skill conventions** for formula construction and formatting
+2. **Follow `microsoft-office` skill conventions** for formula construction and formatting
3. **Apply fill colors only if requested** by user or if specific brand guidelines are provided
### Before Delivering Model (MANDATORY)
diff --git a/optional-skills/finance/excel-author/SKILL.md b/optional-skills/finance/excel-author/SKILL.md
index 3e789055a76..4b8cea46ab9 100644
--- a/optional-skills/finance/excel-author/SKILL.md
+++ b/optional-skills/finance/excel-author/SKILL.md
@@ -8,7 +8,7 @@ platforms: [linux, macos, windows]
metadata:
hermes:
tags: [excel, openpyxl, finance, spreadsheet, modeling]
- related_skills: [xlsx, pptx-author, dcf-model, comps-analysis, lbo-model, 3-statement-model]
+ related_skills: [microsoft-office, pptx-author, dcf-model, comps-analysis, lbo-model, 3-statement-model]
---
# excel-author
@@ -30,7 +30,7 @@ it). Otherwise, when `hermes` is on PATH, let Hermes build its shared, pinned
documents environment under the Hermes home (safe to run from several agents
at once); in a Docker sandbox without Hermes the block builds a venv in the
sandbox home with the same pinned versions. It is the same block as the
-docx/xlsx/powerpoint/pdf skills. Never `pip install` into the interpreter that
+microsoft-office/pdf skills. Never `pip install` into the interpreter that
runs Hermes:
```bash
diff --git a/optional-skills/finance/pptx-author/SKILL.md b/optional-skills/finance/pptx-author/SKILL.md
index fdeaaf3dde0..978de837e35 100644
--- a/optional-skills/finance/pptx-author/SKILL.md
+++ b/optional-skills/finance/pptx-author/SKILL.md
@@ -8,7 +8,7 @@ platforms: [linux, macos, windows]
metadata:
hermes:
tags: [powerpoint, pptx, python-pptx, presentation, finance]
- related_skills: [excel-author, powerpoint]
+ related_skills: [excel-author, microsoft-office]
---
# pptx-author
@@ -17,7 +17,7 @@ Produce a .pptx file on disk using `python-pptx`. Use when you need to deliver a
Adapted from Anthropic's `pptx-author` and `pitch-deck` skills in [anthropics/financial-services](https://github.com/anthropics/financial-services). The MCP / Office-JS branches of the originals are dropped — this assumes headless Python.
-For the broader, already-shipped PowerPoint authoring skill (slides, speaker notes, embeds, media), see the built-in `powerpoint` skill. This skill is a lighter-weight pattern tuned for model-backed decks (pitch decks, IC memos, earnings notes) where every number must trace to a source workbook.
+For the broader, already-shipped PowerPoint authoring skill (slides, speaker notes, embeds, media), see the built-in `microsoft-office` skill. This skill is a lighter-weight pattern tuned for model-backed decks (pitch decks, IC memos, earnings notes) where every number must trace to a source workbook.
## Output contract
@@ -31,7 +31,7 @@ it). Otherwise, when `hermes` is on PATH, let Hermes build its shared, pinned
documents environment under the Hermes home (safe to run from several agents
at once); in a Docker sandbox without Hermes the block builds a venv in the
sandbox home with the same pinned versions. It is the same block as the
-docx/xlsx/powerpoint/pdf skills. Never `pip install` into the interpreter that
+microsoft-office/pdf skills. Never `pip install` into the interpreter that
runs Hermes:
```bash
@@ -195,8 +195,8 @@ A typical banking pitch deck follows this structure. Not prescriptive, but usefu
## When NOT to use this skill
- Users in a live PowerPoint session with an Office MCP available — drive their live doc instead.
-- Non-financial slideware (quarterly all-hands, marketing decks) — use the broader `powerpoint` skill.
-- Decks with heavy animation, transitions, or speaker notes — use the broader `powerpoint` skill.
+- Non-financial slideware (quarterly all-hands, marketing decks) — use the broader `microsoft-office` skill.
+- Decks with heavy animation, transitions, or speaker notes — use the broader `microsoft-office` skill.
## Attribution
diff --git a/skills/productivity/document-to-action-items/SKILL.md b/skills/productivity/document-to-action-items/SKILL.md
index 037848e06b4..d21cda5ebbe 100644
--- a/skills/productivity/document-to-action-items/SKILL.md
+++ b/skills/productivity/document-to-action-items/SKILL.md
@@ -8,12 +8,12 @@ platforms: [linux, macos, windows]
metadata:
hermes:
tags: [Documents, OCR, Action-Items, Deadlines, Extraction]
- related_skills: [pdf, pdf, docx, notion]
+ related_skills: [pdf, microsoft-office, notion]
---
# Document to Action Items
-Turn documents into cited facts and proposed actions. Extraction is not legal advice, and low-confidence OCR or ambiguous language must remain visible. The `pdf` / `pdf` / `docx` skills own extraction mechanics; this skill owns what happens to the extracted content.
+Turn documents into cited facts and proposed actions. Extraction is not legal advice, and low-confidence OCR or ambiguous language must remain visible. The `pdf` and `microsoft-office` skills own extraction mechanics; this skill owns what happens to the extracted content.
## When to Use
diff --git a/skills/productivity/docx/LICENSE b/skills/productivity/microsoft-office/LICENSE
similarity index 100%
rename from skills/productivity/docx/LICENSE
rename to skills/productivity/microsoft-office/LICENSE
diff --git a/skills/productivity/microsoft-office/SKILL.md b/skills/productivity/microsoft-office/SKILL.md
new file mode 100644
index 00000000000..9277211c8d0
--- /dev/null
+++ b/skills/productivity/microsoft-office/SKILL.md
@@ -0,0 +1,161 @@
+---
+name: microsoft-office
+description: Create, read, and edit Word, PowerPoint, and Excel files.
+version: 2.0.0
+author: Nous Research
+license: MIT
+platforms: [linux, macos, windows]
+metadata:
+ hermes:
+ tags: [office, word, docx, powerpoint, pptx, excel, xlsx, csv, documents, slides, spreadsheets]
+ category: productivity
+ related_skills: [pdf]
+---
+
+# Microsoft Office Skill
+
+Create, read, edit, and template Word (`.docx`), PowerPoint (`.pptx`), and
+Excel (`.xlsx`, `.csv`) files offline with small Python CLIs built on
+python-docx, python-pptx, and openpyxl. Office itself is never needed. It does
+not open legacy binary formats (`.doc`, `.ppt`, `.xls`) and does not render
+pages without LibreOffice.
+
+## When to Use
+
+Pick the format, then read its reference with `skill_view` before working:
+
+| File | Reference | Typical asks |
+| --- | --- | --- |
+| `.docx` | `references/word.md` | reports, letters, contracts, `{{token}}` templates, tracked changes, comments |
+| `.pptx` | `references/powerpoint.md` | pitch decks, brand-template decks, chart refreshes, speaker notes, slide PNGs |
+| `.xlsx`, `.csv` | `references/excel.md` | styled multi-sheet workbooks, formulas, charts, CSV conversion, row/column restructures |
+
+Deeper notes: `references/revisions-and-comments.md` (Word review markup) and
+`references/restructuring.md` (Excel reference shifting).
+
+- Not for `.doc`/`.ppt`/`.xls`: convert first with
+ `soffice --headless --convert-to docx|pptx|xlsx old-file` when LibreOffice is installed.
+- Not for `.odt`/`.odp`/`.ods`, or WYSIWYG layout work.
+
+## Prerequisites
+
+- Python 3.10+ with `python-docx`, `python-pptx`, and `openpyxl` (import names
+ `docx`, `pptx`, `openpyxl`).
+- Pick the interpreter with `terminal`. Use `python` when it already imports
+ the libraries (the Hermes Docker image ships them). Otherwise, when `hermes`
+ is on PATH, let Hermes build its shared, pinned documents environment under
+ the Hermes home: it survives container restarts, never touches the Hermes
+ install itself, and is safe to run from several agents at once. When it is
+ not (the terminal runs in a Docker sandbox, which has no Hermes), the block
+ builds a venv in the sandbox home with the same pinned versions. Use this
+ exact block in every document skill so they all share one environment:
+
+ ```bash
+ python -c "import docx, pptx, openpyxl" 2>/dev/null && PY=python || if command -v hermes >/dev/null 2>&1; then
+ PY="$(hermes pm environment documents --extra documents --extra documents-pdf)"
+ else
+ PY="$HOME/.cache/hermes-docs-venv/bin/python"
+ "$PY" -c "import docx, openpyxl, pptx, reportlab, pypdf, pdfplumber, pypdfium2" 2>/dev/null || (
+ # Safe to run from several agents at once: each caller builds a private venv,
+ # a symlink publishes the first finished one atomically, the others delete theirs.
+ mkdir -p "$HOME/.cache" && cd "$HOME/.cache" && stage="$(mktemp -d hermes-docs-venv.XXXXXX)" || exit 1
+ old="$(readlink hermes-docs-venv)" # an earlier build that no longer imports, if any
+ python3 -m venv "$stage" &&
+ "$stage/bin/python" -m pip install -q --disable-pip-version-check python-docx==1.2.0 openpyxl==3.1.5 python-pptx==1.0.2 reportlab==5.1.0 pypdf==6.21.2 pdfplumber==0.11.10 pypdfium2==5.14.0 &&
+ "$stage/bin/python" -c "import docx, openpyxl, pptx, reportlab, pypdf, pdfplumber, pypdfium2" &&
+ if [ -z "$old" ]; then python3 -c 'import os, sys; os.symlink(*sys.argv[1:])' "$stage" hermes-docs-venv
+ elif [ "$(readlink hermes-docs-venv)" = "$old" ]; then
+ ln -s "$stage" "$stage.lnk" && python3 -c 'import os, sys; os.replace(*sys.argv[1:])' "$stage.lnk" hermes-docs-venv &&
+ case "$old" in hermes-docs-venv.??????) rm -rf "$old" ;; esac
+ fi 2>/dev/null
+ [ "$(readlink hermes-docs-venv)" = "$stage" ] || rm -rf "$stage" "$stage.lnk"
+ )
+ fi
+ export PY
+ "$PY" scripts/docx_create.py --help
+ ```
+
+ Run every helper with `"$PY"`. In PowerShell (Hermes runs on that host, so
+ it is on PATH):
+ `$env:PY = hermes pm environment documents --extra documents --extra documents-pdf`.
+ Never `pip install` into the interpreter that runs Hermes or into the
+ `hermes pm environment` one; Hermes owns both.
+- Optional: LibreOffice (`soffice`) for PDF export, Excel recalculation, and
+ slide rendering, plus poppler (`pdftoppm` or `pdftocairo`) for slide PNGs.
+ The helpers that need them report what is missing and exit 0.
+
+## How to Run
+
+Every helper lives in `scripts/`, is an argparse CLI with `--help`, prints
+JSON to stdout, and exits non-zero on failure. Run them with `terminal` from
+the skill directory. Author JSON specs with `write_file`; read results with
+`read_file` or straight from stdout.
+
+```bash
+"$PY" scripts/docx_create.py spec.json out.docx
+"$PY" scripts/pptx_create.py deck.json out.pptx
+"$PY" scripts/xlsx_create.py spec.json report.xlsx
+```
+
+## Quick Reference
+
+| Task | Word | PowerPoint | Excel |
+| --- | --- | --- | --- |
+| Create from JSON spec | `docx_create.py` | `pptx_create.py` | `xlsx_create.py`, `csv_to_xlsx.py` |
+| Read back | `docx_read.py --text/--structure` | `pptx_read.py --outline` | `xlsx_read.py --sheets/--json` |
+| Edit | `docx_edit.py` | `pptx_edit.py` | `xlsx_edit.py`, `xlsx_restructure.py` |
+| Fill a template | `docx_template.py` | `pptx_from_template.py` | — |
+| Review / check | `docx_revisions.py`, `docx_comments.py`, `docx_validate.py` | `pptx_render.py` (slide PNGs) | `xlsx_recalc.py`, `xlsx_to_csv.py` |
+
+The per-format reference has the full flag table.
+
+## Procedure
+
+1. Identify the format from the file extension or the ask, and load its
+ reference (`skill_view` with `file_path=references/<format>.md`).
+2. Set `PY` with the Prerequisites block once per session.
+3. Create, edit, or read with that format's helpers; pass an output path to
+ keep the original whenever the helper supports one.
+4. Verify the result as the reference's Verification section says, then give
+ the user the exact output path.
+
+## Converting to PDF
+
+When LibreOffice is installed, convert headlessly:
+
+```bash
+soffice --headless --convert-to pdf --outdir out/ file.docx # also .pptx, .xlsx
+soffice --headless --convert-to csv --outdir out/ report.xlsx # first sheet only
+```
+
+Check first with `command -v soffice || command -v libreoffice`. Fonts not on
+the host are substituted, so render-check decks before shipping. There is no
+pure-Python path to PDF for any of these formats: if `soffice` is missing, say
+so rather than approximating. For other sheets use
+`xlsx_to_csv.py --sheet NAME`.
+
+## Pitfalls
+
+- **Never unzip-and-edit the XML.** These files are zip packages; raw text
+ substitution corrupts them. Edit through the helpers (or the libraries) and
+ use `patch`/`write_file` only for JSON inputs.
+- **Text is split into runs.** Word and PowerPoint fragment text at edit
+ boundaries; the replace helpers merge equal-format runs first, but a match
+ across differently formatted runs takes the first run's formatting.
+- **Nothing computes fields or formulas.** Word TOC/page fields and Excel
+ formulas are filled in by the office app on open (or by `xlsx_recalc.py`).
+- **Encoding.** Write specs as UTF-8; the helpers read UTF-8 explicitly.
+- Format-specific traps are in each reference.
+
+## Verification
+
+- Re-read every output with the format's read helper and check the expected
+ content is there and the old content is gone.
+- Word: `docx_validate.py out.docx` exits 0 after revision, comment, or field
+ surgery.
+- PowerPoint: render with `pptx_render.py` and check each PNG with
+ `vision_analyze` when the render tools exist.
+- Excel: `xlsx_read.py --formulas` lists written formulas; run
+ `xlsx_recalc.py` when cached values matter.
+- The bundled tests are the full contract:
+ `"$PY" -m pytest tests/ -q` (needs pytest in that interpreter).
diff --git a/skills/productivity/xlsx/SKILL.md b/skills/productivity/microsoft-office/references/excel.md
similarity index 66%
rename from skills/productivity/xlsx/SKILL.md
rename to skills/productivity/microsoft-office/references/excel.md
index 8475becaae3..e28e6aad623 100644
--- a/skills/productivity/xlsx/SKILL.md
+++ b/skills/productivity/microsoft-office/references/excel.md
@@ -1,18 +1,7 @@
----
-name: xlsx
-description: Create, read, edit Excel .xlsx workbooks and CSVs.
-version: 1.1.0
-author: Nous Research
-license: MIT
-platforms: [linux, macos, windows]
-metadata:
- hermes:
- tags: [excel, spreadsheet, xlsx, csv, openpyxl, productivity]
- category: productivity
- related_skills: [docx, pdf, powerpoint]
----
-
-# Xlsx Skill
+# Excel (.xlsx, .csv)
+
+Run the helpers with `"$PY"` from the Prerequisites block in `SKILL.md`, from the
+skill directory.
Work with Excel .xlsx workbooks using Python and openpyxl: build styled
multi-sheet workbooks with formulas and charts, inspect or dump existing
@@ -36,67 +25,21 @@ scripts are argparse CLIs that print JSON and use explicit UTF-8 I/O.
- Not for the legacy .xls binary format (use LibreOffice to convert
first: `soffice --headless --convert-to xlsx old.xls`).
-## Prerequisites
-
-- Python 3.10+ with `openpyxl`. No other third-party packages are
- needed; everything else is stdlib.
-- Pick the interpreter with `terminal`. Use `python` when it already imports
- the libraries (the Hermes Docker image ships them). Otherwise, when `hermes`
- is on PATH, let Hermes build its shared, pinned documents environment under
- the Hermes home: it survives container restarts, never touches the Hermes
- install itself, and is safe to run from several agents at once. When it is
- not (the terminal runs in a Docker sandbox, which has no Hermes), the block
- builds a venv in the sandbox home with the same pinned versions. Use this
- exact block in every document skill so they all share one environment:
-
- ```bash
- python -c "import openpyxl" 2>/dev/null && PY=python || if command -v hermes >/dev/null 2>&1; then
- PY="$(hermes pm environment documents --extra documents --extra documents-pdf)"
- else
- PY="$HOME/.cache/hermes-docs-venv/bin/python"
- "$PY" -c "import docx, openpyxl, pptx, reportlab, pypdf, pdfplumber, pypdfium2" 2>/dev/null || (
- # Safe to run from several agents at once: each caller builds a private venv,
- # a symlink publishes the first finished one atomically, the others delete theirs.
- mkdir -p "$HOME/.cache" && cd "$HOME/.cache" && stage="$(mktemp -d hermes-docs-venv.XXXXXX)" || exit 1
- old="$(readlink hermes-docs-venv)" # an earlier build that no longer imports, if any
- python3 -m venv "$stage" &&
- "$stage/bin/python" -m pip install -q --disable-pip-version-check python-docx==1.2.0 openpyxl==3.1.5 python-pptx==1.0.2 reportlab==5.1.0 pypdf==6.21.2 pdfplumber==0.11.10 pypdfium2==5.14.0 &&
- "$stage/bin/python" -c "import docx, openpyxl, pptx, reportlab, pypdf, pdfplumber, pypdfium2" &&
- if [ -z "$old" ]; then python3 -c 'import os, sys; os.symlink(*sys.argv[1:])' "$stage" hermes-docs-venv
- elif [ "$(readlink hermes-docs-venv)" = "$old" ]; then
- ln -s "$stage" "$stage.lnk" && python3 -c 'import os, sys; os.replace(*sys.argv[1:])' "$stage.lnk" hermes-docs-venv &&
- case "$old" in hermes-docs-venv.??????) rm -rf "$old" ;; esac
- fi 2>/dev/null
- [ "$(readlink hermes-docs-venv)" = "$stage" ] || rm -rf "$stage" "$stage.lnk"
- )
- fi
- export PY
- "$PY" scripts/xlsx_create.py --help
- ```
-
- Run every helper below with `"$PY"`. In PowerShell (Hermes runs on that
- host, so it is on PATH):
- `$env:PY = hermes pm environment documents --extra documents --extra documents-pdf`.
- Never `pip install` into the interpreter that runs Hermes or into the
- `hermes pm environment` one; Hermes owns both.
-- Optional: LibreOffice (`soffice`) for headless recalculation or
- format conversion.
-
## How to Run
Run the helper scripts with the `terminal` tool from this skill's
`scripts/` directory (every script supports `--help`):
```bash
-python scripts/xlsx_create.py spec.json report.xlsx # build from JSON spec
-python scripts/xlsx_read.py report.xlsx --sheets # inventory
-python scripts/xlsx_read.py report.xlsx --json --sheet Data
-python scripts/xlsx_read.py report.xlsx --formulas
-python scripts/xlsx_edit.py report.xlsx --sheet Data --set B2=42 --recalc
-python scripts/xlsx_restructure.py report.xlsx --sheet Data --insert-rows 3:2
-python scripts/xlsx_recalc.py report.xlsx
-python scripts/csv_to_xlsx.py data.csv out.xlsx --encoding utf-8
-python scripts/xlsx_to_csv.py report.xlsx out.csv --sheet Data
+"$PY" scripts/xlsx_create.py spec.json report.xlsx # build from JSON spec
+"$PY" scripts/xlsx_read.py report.xlsx --sheets # inventory
+"$PY" scripts/xlsx_read.py report.xlsx --json --sheet Data
+"$PY" scripts/xlsx_read.py report.xlsx --formulas
+"$PY" scripts/xlsx_edit.py report.xlsx --sheet Data --set B2=42 --recalc
+"$PY" scripts/xlsx_restructure.py report.xlsx --sheet Data --insert-rows 3:2
+"$PY" scripts/xlsx_recalc.py report.xlsx
+"$PY" scripts/csv_to_xlsx.py data.csv out.xlsx --encoding utf-8
+"$PY" scripts/xlsx_to_csv.py report.xlsx out.csv --sheet Data
```
Author the JSON spec with `write_file`, inspect script JSON output with
@@ -177,20 +120,6 @@ Author the JSON spec with `write_file`, inspect script JSON output with
accept `--encoding` (e.g. `utf-8-sig` for Excel-friendly BOM,
`cp1252` for legacy Windows exports).
-## Converting to PDF
-
-LibreOffice converts headlessly (also works for CSV export of a single
-sheet):
-
-```bash
-soffice --headless --convert-to pdf report.xlsx --outdir out/
-soffice --headless --convert-to csv report.xlsx --outdir out/ # 1st sheet only
-```
-
-Only the first sheet lands in a CSV; for other sheets use
-`xlsx_to_csv.py --sheet NAME`. If `soffice` is missing, install
-LibreOffice or hand the file to the user unconverted.
-
## Pitfalls
- **openpyxl does not calculate.** Formula results are available only
diff --git a/skills/productivity/powerpoint/SKILL.md b/skills/productivity/microsoft-office/references/powerpoint.md
similarity index 66%
rename from skills/productivity/powerpoint/SKILL.md
rename to skills/productivity/microsoft-office/references/powerpoint.md
index f571fb1195f..f64b17127d7 100644
--- a/skills/productivity/powerpoint/SKILL.md
+++ b/skills/productivity/microsoft-office/references/powerpoint.md
@@ -1,18 +1,7 @@
----
-name: powerpoint
-description: Create, read, edit .pptx decks with python-pptx.
-version: 1.1.0
-author: Nous Research
-license: MIT
-platforms: [linux, macos, windows]
-metadata:
- hermes:
- tags: [pptx, powerpoint, presentations, slides, office, python-pptx]
- category: productivity
- related_skills: [docx, xlsx, pdf]
----
+# PowerPoint (.pptx)
-# Powerpoint Skill
+Run the helpers with `"$PY"` from the Prerequisites block in `SKILL.md`, from the
+skill directory.
Create, inspect, and edit PowerPoint (.pptx) presentations using the
python-pptx library. Five helper scripts cover deck creation from a JSON
@@ -31,72 +20,22 @@ and slide rendering — all offline, no PowerPoint installation required.
- Do NOT use this for .ppt (legacy binary) files — convert them first with
`soffice --convert-to pptx old.ppt` if LibreOffice is available.
-## Prerequisites
-
-- Python 3.10+ with `python-pptx` (import name `pptx`).
-- Pick the interpreter with `terminal`. Use `python` when it already imports
- the libraries (the Hermes Docker image ships them). Otherwise, when `hermes`
- is on PATH, let Hermes build its shared, pinned documents environment under
- the Hermes home: it survives container restarts, never touches the Hermes
- install itself, and is safe to run from several agents at once. When it is
- not (the terminal runs in a Docker sandbox, which has no Hermes), the block
- builds a venv in the sandbox home with the same pinned versions. Use this
- exact block in every document skill so they all share one environment:
-
- ```bash
- python -c "import pptx" 2>/dev/null && PY=python || if command -v hermes >/dev/null 2>&1; then
- PY="$(hermes pm environment documents --extra documents --extra documents-pdf)"
- else
- PY="$HOME/.cache/hermes-docs-venv/bin/python"
- "$PY" -c "import docx, openpyxl, pptx, reportlab, pypdf, pdfplumber, pypdfium2" 2>/dev/null || (
- # Safe to run from several agents at once: each caller builds a private venv,
- # a symlink publishes the first finished one atomically, the others delete theirs.
- mkdir -p "$HOME/.cache" && cd "$HOME/.cache" && stage="$(mktemp -d hermes-docs-venv.XXXXXX)" || exit 1
- old="$(readlink hermes-docs-venv)" # an earlier build that no longer imports, if any
- python3 -m venv "$stage" &&
- "$stage/bin/python" -m pip install -q --disable-pip-version-check python-docx==1.2.0 openpyxl==3.1.5 python-pptx==1.0.2 reportlab==5.1.0 pypdf==6.21.2 pdfplumber==0.11.10 pypdfium2==5.14.0 &&
- "$stage/bin/python" -c "import docx, openpyxl, pptx, reportlab, pypdf, pdfplumber, pypdfium2" &&
- if [ -z "$old" ]; then python3 -c 'import os, sys; os.symlink(*sys.argv[1:])' "$stage" hermes-docs-venv
- elif [ "$(readlink hermes-docs-venv)" = "$old" ]; then
- ln -s "$stage" "$stage.lnk" && python3 -c 'import os, sys; os.replace(*sys.argv[1:])' "$stage.lnk" hermes-docs-venv &&
- case "$old" in hermes-docs-venv.??????) rm -rf "$old" ;; esac
- fi 2>/dev/null
- [ "$(readlink hermes-docs-venv)" = "$stage" ] || rm -rf "$stage" "$stage.lnk"
- )
- fi
- export PY
- "$PY" scripts/pptx_create.py --help
- ```
-
- Run every helper below with `"$PY"`. In PowerShell (Hermes runs on that
- host, so it is on PATH):
- `$env:PY = hermes pm environment documents --extra documents --extra documents-pdf`.
- Never `pip install` into the interpreter that runs Hermes or into the
- `hermes pm environment` one; Hermes owns both.
-- Optional: LibreOffice (`soffice`) plus poppler (`pdftoppm` or
- `pdftocairo`) for rendering slides to PNGs and for PDF export.
- `pptx_render.py` detects both with `shutil.which` and degrades
- gracefully (reports `{"rendered": false, "missing": [...]}`, exit 0)
- when absent — all create/read/edit operations work without them.
-- Check availability via `terminal`:
- `"$PY" -c "import pptx; print(pptx.__version__)"` and `which soffice pdftoppm`.
-
## How to Run
All scripts live in `scripts/`, take `--help`, print JSON to stdout, and
exit non-zero on failure. Run them with `terminal`:
```bash
-python scripts/pptx_create.py deck.json out.pptx
-python scripts/pptx_read.py deck.pptx --outline # full JSON outline
-python scripts/pptx_read.py deck.pptx --notes # speaker notes
-python scripts/pptx_read.py deck.pptx --images ./img # export pictures
-python scripts/pptx_edit.py deck.pptx --replace-text "Old Corp" "New Corp"
-python scripts/pptx_edit.py deck.pptx --chart-data update.json
-python scripts/pptx_edit.py deck.pptx --duplicate-slide 2
-python scripts/pptx_edit.py deck.pptx --remove-slide 3 --move-slide 2 0
-python scripts/pptx_from_template.py brand.pptx out.pptx --values vals.json
-python scripts/pptx_render.py deck.pptx --outdir ./render # slide PNGs
+"$PY" scripts/pptx_create.py deck.json out.pptx
+"$PY" scripts/pptx_read.py deck.pptx --outline # full JSON outline
+"$PY" scripts/pptx_read.py deck.pptx --notes # speaker notes
+"$PY" scripts/pptx_read.py deck.pptx --images ./img # export pictures
+"$PY" scripts/pptx_edit.py deck.pptx --replace-text "Old Corp" "New Corp"
+"$PY" scripts/pptx_edit.py deck.pptx --chart-data update.json
+"$PY" scripts/pptx_edit.py deck.pptx --duplicate-slide 2
+"$PY" scripts/pptx_edit.py deck.pptx --remove-slide 3 --move-slide 2 0
+"$PY" scripts/pptx_from_template.py brand.pptx out.pptx --values vals.json
+"$PY" scripts/pptx_render.py deck.pptx --outdir ./render # slide PNGs
```
Author JSON specs with `write_file`; inspect script output and generated
@@ -196,19 +135,6 @@ each with `vision_analyze`. When either tool is missing the script exits
the JSON outline from `pptx_read.py`, which verifies content and
structure, just not visuals.
-## Converting to PDF
-
-If LibreOffice is installed, export the finished deck to PDF directly:
-
-```bash
-soffice --headless --convert-to pdf --outdir ./out deck.pptx
-```
-
-The output lands at `./out/deck.pdf`. Fonts not installed on the host are
-substituted, so render-verify (Procedure step 5) before shipping the PDF.
-There is no offline pure-Python .pptx→PDF path; if `soffice` is absent,
-say so rather than approximating.
-
## Pitfalls
- **Run splitting**: PowerPoint fragments paragraph text into runs at
diff --git a/skills/productivity/xlsx/references/restructuring.md b/skills/productivity/microsoft-office/references/restructuring.md
similarity index 100%
rename from skills/productivity/xlsx/references/restructuring.md
rename to skills/productivity/microsoft-office/references/restructuring.md
diff --git a/skills/productivity/docx/references/revisions-and-comments.md b/skills/productivity/microsoft-office/references/revisions-and-comments.md
similarity index 100%
rename from skills/productivity/docx/references/revisions-and-comments.md
rename to skills/productivity/microsoft-office/references/revisions-and-comments.md
diff --git a/skills/productivity/docx/SKILL.md b/skills/productivity/microsoft-office/references/word.md
similarity index 68%
rename from skills/productivity/docx/SKILL.md
rename to skills/productivity/microsoft-office/references/word.md
index 67357e238dd..db76d18943c 100644
--- a/skills/productivity/docx/SKILL.md
+++ b/skills/productivity/microsoft-office/references/word.md
@@ -1,25 +1,14 @@
----
-name: docx
-description: Create, read, edit, template, and review Word .docx files.
-version: 1.1.0
-author: Nous Research
-license: MIT
-platforms: [linux, macos, windows]
-metadata:
- hermes:
- tags: [word, docx, documents, office, templates, revisions, comments]
- category: productivity
- related_skills: [pdf, xlsx, powerpoint]
----
+# Word (.docx)
-# Docx Skill
+Run the helpers with `"$PY"` from the Prerequisites block in `SKILL.md`, from the
+skill directory.
Create, read, edit, and template Microsoft Word `.docx` files with
python-docx via small CLIs. It handles text, styles, lists, tables,
images, headers/footers, `{{token}}` templating, tracked changes
(list/accept/reject), comments (list/add/delete), TOC and page-number
fields, and package health checks. It does not render documents itself
-(PDF needs LibreOffice — see Converting to PDF) or edit legacy `.doc`.
+(PDF needs LibreOffice — see Converting to PDF in SKILL.md) or edit legacy `.doc`.
## When to Use
@@ -34,65 +23,19 @@ fields, and package health checks. It does not render documents itself
- The document needs a table of contents or "Page X of Y" footers.
- Not for: `.doc` (legacy), `.odt`, or WYSIWYG layout work.
-## Prerequisites
-
-- Python 3.10+ with `python-docx` (import name `docx`; lxml comes with it).
-- Pick the interpreter with `terminal`. Use `python` when it already imports
- the libraries (the Hermes Docker image ships them). Otherwise, when `hermes`
- is on PATH, let Hermes build its shared, pinned documents environment under
- the Hermes home: it survives container restarts, never touches the Hermes
- install itself, and is safe to run from several agents at once. When it is
- not (the terminal runs in a Docker sandbox, which has no Hermes), the block
- builds a venv in the sandbox home with the same pinned versions. Use this
- exact block in every document skill so they all share one environment:
-
- ```bash
- python -c "import docx" 2>/dev/null && PY=python || if command -v hermes >/dev/null 2>&1; then
- PY="$(hermes pm environment documents --extra documents --extra documents-pdf)"
- else
- PY="$HOME/.cache/hermes-docs-venv/bin/python"
- "$PY" -c "import docx, openpyxl, pptx, reportlab, pypdf, pdfplumber, pypdfium2" 2>/dev/null || (
- # Safe to run from several agents at once: each caller builds a private venv,
- # a symlink publishes the first finished one atomically, the others delete theirs.
- mkdir -p "$HOME/.cache" && cd "$HOME/.cache" && stage="$(mktemp -d hermes-docs-venv.XXXXXX)" || exit 1
- old="$(readlink hermes-docs-venv)" # an earlier build that no longer imports, if any
- python3 -m venv "$stage" &&
- "$stage/bin/python" -m pip install -q --disable-pip-version-check python-docx==1.2.0 openpyxl==3.1.5 python-pptx==1.0.2 reportlab==5.1.0 pypdf==6.21.2 pdfplumber==0.11.10 pypdfium2==5.14.0 &&
- "$stage/bin/python" -c "import docx, openpyxl, pptx, reportlab, pypdf, pdfplumber, pypdfium2" &&
- if [ -z "$old" ]; then python3 -c 'import os, sys; os.symlink(*sys.argv[1:])' "$stage" hermes-docs-venv
- elif [ "$(readlink hermes-docs-venv)" = "$old" ]; then
- ln -s "$stage" "$stage.lnk" && python3 -c 'import os, sys; os.replace(*sys.argv[1:])' "$stage.lnk" hermes-docs-venv &&
- case "$old" in hermes-docs-venv.??????) rm -rf "$old" ;; esac
- fi 2>/dev/null
- [ "$(readlink hermes-docs-venv)" = "$stage" ] || rm -rf "$stage" "$stage.lnk"
- )
- fi
- export PY
- "$PY" scripts/docx_create.py --help
- ```
-
- Run every helper below with `"$PY"`. In PowerShell (Hermes runs on that
- host, so it is on PATH):
- `$env:PY = hermes pm environment documents --extra documents --extra documents-pdf`.
- Never `pip install` into the interpreter that runs Hermes or into the
- `hermes pm environment` one; Hermes owns both.
-- Comments `add` uses the native API on python-docx >= 1.2 and an XML
- fallback on older versions — both are automatic.
-- For image blocks: the image files must exist locally (PNG/JPEG).
-
## How to Run
-All helpers live in `scripts/` next to this file. Run them with the
+All helpers live in the skill's `scripts/` directory. Run them with the
`terminal` tool; each supports `--help` and prints JSON to stdout.
```bash
-python scripts/docx_create.py spec.json out.docx
-python scripts/docx_read.py out.docx --text
-python scripts/docx_edit.py replace out.docx --find old --replace new
-python scripts/docx_template.py tpl.docx values.json filled.docx
-python scripts/docx_revisions.py list out.docx
-python scripts/docx_comments.py list out.docx
-python scripts/docx_validate.py out.docx
+"$PY" scripts/docx_create.py spec.json out.docx
+"$PY" scripts/docx_read.py out.docx --text
+"$PY" scripts/docx_edit.py replace out.docx --find old --replace new
+"$PY" scripts/docx_template.py tpl.docx values.json filled.docx
+"$PY" scripts/docx_revisions.py list out.docx
+"$PY" scripts/docx_comments.py list out.docx
+"$PY" scripts/docx_validate.py out.docx
```
## Quick Reference
@@ -167,19 +110,6 @@ python scripts/docx_validate.py out.docx
`--structure`, and run `docx_validate.py` on anything you produced
via revision/comment surgery.
-## Converting to PDF
-
-No script needed. When LibreOffice is installed, convert headlessly:
-
-```bash
-soffice --headless --convert-to pdf --outdir outdir/ file.docx
-```
-
-Check availability first (`command -v soffice || command -v
-libreoffice`). If neither exists, tell the user PDF conversion is
-unavailable in this environment rather than improvising — python-docx
-cannot render PDFs, and layout fidelity requires a real renderer.
-
## Pitfalls
- **Tokens split across runs.** Word often fragments text into several
diff --git a/skills/productivity/xlsx/scripts/csv_to_xlsx.py b/skills/productivity/microsoft-office/scripts/csv_to_xlsx.py
similarity index 100%
rename from skills/productivity/xlsx/scripts/csv_to_xlsx.py
rename to skills/productivity/microsoft-office/scripts/csv_to_xlsx.py
diff --git a/skills/productivity/docx/scripts/docx_comments.py b/skills/productivity/microsoft-office/scripts/docx_comments.py
similarity index 100%
rename from skills/productivity/docx/scripts/docx_comments.py
rename to skills/productivity/microsoft-office/scripts/docx_comments.py
diff --git a/skills/productivity/docx/scripts/docx_common.py b/skills/productivity/microsoft-office/scripts/docx_common.py
similarity index 100%
rename from skills/productivity/docx/scripts/docx_common.py
rename to skills/productivity/microsoft-office/scripts/docx_common.py
diff --git a/skills/productivity/docx/scripts/docx_create.py b/skills/productivity/microsoft-office/scripts/docx_create.py
similarity index 100%
rename from skills/productivity/docx/scripts/docx_create.py
rename to skills/productivity/microsoft-office/scripts/docx_create.py
diff --git a/skills/productivity/docx/scripts/docx_edit.py b/skills/productivity/microsoft-office/scripts/docx_edit.py
similarity index 100%
rename from skills/productivity/docx/scripts/docx_edit.py
rename to skills/productivity/microsoft-office/scripts/docx_edit.py
diff --git a/skills/productivity/docx/scripts/docx_read.py b/skills/productivity/microsoft-office/scripts/docx_read.py
similarity index 100%
rename from skills/productivity/docx/scripts/docx_read.py
rename to skills/productivity/microsoft-office/scripts/docx_read.py
diff --git a/skills/productivity/docx/scripts/docx_revisions.py b/skills/productivity/microsoft-office/scripts/docx_revisions.py
similarity index 100%
rename from skills/productivity/docx/scripts/docx_revisions.py
rename to skills/productivity/microsoft-office/scripts/docx_revisions.py
diff --git a/skills/productivity/docx/scripts/docx_template.py b/skills/productivity/microsoft-office/scripts/docx_template.py
similarity index 100%
rename from skills/productivity/docx/scripts/docx_template.py
rename to skills/productivity/microsoft-office/scripts/docx_template.py
diff --git a/skills/productivity/docx/scripts/docx_validate.py b/skills/productivity/microsoft-office/scripts/docx_validate.py
similarity index 100%
rename from skills/productivity/docx/scripts/docx_validate.py
rename to skills/productivity/microsoft-office/scripts/docx_validate.py
diff --git a/skills/productivity/powerpoint/scripts/pptx_create.py b/skills/productivity/microsoft-office/scripts/pptx_create.py
similarity index 100%
rename from skills/productivity/powerpoint/scripts/pptx_create.py
rename to skills/productivity/microsoft-office/scripts/pptx_create.py
diff --git a/skills/productivity/powerpoint/scripts/pptx_edit.py b/skills/productivity/microsoft-office/scripts/pptx_edit.py
similarity index 100%
rename from skills/productivity/powerpoint/scripts/pptx_edit.py
rename to skills/productivity/microsoft-office/scripts/pptx_edit.py
diff --git a/skills/productivity/powerpoint/scripts/pptx_from_template.py b/skills/productivity/microsoft-office/scripts/pptx_from_template.py
similarity index 100%
rename from skills/productivity/powerpoint/scripts/pptx_from_template.py
rename to skills/productivity/microsoft-office/scripts/pptx_from_template.py
diff --git a/skills/productivity/powerpoint/scripts/pptx_read.py b/skills/productivity/microsoft-office/scripts/pptx_read.py
similarity index 100%
rename from skills/productivity/powerpoint/scripts/pptx_read.py
rename to skills/productivity/microsoft-office/scripts/pptx_read.py
diff --git a/skills/productivity/powerpoint/scripts/pptx_render.py b/skills/productivity/microsoft-office/scripts/pptx_render.py
similarity index 100%
rename from skills/productivity/powerpoint/scripts/pptx_render.py
rename to skills/productivity/microsoft-office/scripts/pptx_render.py
diff --git a/skills/productivity/xlsx/scripts/xlsx_create.py b/skills/productivity/microsoft-office/scripts/xlsx_create.py
similarity index 100%
rename from skills/productivity/xlsx/scripts/xlsx_create.py
rename to skills/productivity/microsoft-office/scripts/xlsx_create.py
diff --git a/skills/productivity/xlsx/scripts/xlsx_edit.py b/skills/productivity/microsoft-office/scripts/xlsx_edit.py
similarity index 100%
rename from skills/productivity/xlsx/scripts/xlsx_edit.py
rename to skills/productivity/microsoft-office/scripts/xlsx_edit.py
diff --git a/skills/productivity/xlsx/scripts/xlsx_read.py b/skills/productivity/microsoft-office/scripts/xlsx_read.py
similarity index 100%
rename from skills/productivity/xlsx/scripts/xlsx_read.py
rename to skills/productivity/microsoft-office/scripts/xlsx_read.py
diff --git a/skills/productivity/xlsx/scripts/xlsx_recalc.py b/skills/productivity/microsoft-office/scripts/xlsx_recalc.py
similarity index 100%
rename from skills/productivity/xlsx/scripts/xlsx_recalc.py
rename to skills/productivity/microsoft-office/scripts/xlsx_recalc.py
diff --git a/skills/productivity/xlsx/scripts/xlsx_restructure.py b/skills/productivity/microsoft-office/scripts/xlsx_restructure.py
similarity index 100%
rename from skills/productivity/xlsx/scripts/xlsx_restructure.py
rename to skills/productivity/microsoft-office/scripts/xlsx_restructure.py
diff --git a/skills/productivity/xlsx/scripts/xlsx_to_csv.py b/skills/productivity/microsoft-office/scripts/xlsx_to_csv.py
similarity index 100%
rename from skills/productivity/xlsx/scripts/xlsx_to_csv.py
rename to skills/productivity/microsoft-office/scripts/xlsx_to_csv.py
diff --git a/skills/productivity/docx/tests/test_docx_skill.py b/skills/productivity/microsoft-office/tests/test_docx_skill.py
similarity index 100%
rename from skills/productivity/docx/tests/test_docx_skill.py
rename to skills/productivity/microsoft-office/tests/test_docx_skill.py
diff --git a/skills/productivity/powerpoint/tests/test_powerpoint_skill.py b/skills/productivity/microsoft-office/tests/test_powerpoint_skill.py
similarity index 100%
rename from skills/productivity/powerpoint/tests/test_powerpoint_skill.py
rename to skills/productivity/microsoft-office/tests/test_powerpoint_skill.py
diff --git a/skills/productivity/xlsx/tests/test_xlsx_skill.py b/skills/productivity/microsoft-office/tests/test_xlsx_skill.py
similarity index 100%
rename from skills/productivity/xlsx/tests/test_xlsx_skill.py
rename to skills/productivity/microsoft-office/tests/test_xlsx_skill.py
diff --git a/skills/productivity/pdf/SKILL.md b/skills/productivity/pdf/SKILL.md
index 94b2562d664..b67535768c0 100644
--- a/skills/productivity/pdf/SKILL.md
+++ b/skills/productivity/pdf/SKILL.md
@@ -9,7 +9,7 @@ metadata:
hermes:
tags: [pdf, documents, forms, ocr, text-extraction, reportlab, pypdf, pdfplumber, pymupdf, marker]
category: productivity
- related_skills: [docx, xlsx, powerpoint]
+ related_skills: [microsoft-office]
---
# PDF Skill
diff --git a/skills/productivity/pdf/references/ocr-extraction.md b/skills/productivity/pdf/references/ocr-extraction.md
index b63e999fa6f..15fbf9cd3da 100644
--- a/skills/productivity/pdf/references/ocr-extraction.md
+++ b/skills/productivity/pdf/references/ocr-extraction.md
@@ -3,8 +3,8 @@
Scripts referenced below live in this skill's scripts/ directory.
# PDF & Document Extraction
-For DOCX: see the `docx` skill (create/edit) or use `python-docx` for structured reads.
-For PPTX: see the `powerpoint` skill (full create/read/edit support).
+For DOCX: see the `microsoft-office` skill (create/edit) or use `python-docx` for structured reads.
+For PPTX: see the `microsoft-office` skill (full create/read/edit support).
For PDF manipulation (merge, split, forms, watermarks, creation): see the `pdf` skill.
This skill covers **text extraction from PDFs and scanned documents**.
@@ -204,5 +204,5 @@ No extra dependencies needed — pymupdf covers split, merge, search, and text e
- marker-pdf is for OCR, scanned docs, equations, complex layouts — install only when needed
- Both helper scripts accept `--help` for full usage
- marker-pdf downloads ~2.5GB of models to `~/.cache/huggingface/` on first use
-- For Word docs: python-docx via the docx skill's `"$PY"` setup block (better than OCR — parses actual structure)
-- For PowerPoint: see the `powerpoint` skill (uses python-pptx)
+- For Word docs: python-docx via the microsoft-office skill's `"$PY"` setup block (better than OCR — parses actual structure)
+- For PowerPoint: see the `microsoft-office` skill (uses python-pptx)
diff --git a/skills/productivity/powerpoint/LICENSE b/skills/productivity/powerpoint/LICENSE
deleted file mode 100644
index 0dddbf16707..00000000000
--- a/skills/productivity/powerpoint/LICENSE
+++ /dev/null
@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2026 Nous Research
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in
-all copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-THE SOFTWARE.
diff --git a/skills/productivity/xlsx/LICENSE b/skills/productivity/xlsx/LICENSE
deleted file mode 100644
index 0dddbf16707..00000000000
--- a/skills/productivity/xlsx/LICENSE
+++ /dev/null
@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2026 Nous Research
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in
-all copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-THE SOFTWARE.
diff --git a/skills/research/grounded-citations/references/citation-formats.md b/skills/research/grounded-citations/references/citation-formats.md
index cf7d3f7f5b0..038ea1be89c 100644
--- a/skills/research/grounded-citations/references/citation-formats.md
+++ b/skills/research/grounded-citations/references/citation-formats.md
@@ -27,14 +27,14 @@ numeric markers and emit an endnotes section. For a bibliography-shaped report,
Do not mix: either numeric `[n]` + a Sources section, or `\cite{}` + BibTeX.
Two numbering systems in one document is worse than none.
-## Word (.docx, `docx` skill)
+## Word (.docx, `microsoft-office` skill)
Real footnotes are preferred over inline brackets in prose documents intended
for human editing — reviewers expect Word footnotes. Keep the ledger ids as the
footnote numbers so `verify` still works on a markdown source-of-truth, and
generate the .docx from that markdown.
-## Slides (.pptx, `powerpoint` skill)
+## Slides (.pptx, `microsoft-office` skill)
Inline `[n]` in the bullet, one "Sources" slide at the end rendered with
`--style plain`. Never put a URL in a body bullet — it wrecks the layout and
diff --git a/tools/file_tools_write_guards.py b/tools/file_tools_write_guards.py
index 32b4b31d6e0..1ef4aa8fe69 100644
--- a/tools/file_tools_write_guards.py
+++ b/tools/file_tools_write_guards.py
@@ -500,7 +500,7 @@ def _check_binary_document_write(filepath: str, task_id: str = "default") -> str
f"Refusing to write plain text to binary document '{filepath}' ({ext}). "
"A text write cannot produce a valid document container and would "
"corrupt the file (read_file showed you EXTRACTED text, not the real "
- "bytes). Use the docx/xlsx/powerpoint skills or a library like "
+ "bytes). Use the microsoft-office skill or a library like "
"python-docx/openpyxl/python-pptx via the terminal to create or edit "
"this document.")
# A -wal/-shm/-journal path is never a legitimate text target, even when
diff --git a/website/docs/user-guide/features/deliverable-mode.md b/website/docs/user-guide/features/deliverable-mode.md
index ea042049b33..dc35c889ed2 100644
--- a/website/docs/user-guide/features/deliverable-mode.md
+++ b/website/docs/user-guide/features/deliverable-mode.md
@@ -22,9 +22,8 @@ file natively.
Three pieces fit together:
1. **The agent has tools that produce files.** `execute_code` for charts via
- matplotlib, the `docx` skill for Word documents, the `xlsx` skill for
- spreadsheets, the `pdf` and `latex-pdf-report` skills for PDFs, the
- `powerpoint` skill for decks, `image_generate` for images,
+ matplotlib, the `microsoft-office` skill for Word documents, spreadsheets
+ and decks, the `pdf` and `latex-pdf-report` skills for PDFs, `image_generate` for images,
`text_to_speech` for audio, and so on.
2. **The gateway scans agent responses for file paths.** Any absolute path