feat(skills): improve agent experience of the CLI and public skills

.agents/skills/sync-agent-infra/SKILL.md

@@ -22,6 +22,7 @@ Run after adding, removing, or renaming a skill or crate; changing issue or PR c
 | Security assessment or remediation | `review-security-issue`, `fix-security-issue` |
 | Published docs workflow | `update-docs-from-commits` |
 | CLI commands, flags, defaults, or workflows | `openshell-cli` |
+| `openshell agent context` output or usage | `openshell-cli`, `generate-sandbox-policy`, `debug-inference`, `debug-openshell-cluster` |
 | Sandbox policy schema or enforcement | `generate-sandbox-policy`, `openshell-cli` |
 | Gateway deployment, Helm, drivers, or health checks | `debug-openshell-cluster`, `helm-dev-environment` |
 | Inference providers or native model endpoints | `debug-inference`, `openshell-cli` |

CONTRIBUTING.md

@@ -80,7 +80,7 @@ OpenShell keeps skills for using the product separate from skills for developing
 
 ### Skills for Using OpenShell
 
-Public skills live in `skills/` and work without an OpenShell source checkout. Install them with `npx skills add NVIDIA/OpenShell`.
+Public skills live in `skills/` and work without an OpenShell source checkout. Install them with `npx skills add NVIDIA/OpenShell`. To install the skills from a specific release, add its tag: `npx skills add NVIDIA/OpenShell#<release-tag>`.
 
 | Skill | Purpose |
 | --- | --- |
@@ -89,7 +89,7 @@ Public skills live in `skills/` and work without an OpenShell source checkout. I
 | `debug-inference` | Diagnose attached-provider inference, native endpoints, and migration from the retired managed endpoint |
 | `generate-sandbox-policy` | Generate YAML sandbox policies from requirements or API documentation |
 
-Public skills use `openshell --help` for installed command syntax and published OpenShell documentation for product concepts and configuration. They must not depend on repository-relative source or documentation files.
+Public skills use `openshell agent context` and `openshell <command> --help` for installed command syntax and published OpenShell documentation for product concepts and configuration. They must not depend on repository-relative source or documentation files.
 
 ### Agent Skills for Contributors
 

README.md

@@ -74,7 +74,9 @@ Install the public OpenShell skills for your coding agent:
 npx skills add NVIDIA/OpenShell
 ```
 
-The skills teach your agent to drive the OpenShell CLI, write sandbox policies, and debug gateways and inference routing. They live in [`skills/`](skills/) and work without an OpenShell source checkout.
+The skills generally work across OpenShell releases. To install the skills from a specific release, such as the one that matches your CLI, add its tag: `npx skills add NVIDIA/OpenShell#<release-tag>`.
+
+The skills teach your agent to drive the OpenShell CLI, write sandbox policies, and debug gateways and inference routing. They live in [`skills/`](skills/) and work without an OpenShell source checkout. The skills start by running `openshell agent context`, which prints a map of every command and flag in the installed CLI.
 
 ## SDKs