agent-skills-standard 2.7.1 → 2.7.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -41,7 +41,7 @@ The result: your AI agent reads `AGENTS.md`, follows the router to the right cat
41
41
  | `init` | Detects your tech stack (Flutter, React, Go, etc.) and creates a `.skillsrc` config |
42
42
  | `sync` | Fetches skills from the registry, writes to agent folders, generates `_INDEX.md` + `AGENTS.md` |
43
43
  | `skills` | Category-first manager: pick categories (and optionally nested skills or a published category release), review once, then save and sync every configured agent |
44
- | `mcp` | Manage the optional MCP server integration (status / enable / disable / scope / install / uninstall / snippets) — see [Optional: MCP Runtime Enforcement](#optional-mcp-runtime-enforcement) below |
44
+ | `mcp` | Manage the optional MCP server integration (status / enable / disable / scope / via / install / uninstall / snippets) — see [Optional: MCP Runtime Enforcement](#optional-mcp-runtime-enforcement) below |
45
45
  | `validate` | Checks your custom skills against format and token standards |
46
46
  | `feedback` | Submits improvement suggestions to the registry |
47
47
  | `upgrade` | Updates the CLI to the latest version |
@@ -180,10 +180,14 @@ The CLI **distributes** skills as static files. The companion [`agent-skills-sta
180
180
  ```bash
181
181
  ags mcp status # show current state + per-agent install
182
182
  ags mcp scope project # project | user | snippets-only | disabled
183
+ ags mcp via auto # auto | npx | global launch mode (auto prefers a version-matched global ags-mcp)
184
+ ags mcp enable --install-global # npm i -g agent-skills-standard-mcp@<pin>, then verify the reported version
183
185
  ags mcp install # apply changes
184
186
  ags mcp uninstall --from project # remove our entry; siblings preserved
185
187
  ```
186
188
 
189
+ Launch mode defaults to `auto`: the generated entry uses a globally installed `ags-mcp` only when its `--version` exactly matches the CLI pin, and otherwise falls back to `npx -y --prefer-offline agent-skills-standard-mcp@<pin>`. `ags mcp status` prints the resolved launch line, the pin, and the detected global version; `ags mcp install --via <mode>` overrides the mode for that run without persisting it. `ags upgrade` does not rewrite runtime configs — run `ags sync` (or `ags mcp install`) to move them to the new pin; `ags mcp status` and `ags doctor` flag configured-vs-expected drift.
190
+
187
191
  The CLI **never** modifies user-home files (`~/.cursor/mcp.json`, `~/.gemini/settings.json`, etc.) unless you explicitly choose `scope: user` AND confirm each write. See [`mcp/README.md`](../mcp/README.md) for full details and [`mcp/ARCHITECTURE.md`](../mcp/ARCHITECTURE.md) for the threat model.
188
192
 
189
193