agent-skills-standard 1.9.2 β 1.9.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 +102 -30
- package/dist/index.js +339 -291
- package/dist/index.js.map +1 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,23 +1,67 @@
|
|
|
1
|
-
# Agent Skills Standard CLI π
|
|
1
|
+
# Agent Skills Standard CLI: Deployment & Sync Engine π
|
|
2
2
|
|
|
3
3
|
[](https://www.npmjs.com/package/agent-skills-standard)
|
|
4
4
|
[](https://github.com/HoangNguyen0403/agent-skills-standard/blob/main/LICENSE)
|
|
5
5
|
|
|
6
|
-
|
|
6
|
+
[](https://github.com/HoangNguyen0403/agent-skills-standard/releases/tag/nestjs-v1.2.1)
|
|
7
|
+
[](https://github.com/HoangNguyen0403/agent-skills-standard/releases/tag/nextjs-v1.2.0)
|
|
8
|
+
[](https://github.com/HoangNguyen0403/agent-skills-standard/releases/tag/golang-v1.1.0)
|
|
9
|
+
[](https://github.com/HoangNguyen0403/agent-skills-standard/releases/tag/angular-v1.2.0)
|
|
10
|
+
[](https://github.com/HoangNguyen0403/agent-skills-standard/releases/tag/kotlin-v1.1.0)
|
|
11
|
+
[](https://github.com/HoangNguyen0403/agent-skills-standard/releases/tag/java-v1.1.0)
|
|
12
|
+
[](https://github.com/HoangNguyen0403/agent-skills-standard/releases/tag/spring-boot-v1.1.0)
|
|
13
|
+
[](https://github.com/HoangNguyen0403/agent-skills-standard/releases/tag/android-v1.1.0)
|
|
14
|
+
[](https://github.com/HoangNguyen0403/agent-skills-standard/releases/tag/swift-v1.1.0)
|
|
15
|
+
[](https://github.com/HoangNguyen0403/agent-skills-standard/releases/tag/ios-v1.2.0)
|
|
16
|
+
[](https://github.com/HoangNguyen0403/agent-skills-standard/releases/tag/php-v1.1.0)
|
|
17
|
+
[](https://github.com/HoangNguyen0403/agent-skills-standard/releases/tag/laravel-v1.1.0)
|
|
18
|
+
[](https://github.com/HoangNguyen0403/agent-skills-standard/releases/tag/database-v1.1.1)
|
|
19
|
+
[](https://github.com/HoangNguyen0403/agent-skills-standard/releases/tag/quality-engineering-v1.1.0)
|
|
20
|
+
|
|
21
|
+
**The heavy-lifting engine for High-Density AI Agent Instructions. Deploy professional standards to any project in seconds.**
|
|
22
|
+
|
|
23
|
+
The `agent-skills-standard` CLI is the official command-line tool to manage, sync, and version-control engineering standards (often called **"Cursor Rules"** or **"Agent Skills"**) across all major AI agents (**Cursor, Claude Code, GitHub Copilot, Gemini, Roo Code, and more**).
|
|
7
24
|
|
|
8
|
-
|
|
25
|
+
---
|
|
26
|
+
|
|
27
|
+
## π Table of Contents
|
|
28
|
+
|
|
29
|
+
- [π‘ What does this tool do?](#-what-does-this-tool-do)
|
|
30
|
+
- [π― Who is this for?](#-who-is-this-for)
|
|
31
|
+
- [β‘ The Problem: The Context Wall](#-the-problem-the-context-wall)
|
|
32
|
+
- [π The Solution: Digital DNA for AI](#-the-solution-digital-dna-for-ai)
|
|
33
|
+
- [π‘οΈ Security & Trust](#οΈ-security--trust)
|
|
34
|
+
- [π Quick Start](#-quick-start)
|
|
35
|
+
- [π» Command Reference](#-command-reference)
|
|
36
|
+
- [π Registry Ecosystem](#-registry-ecosystem)
|
|
37
|
+
- [π Contributing](#-contributing)
|
|
38
|
+
- [β FAQ](#-faq)
|
|
9
39
|
|
|
10
40
|
---
|
|
11
41
|
|
|
12
42
|
## π‘ What does this tool do?
|
|
13
43
|
|
|
14
|
-
If the **Agent Skills Standard** is the "instruction manual" for your AI, this CLI is the **delivery
|
|
44
|
+
If the **Agent Skills Standard** is the "instruction manual" for your AI, this CLI is the **delivery engine** that brings those instructions to your project.
|
|
45
|
+
|
|
46
|
+
### π― Who is this for?
|
|
15
47
|
|
|
16
|
-
|
|
48
|
+
| Role | Benefit |
|
|
49
|
+
| :------------------- | :---------------------------------------------------------------------------------- |
|
|
50
|
+
| **π Builders** | No more copy-pasting `.cursorrules`. One command syncs your entire AI workspace. |
|
|
51
|
+
| **π‘οΈ Architects** | Push global engineering standards to every developer's IDE automatically. |
|
|
52
|
+
| **π Organizations** | Standardize AI behavior across your company. Ensure every agent "knows" your stack. |
|
|
17
53
|
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
54
|
+
### π CLI Sync Workflow
|
|
55
|
+
|
|
56
|
+
```mermaid
|
|
57
|
+
graph LR
|
|
58
|
+
A[Developers] -- run ags sync --> B[CLI Engine]
|
|
59
|
+
B -- fetch --> C[Cloud Registry]
|
|
60
|
+
C -- deploy --> D[Local IDE Settings]
|
|
61
|
+
D -- power-up --> E[Expert AI Coding]
|
|
62
|
+
|
|
63
|
+
style E fill:#dcfce7,stroke:#166534
|
|
64
|
+
```
|
|
21
65
|
|
|
22
66
|
---
|
|
23
67
|
|
|
@@ -61,9 +105,9 @@ We take security seriously. Here is what you need to know about how the CLI work
|
|
|
61
105
|
|
|
62
106
|
Every skill delivered by this CLI is audited for its footprint in the AI's context window.
|
|
63
107
|
|
|
64
|
-
| Metric |
|
|
65
|
-
|
|
|
66
|
-
| **Global Average** |
|
|
108
|
+
| Metric | Typical Saving | Status | Version | Avg. Footprint |
|
|
109
|
+
| :----------------- | :-------------- | :----- | :------- | :------------- |
|
|
110
|
+
| **Global Average** | **88% Savings** | 10/10 | `v1.1.0` | ~398 tokens |
|
|
67
111
|
|
|
68
112
|
> [!IMPORTANT]
|
|
69
113
|
> **Context is Currency**: By reducing instruction overhead by **88%**, you free up your AI's memory and budget for complex logic and large codebases.
|
|
@@ -78,14 +122,13 @@ Every skill delivered by this CLI is audited for its footprint in the AI's conte
|
|
|
78
122
|
|
|
79
123
|
---
|
|
80
124
|
|
|
81
|
-
|
|
125
|
+
#### π Benchmark History
|
|
82
126
|
|
|
83
|
-
| Version | Date
|
|
84
|
-
|
|
|
85
|
-
| v1.9.
|
|
86
|
-
| v1.9.
|
|
87
|
-
| v1.9.
|
|
88
|
-
| v1.8.0 | 2026-03-02 | 228 | 443 | 88% | [Report](benchmarks/archive/v1.8.0.md) |
|
|
127
|
+
| Version | Date | Skills | Avg Tokens | Savings (%) | Report |
|
|
128
|
+
| --- | --- | --- | --- | --- | --- |
|
|
129
|
+
| v1.9.3 | 2026-03-15 | 229 | 460 | 87% | [Report](benchmarks/archive/v1.9.3.md) |
|
|
130
|
+
| v1.9.2 | 2026-03-07 | 228 | 458 | 87% | [Report](benchmarks/archive/v1.9.2.md) |
|
|
131
|
+
| v1.9.1 | 2026-03-07 | 228 | 458 | 87% | [Report](benchmarks/archive/v1.9.1.md) |
|
|
89
132
|
|
|
90
133
|
## οΏ½ Token Economy & Optimization
|
|
91
134
|
|
|
@@ -233,25 +276,54 @@ skills:
|
|
|
233
276
|
- **π Secure Protection**: Mark specific files as "Locked" (overrides) so the CLI never changes your custom tweaks.
|
|
234
277
|
- **π§ͺ Production-Grade Reliability**: Guarded by a 100% statement coverage test suite and strict CI enforcement.
|
|
235
278
|
|
|
236
|
-
###
|
|
279
|
+
### π Browse All Available Skills
|
|
280
|
+
|
|
281
|
+
The Agent Skills Standard is a modular library designed to be the universal language for engineering standards. Browse the categories below to see the key modules and metrics for each stack.
|
|
282
|
+
|
|
283
|
+
| Stack / Category | Key Modules | Typical Saving | Status | Version | Skills | Avg. Footprint |
|
|
284
|
+
| :---------------------- | :-------------------------------------- | :------------- | :------ | :------- | :----- | :------------- |
|
|
285
|
+
| **Common Patterns** | Accessibility, Best Practices, Security | **82%** | Healthy | `v1.7.2` | 25 | ~657 tokens |
|
|
286
|
+
| **Flutter** | BLoC, Riverpod, Clean Architecture | **87%** | Healthy | `v1.4.1` | 21 | ~466 tokens |
|
|
287
|
+
| **Dart** | Language, Tooling | **87%** | Healthy | `v1.1.0` | 3 | ~459 tokens |
|
|
288
|
+
| **TypeScript** | Type Safety, Tooling | **85%** | Healthy | `v1.1.0` | 4 | ~541 tokens |
|
|
289
|
+
| **JavaScript** | Functional Programming, Patterns | **89%** | Healthy | `v1.1.0` | 3 | ~408 tokens |
|
|
290
|
+
| **React** | React 18+, Hooks, Performance | **88%** | Healthy | `v1.1.0` | 8 | ~427 tokens |
|
|
291
|
+
| **React Native** | Architecture, Performance | **87%** | Healthy | `v1.2.0` | 13 | ~469 tokens |
|
|
292
|
+
| **NestJS** | Architecture, Security, BullMQ | **84%** | Healthy | `v1.2.1` | 21 | ~570 tokens |
|
|
293
|
+
| **Next.js** | App Router, SEO, Performance | **86%** | Healthy | `v1.2.0` | 18 | ~506 tokens |
|
|
294
|
+
| **Angular** | Architecture, Signals, RxJS | **92%** | Healthy | `v1.2.0` | 15 | ~307 tokens |
|
|
295
|
+
| **Android** | Compose, Architecture, Networking | **91%** | Healthy | `v1.1.0` | 22 | ~315 tokens |
|
|
296
|
+
| **iOS** | Architecture, SwiftUI, Concurrency | **88%** | Healthy | `v1.2.0` | 15 | ~431 tokens |
|
|
297
|
+
| **Swift** | Concurrency, Architecture | **90%** | Healthy | `v1.1.0` | 8 | ~377 tokens |
|
|
298
|
+
| **Kotlin** | Language, Concurrency | **87%** | Healthy | `v1.1.0` | 4 | ~475 tokens |
|
|
299
|
+
| **Java** | Language, Concurrency | **85%** | Healthy | `v1.1.0` | 5 | ~543 tokens |
|
|
300
|
+
| **Spring Boot** | Architecture, Security | **89%** | Healthy | `v1.1.0` | 10 | ~393 tokens |
|
|
301
|
+
| **Go (Golang)** | Clean Architecture, Security | **89%** | Healthy | `v1.1.0` | 10 | ~398 tokens |
|
|
302
|
+
| **PHP** | Error Handling, PHP 8+ | **91%** | Healthy | `v1.1.0` | 7 | ~340 tokens |
|
|
303
|
+
| **Laravel** | Solid Patterns, Clean Architecture | **90%** | Healthy | `v1.1.0` | 10 | ~383 tokens |
|
|
304
|
+
| **Database** | PostgreSQL, MongoDB, Redis | **80%** | Healthy | `v1.1.1` | 3 | ~720 tokens |
|
|
305
|
+
| **Quality Engineering** | BA, TDD, Zephyr, Automation | **87%** | Healthy | `v1.1.0` | 4 | ~480 tokens |
|
|
237
306
|
|
|
238
|
-
|
|
239
|
-
|
|
240
|
-
| **Flutter** | 88% | `422`  | β
Stable |
|
|
241
|
-
| **NestJS** | 85% | `518`  | β
Production |
|
|
242
|
-
| **Next.js** | 89% | `431`  | β
Stable |
|
|
243
|
-
| **React** | 90% | `401`  | β
Stable |
|
|
244
|
-
| **Golang** | 90% | `375`  | β
Stable |
|
|
245
|
-
| **Android** | 92% | `295`  | β
Production |
|
|
246
|
-
| **iOS** | 90% | `411`  | β
Production |
|
|
247
|
-
| **Laravel** | 91% | `361`  | β
Stable |
|
|
248
|
-
| **Spring Boot** | 92% | `369`  | β
Stable |
|
|
307
|
+
> [!TIP]
|
|
308
|
+
> **View the Complete Registry**: For a full list of all 160+ skills, visit the [Skills Directory](../skills/README.md).
|
|
249
309
|
|
|
250
310
|
> [!TIP]
|
|
251
311
|
> Run `ags benchmark` (coming soon) or check the [root report](../benchmark-report.md) for full scientific methodology.
|
|
252
312
|
|
|
253
313
|
---
|
|
254
314
|
|
|
315
|
+
## β FAQ
|
|
316
|
+
|
|
317
|
+
### Do I need to install this globally?
|
|
318
|
+
|
|
319
|
+
We recommend using `npx agent-skills-standard sync` to always use the latest version without global installation.
|
|
320
|
+
|
|
321
|
+
### Does it overwrite my custom rules?
|
|
322
|
+
|
|
323
|
+
No. If you have custom rules in `.cursorrules` or other files, you can use the `Locked` feature or the CLI will intelligently merge them if configured.
|
|
324
|
+
|
|
325
|
+
---
|
|
326
|
+
|
|
255
327
|
## π Links
|
|
256
328
|
|
|
257
329
|
- **Registry Source**: [GitHub Repository](https://github.com/HoangNguyen0403/agent-skills-standard)
|