docs: name all four office formats in help and README - #251
Merged
Conversation
`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
force-pushed
the
docs/office-skill-formats
branch
from
August 6, 2026 10:08
a81eaf8 to
43b920a
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
codevhub skill officeships four skills —minimax-docx,minimax-xlsx,pptx-generatorandminimax-pdf— and the setup script installs all four (for skill in minimax-docx minimax-xlsx pptx-generator minimax-pdf). Butcodevhub helpand 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:18already 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): addskill officeto 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 inprintHelp(), 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:
APPROX_BUNDLE_MBsays 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-uprunSkillOfficealready prints from that constant.officeDownloadsDir()returns%PUBLIC%\Downloads\codev-officeon Windows, and since feat: hand the Windows office install to the user as a right-click .cmd #244–fix: 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/officeunconditionally and a UAC prompt from an auto-run installer.Runtime output in
office.tsnever enumerates formats, so nothing else needed touching.Test plan
pnpm fix,pnpm typecheck— cleanpnpm test— 1385 passed, 2 skippedpnpm build && node dist/index.js --version— 0.5.12;node dist/index.js helprenders the new line correctly wrapped🤖 Generated with Claude Code