Improve README quickstart readability and command discoverability

README.md

@@ -11,38 +11,84 @@
 
 ---
 
-Skills are portable instruction sets that teach AI agents how to use NVIDIA CUDA-X libraries, AI Blueprints, and platform tools correctly. From solving vehicle routing problems with cuOpt, to deploying RAG pipelines, to onboarding models into TensorRT-LLM, every skill listed here is **published and verified by NVIDIA**.
-
-This repository is a **catalog** — skills are maintained in their respective product repos and mirrored here daily via an automated sync pipeline. It follows the open [Agent Skills specification](https://agentskills.io/specification), making skills compatible with any AI agent or framework that supports the standard.
-
-We are building this in the open. The catalog, sync pipeline, and roadmap are public so the community can see what we ship, what we plan to ship, and how we secure skills for use. As we add signing, scanning, and evaluation, each improvement lands here incrementally.
+Skills are portable instruction sets that teach AI agents how to use NVIDIA CUDA-X libraries, AI Blueprints, and platform tools correctly. This repository is a catalog: skills are maintained in their respective product repos and mirrored here daily via an automated sync pipeline. We are making NVIDIA skills available publicly and building this catalog in the open; see the [Roadmap](#roadmap) for what is planned next.
 
 ---
 
 ## Quickstart
 
-Use the [`skills` CLI](https://github.com/vercel-labs/skills) to install NVIDIA skills into the AI agent you use. The CLI runs through `npx`, so you do not need to clone this repo or copy skill folders by hand.
+Install NVIDIA skills with the default [`skills` CLI](https://github.com/vercel-labs/skills) flow:
 
 ```bash
-# Browse the NVIDIA catalog without installing anything
-npx skills add nvidia/skills --list
-
-# Install from the NVIDIA catalog (interactive)
 npx skills add nvidia/skills
+```
 
-# Install one skill into the current project and skip prompts
+The CLI runs through `npx` and prompts you to choose a skill and install destination. You do not need to clone this repo or copy skill folders by hand.
+
+The skill is available the next time your agent loads skills and encounters a relevant task. For example, ask your agent to "solve a linear programming problem with cuOpt" and the skill guides it through the cuOpt Python API.
+
+### Install One Skill Without Prompts
+
+Use this when you already know the skill name and want to skip prompts.
+
+```bash
 npx skills add nvidia/skills --skill cuopt-numerical-optimization-api-python --yes
 ```
 
-That's it — the skill activates automatically the next time your agent encounters a relevant task. For example, ask your agent to "solve a linear programming problem with cuOpt" and the skill guides it through the cuOpt Python API.
+Replace `cuopt-numerical-optimization-api-python` with any skill name from the [Skill Catalog](#skill-catalog).
 
-The CLI can prompt you to choose where to install the skill, or you can target agents explicitly using a `--agent` option, e.g. `--agent claude-code --agent codex --agent cursor`.
+### Install for a Specific Agent
+
+Use `--agent` to target a specific AI coding agent. These are common client targets; for the full list of supported clients, see the [`skills` CLI Supported Agents table](https://github.com/vercel-labs/skills#supported-agents).
+
+**Claude Code**
+
+```bash
+npx skills add nvidia/skills --skill cuopt-numerical-optimization-api-python --agent claude-code
+```
+
+**Codex**
+
+```bash
+npx skills add nvidia/skills --skill cuopt-numerical-optimization-api-python --agent codex
+```
+
+**Cursor**
+
+```bash
+npx skills add nvidia/skills --skill cuopt-numerical-optimization-api-python --agent cursor
+```
+
+**Kiro**
+
+```bash
+npx skills add nvidia/skills --skill cuopt-numerical-optimization-api-python --agent kiro-cli
+```
+
+Use `--agent` more than once to install the same skill into multiple agents.
+
+```bash
+npx skills add nvidia/skills \
+  --skill cuopt-numerical-optimization-api-python \
+  --agent claude-code \
+  --agent codex \
+  --agent cursor \
+  --agent kiro-cli
+```
+
+### Browse the Catalog
+
+Use this when you want to see available NVIDIA skills before installing anything.
+
+```bash
+npx skills add nvidia/skills --list
+```
 
 For non-interactive installs, global installs, agent-specific installs, updates, removals, and fallback manual copying, see [Advanced installation](docs/advanced-install.md).
 
 ---
 
-## Available Skills
+## Skill Catalog
 
 <!-- skills-table-start -->
 | Product | Description | Skills | Catalog | Source | Version |
@@ -137,7 +183,7 @@ NVIDIA/skills/
 └── LICENSE                  # Apache 2.0
 ```
 
-Skills are maintained in their respective product repos (see the **Source** column in [Available Skills](#available-skills)) and automatically synced to this repo daily.
+Skills are maintained in their respective product repos (see the **Source** column in the [Skill Catalog](#skill-catalog)) and automatically synced to this repo daily.
 
 ---