From e11ab73237497225a0e8e0afd9f431e0c7b245fc Mon Sep 17 00:00:00 2001 From: Xiang Shen Date: Thu, 10 Sep 2026 20:31:11 +0000 Subject: [PATCH] Document skill add --agents and skill remove in the README The per-agent skills stack added --agents scoping to skill add --mcp, the skill remove --mcp command with per-agent scoping, and each agent's skill MCP scope in status, none of which the README covered. Document them and align the skill add examples to ug. Co-authored-by: Isaac --- README.md | 36 ++++++++++++++++++++++++++++++------ 1 file changed, 30 insertions(+), 6 deletions(-) diff --git a/README.md b/README.md index 3c840c68..aad048d8 100644 --- a/README.md +++ b/README.md @@ -247,22 +247,43 @@ you to run `ug ` (existing agent sessions need a restart before the MCP t #### Add skill scopes without replacing existing ones -`ucode skill add` registers skills additively, keeping anything already configured. With `--mcp` it +`ug skill add` registers skills additively, keeping anything already configured. With `--mcp` it adds the schemas to the connection's scope, otherwise it downloads their skills to disk. `--skills` narrows a download to a subset of one schema's skills. ```bash # Add schemas to the skills MCP scope, keeping any already configured. -ucode skill add --location main.default,ml.prod --mcp +ug skill add --location main.default,ml.prod --mcp + +# Scope the schemas to specific agents. Any not set up yet are configured first. +ug skill add --location main.default --mcp --agents claude,codex # Download a schema's skills to disk, keeping existing downloads. -ucode skill add --location main.default +ug skill add --location main.default # Download a named subset, by bare name (with --location) or fully-qualified name. -ucode skill add --location main.default --skills my-skill,other-skill -ucode skill add --skills main.default.my-skill,main.default.other-skill +ug skill add --location main.default --skills my-skill,other-skill +ug skill add --skills main.default.my-skill,main.default.other-skill ``` +With `--mcp`, `--agents` limits the change to the named agents; without it the schemas go to every +configured agent. It applies only to `--mcp`, since downloaded skills are shared across agents. + +#### Remove skill scopes + +Remove schemas from the skills MCP connection with `ug skill remove --mcp`: + +```bash +# Pick schemas to remove; each is removed from every agent it's on. +ug skill remove --mcp + +# Remove from specific agents only. A schema scoped to several agents is +# removed from the named ones and kept on the rest. +ug skill remove --mcp --agents claude +``` + +`--mcp` is required; removing downloaded skills from disk isn't supported yet. + ### Managed config for a workspace (admins) Author the coding config your developers pick up automatically, instead of asking each of them to @@ -370,7 +391,7 @@ The output looks like: | Command | Description | |---------|-------------| -| `ug status` | Show current workspace, base URLs, managed config files, and selected models | +| `ug status` | Show current workspace, base URLs, managed config files, selected models, and each agent's skill MCP scope | | `ug export` | Print the workspace's managed config as portable JSON (`--file ` / `-f` to write a file) | | `ug doctor` | Diagnose local issues (uv, npm, Databricks CLI, workspace, credentials, agent CLIs, tracing) and offer to fix any problems found | | `ug usage` | Show your AI Gateway dollars spent and total budget | @@ -397,8 +418,11 @@ The output looks like: | `ug configure skills --location main.default --skill my-skill` | Download only the named skill(s) from a schema (comma-separated for several) | | `ug configure skills --location main.default --mcp` | Expose a schema's skills as MCP tools (override-only) instead of downloading | | `ug skill add --location main.default --mcp` | Add schemas to the skills MCP scope, keeping any already configured (additive; never replaces) | +| `ug skill add --location main.default --mcp --agents claude,codex` | Add schemas to specific agents' skills MCP scope (sets up any not yet configured) | | `ug skill add --location main.default` | Download a schema's skills to disk without removing existing downloads | | `ug skill add --skills main.default.my-skill` | Download a named subset of skills (bare names need `--location`; fully-qualified names stand alone) | +| `ug skill remove --mcp` | Remove skill schemas from the skills MCP connection (every agent) | +| `ug skill remove --mcp --agents claude` | Remove skill schemas from specific agents only, keeping them on the rest | | `ug setup` | Author the managed config's agents and models (workspace admins only) | | `ug setup mcps` | Add or change the managed config's MCP servers | | `ug setup skills [--location a.b,c.d]` | Add or change the managed config's skills |