Summary
The Skills Overview page (/cvmi/skills/overview/) documents the wrong syntax for installing individual skills. The examples shown omit the required --skill flag, which causes the commands to fail with a CLI error when a new user follows them.
Current behaviour
The Skills Overview page currently shows:
# Install specific skills
npx cvmi add overview
npx cvmi add server-dev
Running either of these commands as documented fails. The cvmi add command requires the --skill flag when specifying a skill by name.
Expected behaviour
The commands should match the correct syntax already documented on the Installation page and the Commands reference:
# Install specific skills
npx cvmi add --skill overview
npx cvmi add --skill server-dev
Steps to reproduce
- Navigate to https://docs.contextvm.org/cvmi/skills/overview/
- Copy either install command under Installing Skills
- Run it in a terminal with Node.js 18+ installed
- Observe the CLI error
Impact
This is a first-command failure for any new user following the Skills guide. The Skills Overview is the only page dedicated to explaining the skills system, and the install commands are the first actionable step it presents. A new user has no indication that the command is wrong — they will assume the tool or their environment is broken.
Proposed fix
Update the two code blocks on the Skills Overview page:
| Location |
Current (incorrect) |
Correct |
| Skills Overview — "Install specific skills" |
npx cvmi add overview |
npx cvmi add --skill overview |
| Skills Overview — "Install specific skills" |
npx cvmi add server-dev |
npx cvmi add --skill server-dev |
No other pages are affected. The Installation page and Commands reference already use the correct --skill syntax throughout.
Additional context
While reviewing the Skills page, I also noticed that the opening paragraph frames skills entirely from an AI assistant's perspective:
"CVMI skills are LLM-optimized guides that help AI assistants provide accurate guidance for building with ContextVM."
This framing is accurate but incomplete. Skills also contain code templates and reference implementations that are directly useful to human developers without any AI involvement. The "When to Use Skills" section only recommends installing skills when "working with an AI assistant", which undersells the feature for developers who want to read and copy from the templates directly.
A follow-up improvement to the page's introductory copy would make the skills system accessible to the broader developer audience. I'm happy to submit a PR for both the command fix and the copy improvement together if that's preferred.
Summary
The Skills Overview page (
/cvmi/skills/overview/) documents the wrong syntax for installing individual skills. The examples shown omit the required--skillflag, which causes the commands to fail with a CLI error when a new user follows them.Current behaviour
The Skills Overview page currently shows:
# Install specific skills npx cvmi add overview npx cvmi add server-devRunning either of these commands as documented fails. The
cvmi addcommand requires the--skillflag when specifying a skill by name.Expected behaviour
The commands should match the correct syntax already documented on the Installation page and the Commands reference:
# Install specific skills npx cvmi add --skill overview npx cvmi add --skill server-devSteps to reproduce
Impact
This is a first-command failure for any new user following the Skills guide. The Skills Overview is the only page dedicated to explaining the skills system, and the install commands are the first actionable step it presents. A new user has no indication that the command is wrong — they will assume the tool or their environment is broken.
Proposed fix
Update the two code blocks on the Skills Overview page:
npx cvmi add overviewnpx cvmi add --skill overviewnpx cvmi add server-devnpx cvmi add --skill server-devNo other pages are affected. The Installation page and Commands reference already use the correct
--skillsyntax throughout.Additional context
While reviewing the Skills page, I also noticed that the opening paragraph frames skills entirely from an AI assistant's perspective:
This framing is accurate but incomplete. Skills also contain code templates and reference implementations that are directly useful to human developers without any AI involvement. The "When to Use Skills" section only recommends installing skills when "working with an AI assistant", which undersells the feature for developers who want to read and copy from the templates directly.
A follow-up improvement to the page's introductory copy would make the skills system accessible to the broader developer audience. I'm happy to submit a PR for both the command fix and the copy improvement together if that's preferred.