The agent that grows with you
Python aiai-agentai-agentsanthropicchatgptclaudeclaude-codecodexhermeshermes-agentllmnous-researchopenai
refactor(skills): fold docx, powerpoint and xlsx into one microsoft-office skill
Teknium6fdc365d4bf9
diff --git a/Dockerfile b/Dockerfileindex 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.mdindex 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 Construction1. **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 formatting3. **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.mdindex 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, pinneddocuments environment under the Hermes home (safe to run from several agentsat once); in a Docker sandbox without Hermes the block builds a venv in thesandbox 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 thatruns Hermes:```bashdiff --git a/optional-skills/finance/pptx-author/SKILL.md b/optional-skills/finance/pptx-author/SKILL.mdindex 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 aAdapted 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, pinneddocuments environment under the Hermes home (safe to run from several agentsat once); in a Docker sandbox without Hermes the block builds a venv in thesandbox 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 thatruns 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.## Attributiondiff --git a/skills/productivity/document-to-action-items/SKILL.md b/skills/productivity/document-to-action-items/SKILL.mdindex 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 Usediff --git a/skills/productivity/docx/LICENSE b/skills/productivity/microsoft-office/LICENSEsimilarity index 100%rename from skills/productivity/docx/LICENSErename to skills/productivity/microsoft-office/LICENSEdiff --git a/skills/productivity/microsoft-office/SKILL.md b/skills/productivity/microsoft-office/SKILL.mdnew file mode 100644index 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.mdsimilarity index 66%rename from skills/productivity/xlsx/SKILL.mdrename to skills/productivity/microsoft-office/references/excel.mdindex 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 styledmulti-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 convertfirst: `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 RunRun 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 withaccept `--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 onlydiff --git a/skills/productivity/powerpoint/SKILL.md b/skills/productivity/microsoft-office/references/powerpoint.mdsimilarity index 66%rename from skills/productivity/powerpoint/SKILL.mdrename to skills/productivity/microsoft-office/references/powerpoint.mdindex 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 thepython-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 RunAll scripts live in `scripts/`, take `--help`, print JSON to stdout, andexit 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 exitsthe JSON outline from `pptx_read.py`, which verifies content andstructure, 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 atdiff --git a/skills/productivity/xlsx/references/restructuring.md b/skills/productivity/microsoft-office/references/restructuring.mdsimilarity index 100%rename from skills/productivity/xlsx/references/restructuring.mdrename to skills/productivity/microsoft-office/references/restructuring.mddiff --git a/skills/productivity/docx/references/revisions-and-comments.md b/skills/productivity/microsoft-office/references/revisions-and-comments.mdsimilarity index 100%rename from skills/productivity/docx/references/revisions-and-comments.mdrename to skills/productivity/microsoft-office/references/revisions-and-comments.mddiff --git a/skills/productivity/docx/SKILL.md b/skills/productivity/microsoft-office/references/word.mdsimilarity index 68%rename from skills/productivity/docx/SKILL.mdrename to skills/productivity/microsoft-office/references/word.mdindex 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 withpython-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-numberfields, 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 producedvia 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 severaldiff --git a/skills/productivity/xlsx/scripts/csv_to_xlsx.py b/skills/productivity/microsoft-office/scripts/csv_to_xlsx.pysimilarity index 100%rename from skills/productivity/xlsx/scripts/csv_to_xlsx.pyrename to skills/productivity/microsoft-office/scripts/csv_to_xlsx.pydiff --git a/skills/productivity/docx/scripts/docx_comments.py b/skills/productivity/microsoft-office/scripts/docx_comments.pysimilarity index 100%rename from skills/productivity/docx/scripts/docx_comments.pyrename to skills/productivity/microsoft-office/scripts/docx_comments.pydiff --git a/skills/productivity/docx/scripts/docx_common.py b/skills/productivity/microsoft-office/scripts/docx_common.pysimilarity index 100%rename from skills/productivity/docx/scripts/docx_common.pyrename to skills/productivity/microsoft-office/scripts/docx_common.pydiff --git a/skills/productivity/docx/scripts/docx_create.py b/skills/productivity/microsoft-office/scripts/docx_create.pysimilarity index 100%rename from skills/productivity/docx/scripts/docx_create.pyrename to skills/productivity/microsoft-office/scripts/docx_create.pydiff --git a/skills/productivity/docx/scripts/docx_edit.py b/skills/productivity/microsoft-office/scripts/docx_edit.pysimilarity index 100%rename from skills/productivity/docx/scripts/docx_edit.pyrename to skills/productivity/microsoft-office/scripts/docx_edit.pydiff --git a/skills/productivity/docx/scripts/docx_read.py b/skills/productivity/microsoft-office/scripts/docx_read.pysimilarity index 100%rename from skills/productivity/docx/scripts/docx_read.pyrename to skills/productivity/microsoft-office/scripts/docx_read.pydiff --git a/skills/productivity/docx/scripts/docx_revisions.py b/skills/productivity/microsoft-office/scripts/docx_revisions.pysimilarity index 100%rename from skills/productivity/docx/scripts/docx_revisions.pyrename to skills/productivity/microsoft-office/scripts/docx_revisions.pydiff --git a/skills/productivity/docx/scripts/docx_template.py b/skills/productivity/microsoft-office/scripts/docx_template.pysimilarity index 100%rename from skills/productivity/docx/scripts/docx_template.pyrename to skills/productivity/microsoft-office/scripts/docx_template.pydiff --git a/skills/productivity/docx/scripts/docx_validate.py b/skills/productivity/microsoft-office/scripts/docx_validate.pysimilarity index 100%rename from skills/productivity/docx/scripts/docx_validate.pyrename to skills/productivity/microsoft-office/scripts/docx_validate.pydiff --git a/skills/productivity/powerpoint/scripts/pptx_create.py b/skills/productivity/microsoft-office/scripts/pptx_create.pysimilarity index 100%rename from skills/productivity/powerpoint/scripts/pptx_create.pyrename to skills/productivity/microsoft-office/scripts/pptx_create.pydiff --git a/skills/productivity/powerpoint/scripts/pptx_edit.py b/skills/productivity/microsoft-office/scripts/pptx_edit.pysimilarity index 100%rename from skills/productivity/powerpoint/scripts/pptx_edit.pyrename to skills/productivity/microsoft-office/scripts/pptx_edit.pydiff --git a/skills/productivity/powerpoint/scripts/pptx_from_template.py b/skills/productivity/microsoft-office/scripts/pptx_from_template.pysimilarity index 100%rename from skills/productivity/powerpoint/scripts/pptx_from_template.pyrename to skills/productivity/microsoft-office/scripts/pptx_from_template.pydiff --git a/skills/productivity/powerpoint/scripts/pptx_read.py b/skills/productivity/microsoft-office/scripts/pptx_read.pysimilarity index 100%rename from skills/productivity/powerpoint/scripts/pptx_read.pyrename to skills/productivity/microsoft-office/scripts/pptx_read.pydiff --git a/skills/productivity/powerpoint/scripts/pptx_render.py b/skills/productivity/microsoft-office/scripts/pptx_render.pysimilarity index 100%rename from skills/productivity/powerpoint/scripts/pptx_render.pyrename to skills/productivity/microsoft-office/scripts/pptx_render.pydiff --git a/skills/productivity/xlsx/scripts/xlsx_create.py b/skills/productivity/microsoft-office/scripts/xlsx_create.pysimilarity index 100%rename from skills/productivity/xlsx/scripts/xlsx_create.pyrename to skills/productivity/microsoft-office/scripts/xlsx_create.pydiff --git a/skills/productivity/xlsx/scripts/xlsx_edit.py b/skills/productivity/microsoft-office/scripts/xlsx_edit.pysimilarity index 100%rename from skills/productivity/xlsx/scripts/xlsx_edit.pyrename to skills/productivity/microsoft-office/scripts/xlsx_edit.pydiff --git a/skills/productivity/xlsx/scripts/xlsx_read.py b/skills/productivity/microsoft-office/scripts/xlsx_read.pysimilarity index 100%rename from skills/productivity/xlsx/scripts/xlsx_read.pyrename to skills/productivity/microsoft-office/scripts/xlsx_read.pydiff --git a/skills/productivity/xlsx/scripts/xlsx_recalc.py b/skills/productivity/microsoft-office/scripts/xlsx_recalc.pysimilarity index 100%rename from skills/productivity/xlsx/scripts/xlsx_recalc.pyrename to skills/productivity/microsoft-office/scripts/xlsx_recalc.pydiff --git a/skills/productivity/xlsx/scripts/xlsx_restructure.py b/skills/productivity/microsoft-office/scripts/xlsx_restructure.pysimilarity index 100%rename from skills/productivity/xlsx/scripts/xlsx_restructure.pyrename to skills/productivity/microsoft-office/scripts/xlsx_restructure.pydiff --git a/skills/productivity/xlsx/scripts/xlsx_to_csv.py b/skills/productivity/microsoft-office/scripts/xlsx_to_csv.pysimilarity index 100%rename from skills/productivity/xlsx/scripts/xlsx_to_csv.pyrename to skills/productivity/microsoft-office/scripts/xlsx_to_csv.pydiff --git a/skills/productivity/docx/tests/test_docx_skill.py b/skills/productivity/microsoft-office/tests/test_docx_skill.pysimilarity index 100%rename from skills/productivity/docx/tests/test_docx_skill.pyrename to skills/productivity/microsoft-office/tests/test_docx_skill.pydiff --git a/skills/productivity/powerpoint/tests/test_powerpoint_skill.py b/skills/productivity/microsoft-office/tests/test_powerpoint_skill.pysimilarity index 100%rename from skills/productivity/powerpoint/tests/test_powerpoint_skill.pyrename to skills/productivity/microsoft-office/tests/test_powerpoint_skill.pydiff --git a/skills/productivity/xlsx/tests/test_xlsx_skill.py b/skills/productivity/microsoft-office/tests/test_xlsx_skill.pysimilarity index 100%rename from skills/productivity/xlsx/tests/test_xlsx_skill.pyrename to skills/productivity/microsoft-office/tests/test_xlsx_skill.pydiff --git a/skills/productivity/pdf/SKILL.md b/skills/productivity/pdf/SKILL.mdindex 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 Skilldiff --git a/skills/productivity/pdf/references/ocr-extraction.md b/skills/productivity/pdf/references/ocr-extraction.mdindex 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/LICENSEdeleted file mode 100644index 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/LICENSEdeleted file mode 100644index 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.mdindex 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 intendedfor human editing — reviewers expect Word footnotes. Keep the ledger ids as thefootnote numbers so `verify` still works on a markdown source-of-truth, andgenerate 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 anddiff --git a/tools/file_tools_write_guards.py b/tools/file_tools_write_guards.pyindex 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") -> strf"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 whendiff --git a/website/docs/user-guide/features/deliverable-mode.md b/website/docs/user-guide/features/deliverable-mode.mdindex 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