Skip to content

docs: name all four office formats in help and README - #251

Merged
quickbeard merged 2 commits into
mainfrom
docs/office-skill-formats
Aug 6, 2026
Merged

docs: name all four office formats in help and README#251
quickbeard merged 2 commits into
mainfrom
docs/office-skill-formats

Conversation

@quickbeard

@quickbeard quickbeard commented Aug 6, 2026

Copy link
Copy Markdown
Owner

Summary

codevhub skill office ships four skills — minimax-docx, minimax-xlsx, pptx-generator and minimax-pdf — and the setup script installs all four (for skill in minimax-docx minimax-xlsx pptx-generator 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 came with the bundle they just downloaded.

src/lib/office.ts:18 already documented all four correctly — only the user-facing copy was stale.

Changes

  • src/lib/help.ts(DOCX and XLSX authoring)(create, read and edit DOCX, XLSX, PPTX and PDF), rewrapped to fit the block. "Authoring" dates to feat(skill): add skill office to fetch and run the offline DOCX bundle #233, when the bundle was DOCX-only; it reads as write-only, while 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", and minimax-pdf has FILL and REFORMAT modes alongside CREATE).
  • README.md — same fix in the CoDev Office section intro ("produce and edit" → "create, read and edit").
  • tests/lib/help.test.ts — new test asserting all four format names appear in printHelp(), so the list can't silently drift from the bundle again.

Two adjacent README claims in the same section were also stale against the code, and are corrected here rather than left to rot:

  • Bundle sizes said 610 MB / 820 MB / 1.4 GB; APPROX_BUNDLE_MB says 1200/1400/3100 (the staged Ubuntu zip is 1194 MB). Rather than restate numbers the README has to keep in sync, the paragraph now points at the heads-up runSkillOffice already prints from that constant.
  • Download path and Windows behaviorofficeDownloadsDir() returns %PUBLIC%\Downloads\codev-office on Windows, and since feat: hand the Windows office install to the user as a right-click .cmd #244fix: print the manual elevated-PowerShell command instead of staging a .cmd #246 codevhub deliberately prints the elevated-PowerShell command instead of launching the installer (endpoint protection kills installers it starts). The README still described ~/.codev-hub/office unconditionally and a UAC prompt from an auto-run installer.

Runtime output in office.ts never enumerates formats, so nothing else needed touching.

Test plan

  • pnpm fix, pnpm typecheck — clean
  • pnpm test — 1385 passed, 2 skipped
  • pnpm build && node dist/index.js --version — 0.5.12; node dist/index.js help renders the new line correctly wrapped

🤖 Generated with Claude Code

Quickbeard and others added 2 commits August 6, 2026 17:08
`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) <noreply@anthropic.com>
"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) <noreply@anthropic.com>
@quickbeard
quickbeard force-pushed the docs/office-skill-formats branch from a81eaf8 to 43b920a Compare August 6, 2026 10:08
@quickbeard
quickbeard merged commit 5224590 into main Aug 6, 2026
2 of 3 checks passed
@quickbeard
quickbeard deleted the docs/office-skill-formats branch August 6, 2026 10:10
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant