From ad6c9e49e1cd394290315265582f4017b8b323d2 Mon Sep 17 00:00:00 2001 From: Quickbeard Date: Thu, 6 Aug 2026 17:01:11 +0700 Subject: [PATCH 1/2] docs: name all four office formats in help and README MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit `codevhub skill office` ships four skills — minimax-docx, minimax-xlsx, pptx-generator and minimax-pdf — but `codevhub help` and the README both advertised only DOCX and XLSX, so users had no way to learn that PPTX and PDF authoring were installed too. `src/lib/office.ts` already documented all four; only the user-facing copy was stale. Pin the list with a help test so it can't drift from the bundle again. Two adjacent README claims in the same section were stale against the code and are corrected here as well: - Bundle sizes (610 MB / 820 MB / 1.4 GB) contradicted APPROX_BUNDLE_MB. Rather than restate numbers the README has to track, point at the heads-up runSkillOffice already prints from that constant. - The download path and Windows behavior: officeDownloadsDir() returns %PUBLIC%\Downloads\codev-office on Windows, and since #244–#246 codevhub deliberately prints the elevated-PowerShell command instead of launching the installer. Co-Authored-By: Claude Opus 5 (1M context) --- README.md | 6 +++--- src/lib/help.ts | 4 ++-- tests/lib/help.test.ts | 11 +++++++++++ 3 files changed, 16 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index aaf56e1..18c43c1 100644 --- a/README.md +++ b/README.md @@ -94,15 +94,15 @@ codevhub init # initialize + index the current project (one time) ## CoDev Office skills (offline bundle) -`codevhub skill office` installs the CoDev Office skills so your agents can produce and edit real DOCX and XLSX files. Everything ships in one offline bundle — no login and no per-skill downloads: +`codevhub skill office` installs the CoDev Office skills so your agents can produce and edit real DOCX, XLSX, PPTX and PDF files. Everything ships in one offline bundle — no login and no per-skill downloads: ```bash codevhub skill office ``` -It picks the bundle for your OS, downloads it into `~/.codev-hub/office`, and runs the bundled setup script, which may prompt for `sudo` (macOS/Linux) or UAC (Windows). +It picks the bundle for your OS and downloads it into `~/.codev-hub/office` (on Windows: `%PUBLIC%\Downloads\codev-office`). On macOS/Linux it then runs the bundled setup script, which may prompt for `sudo`; on Windows it prints the exact command to paste into an elevated PowerShell instead of launching the installer itself. -**The bundle is large — roughly 610 MB (Linux), 820 MB (Windows) or 1.4 GB (macOS).** The download folder is kept between runs, so an interrupted transfer resumes where it left off and an already-downloaded bundle is reused. To force a completely fresh download, delete `~/.codev-hub/office`. +**The bundle is large**, and the command prints its approximate size before downloading. The download folder is kept between runs, so an interrupted transfer resumes where it left off and an already-downloaded bundle is reused. To force a completely fresh download, delete that folder. To fetch the bundle now and install later — or to stage it for a machine that has no internet access: diff --git a/src/lib/help.ts b/src/lib/help.ts index 68fc836..4a43d67 100644 --- a/src/lib/help.ts +++ b/src/lib/help.ts @@ -50,8 +50,8 @@ Skill hub: (previews and confirms before upload; --draft-only to stop at DRAFT, --auto-approve for admins, --json for output) skill office Download the CoDev Office offline skills bundle - (DOCX and XLSX authoring) for this OS and run its - setup script + (DOCX, XLSX, PPTX and PDF authoring) for this OS + and run its setup script (--platform ubuntu|macos|windows to fetch for another OS [implies --download-only], --dir for the download folder, --download-only to skip running the installer, diff --git a/tests/lib/help.test.ts b/tests/lib/help.test.ts index 00569a0..c42331f 100644 --- a/tests/lib/help.test.ts +++ b/tests/lib/help.test.ts @@ -73,6 +73,17 @@ describe("printHelp", () => { expect(output()).toContain("remove"); }); + test("lists every format the office bundle covers", () => { + // The bundle ships four skills (minimax-docx, minimax-xlsx, + // pptx-generator, minimax-pdf); help used to name only the first two, + // so users had no way to know PPTX/PDF were installed. + printHelp(); + const out = output(); + for (const format of ["DOCX", "XLSX", "PPTX", "PDF"]) { + expect(out).toContain(format); + } + }); + test("does not surface bare-agent launch commands as documented", () => { // Agents (claude/codex/opencode) are launched via PATH shims set up by // `codevhub install` — the bare `codev ` form is intentionally From 43b920acf5438a35e377c506368158dfee0f4e84 Mon Sep 17 00:00:00 2001 From: Quickbeard Date: Thu, 6 Aug 2026 17:05:24 +0700 Subject: [PATCH 2/2] docs: say what the office skills do, not "authoring" "Authoring" dates to #233, when the bundle was DOCX-only. It reads as write-only, and all four skills also read and edit existing files: minimax-xlsx is "open, create, read, analyze, edit, or validate"; pptx-generator "generate, edit, and read"; minimax-pdf has FILL and REFORMAT modes alongside CREATE. Name the verbs instead. Co-Authored-By: Claude Opus 5 (1M context) --- README.md | 2 +- src/lib/help.ts | 4 ++-- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 18c43c1..d7b2862 100644 --- a/README.md +++ b/README.md @@ -94,7 +94,7 @@ codevhub init # initialize + index the current project (one time) ## CoDev Office skills (offline bundle) -`codevhub skill office` installs the CoDev Office skills so your agents can produce and edit real DOCX, XLSX, PPTX and PDF files. Everything ships in one offline bundle — no login and no per-skill downloads: +`codevhub skill office` installs the CoDev Office skills so your agents can create, read and edit real DOCX, XLSX, PPTX and PDF files. Everything ships in one offline bundle — no login and no per-skill downloads: ```bash codevhub skill office diff --git a/src/lib/help.ts b/src/lib/help.ts index 4a43d67..7470e38 100644 --- a/src/lib/help.ts +++ b/src/lib/help.ts @@ -50,8 +50,8 @@ Skill hub: (previews and confirms before upload; --draft-only to stop at DRAFT, --auto-approve for admins, --json for output) skill office Download the CoDev Office offline skills bundle - (DOCX, XLSX, PPTX and PDF authoring) for this OS - and run its setup script + (create, read and edit DOCX, XLSX, PPTX and PDF) + for this OS and run its setup script (--platform ubuntu|macos|windows to fetch for another OS [implies --download-only], --dir for the download folder, --download-only to skip running the installer,