docs: fix 27 stale claims found in documentation audit#3637
Merged
Conversation
jqnatividad
commented
Mar 22, 2026
Collaborator
- Update 7 files with stale version 17.0.0 → 18.0.0
- Update 5 files with stale component counts (3/6/2 → 5/8/3 skills/commands/agents)
- Update 6 files with stale command counts (68/60 → 70/62 for qsv/qsvmcp)
- Update 2 project structure trees (add 6 missing src files, fix cowork-setup.cjs)
- Fix SKILLS_API.md category table (remove non-existent grep/apply/flatten/to skills)
- Fix emoji conventions in skills/CLAUDE.md to show actual emoji prefixes
- Add undocumented QSV_MCP_ENABLE_APPS to ENVIRONMENT_VARIABLES.md
- Fix plugin.json description count (52 → 51 skill-based commands)
- Fix completions/CLAUDE.md count (66 → 69, remove non-existent generate command)
- Update 7 files with stale version 17.0.0 → 18.0.0 - Update 5 files with stale component counts (3/6/2 → 5/8/3 skills/commands/agents) - Update 6 files with stale command counts (68/60 → 70/62 for qsv/qsvmcp) - Update 2 project structure trees (add 6 missing src files, fix cowork-setup.cjs) - Fix SKILLS_API.md category table (remove non-existent grep/apply/flatten/to skills) - Fix emoji conventions in skills/CLAUDE.md to show actual emoji prefixes - Add undocumented QSV_MCP_ENABLE_APPS to ENVIRONMENT_VARIABLES.md - Fix plugin.json description count (52 → 51 skill-based commands) - Fix completions/CLAUDE.md count (66 → 69, remove non-existent generate command) Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Contributor
There was a problem hiding this comment.
Pull request overview
Updates multiple documentation and guidance files to reflect the current qsv/qsvmcp + MCP ecosystem (version bump to 18.0.0, refreshed component/tool/command counts, corrected skills tables, and newly documented MCP env var).
Changes:
- Refreshes version references (17.0.0 → 18.0.0) across docs.
- Updates stated counts for skills/commands/agents and corrects skills category listings and emoji conventions.
- Documents
QSV_MCP_ENABLE_APPSand updates MCP/extension/plugin docs accordingly.
Reviewed changes
Copilot reviewed 16 out of 16 changed files in this pull request and generated 5 comments.
Show a summary per file
| File | Description |
|---|---|
| docs/PERFORMANCE.md | Updates example qsv --version output and narrative to 18.0.0. |
| docs/ENVIRONMENT_VARIABLES.md | Adds QSV_MCP_ENABLE_APPS documentation. |
| contrib/completions/CLAUDE.md | Updates completions command-count statement. |
| .serena/memories/codebase_structure.md | Updates MCP-related component counts in the structure tree. |
| .claude/skills/docs/reference/UPDATE_SYSTEM.md | Updates reference doc version to 18.0.0. |
| .claude/skills/docs/reference/SKILLS_API.md | Fixes category table to remove non-existent skills and add current ones. |
| .claude/skills/docs/reference/AUTO_UPDATE.md | Updates reference doc version to 18.0.0. |
| .claude/skills/docs/guides/WINDOWS_SETUP.md | Updates Cowork plugin component counts and subagent list. |
| .claude/skills/docs/guides/START_HERE.md | Updates qsvmcp command count claim in the “Two Pieces” table. |
| .claude/skills/docs/guides/MACOS_SETUP.md | Updates Cowork plugin component counts and subagent list. |
| .claude/skills/docs/guides/CLAUDE_CODE.md | Updates minimum expected qsv version in setup instructions. |
| .claude/skills/docs/desktop/README-MCPB.md | Updates qsv/qsvmcp command count claims throughout extension docs. |
| .claude/skills/README.md | Updates repo tree and “What’s Available” tool-count summary. |
| .claude/skills/README-MCP.md | Updates qsvmcp vs qsv command-count claims and related narrative. |
| .claude/skills/CLAUDE.md | Updates emoji conventions and plugin-mode agent count statement. |
| .claude/skills/.claude-plugin/plugin.json | Updates description command count phrasing (52 → 51 skill-based commands). |
Comments suppressed due to low confidence (1)
.claude/skills/README-MCP.md:21
- The docs claim qsvmcp ships with 62 commands and excludes 8 commands, but the source build
cargo build --bin qsvmcp -F qsvmcpdoes not enable thetooruifeatures, sotoandcolorare also excluded. Based onsrc/main.rscommand gating and theqsvmcpfeature set in Cargo.toml, qsvmcp should expose 60 commands (not 62). Please update the counts and excluded-command list (or clarify that release builds enable extra features beyond-F qsvmcp).
The **qsvmcp** binary variant is purpose-built for MCP server use. It includes only the 62 commands needed by the MCP server (vs 70 in the full qsv binary), resulting in a smaller, faster binary.
**Features included in qsvmcp**: Polars, Luau scripting, geocoding, self-update, MCP skill generation (`--update-mcp-skills`), and the `log` command for MCP audit logging.
**Commands excluded from qsvmcp** (not needed for MCP): `apply`, `fetch`, `fetchpost`, `foreach`, `lens`, `prompt`, `python`, and `clipboard` — 8 commands total.
Copilot review correctly identified that qsvmcp excludes 10 commands (not 8): apply, fetch, fetchpost, foreach, lens, prompt, python, clipboard, to, and color. The `to` and `color` commands were missed because qsvmcp doesn't enable the `to` or `ui` features. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
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.