agent-skills-standard 2.1.3 → 2.2.1

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
@@ -3,7 +3,7 @@
3
3
  [![NPM Version](https://img.shields.io/npm/v/agent-skills-standard.svg?style=flat-square)](https://www.npmjs.com/package/agent-skills-standard)
4
4
  [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg?style=flat-square)](https://github.com/HoangNguyen0403/agent-skills-standard/blob/main/LICENSE)
5
5
 
6
- **Sync 237 AI coding standards to any project in one command.** Works with Cursor, Claude Code, GitHub Copilot, Gemini, Windsurf, Trae, Kiro, and Roo.
6
+ **Sync 242 AI coding standards to any project in one command.** Works with Cursor, Claude Code, GitHub Copilot, Gemini, Windsurf, Trae, Kiro, and Roo.
7
7
 
8
8
  ```bash
9
9
  npx agent-skills-standard@latest init # detect your stack
@@ -36,6 +36,7 @@ The result: your AI agent reads `AGENTS.md`, follows the router to the right cat
36
36
  | :--------- | :--------------------------------------------------------------------------------------------- |
37
37
  | `init` | Detects your tech stack (Flutter, React, Go, etc.) and creates a `.skillsrc` config |
38
38
  | `sync` | Fetches skills from the registry, writes to agent folders, generates `_INDEX.md` + `AGENTS.md` |
39
+ | `mcp` | Manage the optional MCP server integration (status / enable / disable / scope / install / uninstall / snippets) — see [Optional: MCP Runtime Enforcement](#optional-mcp-runtime-enforcement) below |
39
40
  | `validate` | Checks your custom skills against format and token standards |
40
41
  | `feedback` | Submits improvement suggestions to the registry |
41
42
  | `upgrade` | Updates the CLI to the latest version |
@@ -84,12 +85,30 @@ project/
84
85
 
85
86
  ---
86
87
 
88
+ ## Optional: MCP Runtime Enforcement
89
+
90
+ The CLI **distributes** skills as static files. The companion [`agent-skills-standard-mcp`](https://www.npmjs.com/package/agent-skills-standard-mcp) server **serves** them at runtime as MCP tool calls — closing the gap where sub-agents skip skill loading because they don't inherit `AGENTS.md`.
91
+
92
+ `init` asks once whether to enable it and at what scope. Default is `project` (recommended). Change later with:
93
+
94
+ ```bash
95
+ ags mcp status # show current state + per-agent install
96
+ ags mcp scope project # project | user | snippets-only | disabled
97
+ ags mcp install # apply changes
98
+ ags mcp uninstall --from project # remove our entry; siblings preserved
99
+ ```
100
+
101
+ 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.
102
+
103
+ ---
104
+
87
105
  ## Privacy & Security
88
106
 
89
107
  - **Text only** — the CLI downloads Markdown and JSON files, never binaries or scripts
90
108
  - **No telemetry** — zero data collection, no background processes
91
109
  - **Transparent** — fetches from the [public registry](https://github.com/HoangNguyen0403/agent-skills-standard), nothing hidden
92
110
  - **Override protection** — `custom_overrides` prevents the CLI from touching your local modifications
111
+ - **MCP consent model** — runtime configs in `$HOME` are only ever modified with explicit per-file consent
93
112
 
94
113
  ---
95
114
 
@@ -103,6 +122,7 @@ project/
103
122
 
104
123
  | Version | Date | Skills | Avg Tokens | Savings (%) | Report |
105
124
  | --- | --- | --- | --- | --- | --- |
125
+ | v2.2.0 | 2026-04-22 | 242 | 538 | 85% | [Report](benchmarks/archive/v2.2.0.md) |
106
126
  | v2.1.2 | 2026-04-11 | 237 | 516 | 86% | [Report](benchmarks/archive/v2.1.2.md) |
107
127
  | v2.1.1 | 2026-04-11 | 237 | 516 | 86% | [Report](benchmarks/archive/v2.1.1.md) |
108
128
  | v2.1.0 | 2026-04-04 | 237 | 526 | 86% | [Report](benchmarks/archive/v2.1.0.md) |
@@ -112,4 +132,3 @@ project/
112
132
  | v1.10.1 | 2026-03-16 | 229 | 428 | 88% | [Report](benchmarks/archive/v1.10.1.md) |
113
133
  | v1.10.0 | 2026-03-16 | 229 | 434 | 88% | [Report](benchmarks/archive/v1.10.0.md) |
114
134
  | v1.9.3 | 2026-03-15 | 229 | 460 | 87% | [Report](benchmarks/archive/v1.9.3.md) |
115
- | v1.9.2 | 2026-03-07 | 228 | 458 | 87% | [Report](benchmarks/archive/v1.9.2.md) |