diff --git a/src/content/docs/how-to/cvmi/commands.md b/src/content/docs/how-to/cvmi/commands.md
index 243f2a3..896b237 100644
--- a/src/content/docs/how-to/cvmi/commands.md
+++ b/src/content/docs/how-to/cvmi/commands.md
@@ -14,14 +14,20 @@ Install ContextVM skills. Skills provide documentation, templates, and reference
 ### Usage
 
 ```bash
-npx cvmi add [options]
+npx cvmi add [skill...] [options]
 ```
 
+### Arguments
+
+| Argument     | Description                                      |
+| ------------ | ------------------------------------------------ |
+| `skill`      | Skill name to install. Repeat to install several. Omit to pick interactively. |
+
 ### Options
 
-| Option           | Description                      |
-| ---------------- | -------------------------------- |
-| `--skill <name>` | Install a specific skill by name |
+| Option           | Description                                      |
+| ---------------- | ------------------------------------------------ |
+| `--skill <name>` | Same as a positional skill name (repeatable)     |
 
 ### Examples
 
@@ -34,16 +40,16 @@ npx cvmi add
 **Install a specific skill**:
 
 ```bash
-npx cvmi add --skill overview
-npx cvmi add --skill typescript-sdk
-npx cvmi add --skill server-dev
-npx cvmi add --skill client-dev
+npx cvmi add overview
+npx cvmi add typescript-sdk
+npx cvmi add server-dev
+npx cvmi add client-dev
 ```
 
 **Install multiple skills**:
 
 ```bash
-npx cvmi add --skill overview --skill payments --skill deployment
+npx cvmi add overview payments deployment
 ```
 
 ## `cvmi serve`
diff --git a/src/content/docs/how-to/cvmi/installation.md b/src/content/docs/how-to/cvmi/installation.md
index c33b30b..f322fa6 100644
--- a/src/content/docs/how-to/cvmi/installation.md
+++ b/src/content/docs/how-to/cvmi/installation.md
@@ -21,7 +21,7 @@ The easiest way to use CVMI is with `npx`, which downloads and runs the latest v
 npx cvmi add
 
 # Install a specific skill
-npx cvmi add --skill overview
+npx cvmi add overview
 ```
 
 Using `npx` ensures you always have the latest version without managing global installations.
@@ -39,9 +39,9 @@ npx cvmi add
 Install a specific skill directly:
 
 ```bash
-npx cvmi add --skill overview
-npx cvmi add --skill typescript-sdk
-npx cvmi add --skill server-dev
+npx cvmi add overview
+npx cvmi add typescript-sdk
+npx cvmi add server-dev
 ```
 
 ### Run a Gateway
diff --git a/src/content/docs/how-to/cvmi/skills/overview.md b/src/content/docs/how-to/cvmi/skills/overview.md
index 921eef9..4971ba5 100644
--- a/src/content/docs/how-to/cvmi/skills/overview.md
+++ b/src/content/docs/how-to/cvmi/skills/overview.md
@@ -1,11 +1,13 @@
 ---
 title: Skills Overview
-description: An overview of CVMI skills - LLM-optimized guides for building with ContextVM.
+description: Install and use CVMI skills — documentation packages with templates, references, and LLM-oriented guides for building with ContextVM.
 ---
 
 # Skills Overview
 
-CVMI skills are LLM-optimized guides that help AI assistants provide accurate guidance for building with ContextVM. Unlike traditional documentation, skills are designed to give AI the right context at the right time.
+CVMI skills are documentation packages you install locally. Each skill includes code templates, reference implementations, and focused guides for a ContextVM topic. They are useful if you are reading and copying from those materials yourself, and they also give AI assistants the right context when you are working with one.
+
+Unlike the full documentation site, a skill is a small, topic-scoped bundle: install only what you are building with.
 
 ## What are Skills?
 
@@ -40,14 +42,20 @@ npx cvmi add overview
 npx cvmi add server-dev
 ```
 
+Pass more than one name to install several skills at once:
+
+```bash
+npx cvmi add overview payments deployment
+```
+
 Skills are installed to `~/.agents/` and managed through the CVMI CLI.
 
 ## When to Use Skills
 
-Use skills when:
+Install a skill when you want a compact, copyable package for a specific task:
 
-- Working with an AI assistant to build with ContextVM
-- The AI has the relevant skill installed
-- You need context-specific guidance on implementation
+- Building a server, client, payments flow, or deployment and you want the templates plus references in one place
+- Reading implementation patterns without paging through the full docs
+- Working with an AI assistant that should follow ContextVM conventions
 
-The skills provide the AI with detailed implementation knowledge that can guide you through building servers, clients, payments integration, and deployment.
+The skills give you (and any assistant you use) detailed implementation knowledge for servers, clients, payments, and deployment.