add-skill-kit 1.0.3 → 1.1.0

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.
Files changed (2) hide show
  1. package/README.md +69 -132
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -1,194 +1,131 @@
1
1
  <p align="center">
2
- <img src="https://raw.githubusercontent.com/agentskillkit/add-skill-kit/main/.github/logo.svg" height="128">
3
- <h1 align="center">add-skill-kit</h1>
2
+ <img src="https://raw.githubusercontent.com/agentskillkit/add-skill-kit/main/.github/logo.svg" height="96">
4
3
  </p>
5
4
 
5
+ <h1 align="center">add-skill-kit</h1>
6
+
6
7
  <p align="center">
7
- <a href="https://www.npmjs.com/package/add-skill-kit"><img src="https://img.shields.io/npm/v/add-skill-kit?style=flat&colorA=18181b&colorB=7c3aed" alt="npm version"></a>
8
- <a href="https://www.npmjs.com/package/add-skill-kit"><img src="https://img.shields.io/npm/d18m/add-skill-kit?style=flat&colorA=18181b&colorB=7c3aed" alt="npm downloads"></a>
9
- <a href="https://github.com/agentskillkit/add-skill-kit/blob/main/LICENSE"><img src="https://img.shields.io/github/license/agentskillkit/add-skill-kit?style=flat&colorA=18181b&colorB=7c3aed" alt="license"></a>
8
+ <strong>The package manager for AI Agent Skills</strong>
10
9
  </p>
11
10
 
12
11
  <p align="center">
13
- The enterprise-grade package manager for AI Agent Skills.<br/>
14
- Designed for the <strong>Antigravity Skills</strong> specification.
12
+ <a href="https://www.npmjs.com/package/add-skill-kit"><img src="https://img.shields.io/npm/v/add-skill-kit?style=flat&colorA=18181b&colorB=7c3aed" alt="npm"></a>
13
+ <a href="https://www.npmjs.com/package/add-skill-kit"><img src="https://img.shields.io/npm/dm/add-skill-kit?style=flat&colorA=18181b&colorB=7c3aed" alt="downloads"></a>
14
+ <a href="https://github.com/agentskillkit/add-skill-kit/blob/main/LICENSE"><img src="https://img.shields.io/github/license/agentskillkit/add-skill-kit?style=flat&colorA=18181b&colorB=7c3aed" alt="license"></a>
15
15
  </p>
16
16
 
17
17
  <p align="center">
18
- <a href="#installation">Installation</a> •
19
- <a href="#quick-start">Quick Start</a> •
20
- <a href="#commands">Commands</a> •
21
- <a href="#features">Features</a> •
22
- <a href="#documentation">Docs</a>
18
+ <a href="#install">Install</a> •
19
+ <a href="#why">Why?</a> •
20
+ <a href="#what-you-get">What You Get</a> •
21
+ <a href="#commands">Commands</a>
23
22
  </p>
24
23
 
25
24
  ---
26
25
 
27
- ## What is add-skill-kit?
28
-
29
- `add-skill-kit` is a CLI tool for managing **Agent Skills**—immutable, verifiable intelligence artifacts that extend your AI agent's capabilities. Think of it as `npm` for AI agents.
26
+ ## Install
30
27
 
31
28
  ```bash
32
29
  npx -y add-skill-kit agentskillkit/agent-skills
33
30
  ```
34
31
 
35
- Skills are **data, not code**. They won't execute on your system—they're read by your agent to enhance its behavior.
32
+ One command. 40+ skills. Your AI agent just got superpowers.
36
33
 
37
34
  ---
38
35
 
39
- ## Installation
36
+ ## Why?
40
37
 
41
- ```bash
42
- # Using npm
43
- npm install -g add-skill-kit
38
+ **Problem:** AI agents give inconsistent advice. No memory. No standards.
44
39
 
45
- # Using pnpm
46
- pnpm add -g add-skill-kit
40
+ **Solution:** Skills are portable intelligence packages. Install once, benefit forever.
47
41
 
48
- # Using Yarn
49
- yarn global add add-skill-kit
42
+ | Before | After |
43
+ |--------|-------|
44
+ | Copy-paste prompts | Version-controlled skills |
45
+ | Inconsistent output | Curated best practices |
46
+ | No team standards | Shared skill repositories |
47
+ | Manual updates | `add-skill-kit update` |
50
48
 
51
- # Or run directly with npx (use -y to skip install prompt)
52
- npx -y add-skill-kit <command>
49
+ ---
50
+
51
+ ## What You Get
52
+
53
+ ```
54
+ your-project/
55
+ └── .agent/
56
+ ├── skills/ # 40+ domain skills
57
+ │ ├── react-patterns/
58
+ │ ├── api-patterns/
59
+ │ ├── testing-patterns/
60
+ │ └── ...
61
+ ├── workflows/ # /debug, /plan, /deploy...
62
+ └── GEMINI.md # Agent config
53
63
  ```
54
64
 
55
- > **Requirements:** Node.js 18.0.0 or later
65
+ **Top Skills:**
66
+ - `react-patterns` — Hooks, composition, performance
67
+ - `api-patterns` — REST, GraphQL, tRPC
68
+ - `testing-patterns` — Unit, integration, E2E
69
+ - `systematic-debugging` — 4-phase methodology
70
+ - `vulnerability-scanner` — OWASP security
56
71
 
57
72
  ---
58
73
 
59
- ## Quick Start
74
+ ## How It Works
60
75
 
61
- ### 1. Initialize your workspace
62
-
63
- ```bash
64
- npx -y add-skill-kit init
76
+ ```
77
+ GitHub Repo → add-skill-kit → .agent/skills/
78
+ ↓
79
+ AI Agent reads
65
80
  ```
66
81
 
67
- This creates the `.agent/skills` directory structure in your project.
82
+ **Security:**
83
+ - ✅ Skills are read-only data
84
+ - ✅ No code execution
85
+ - ✅ SHA-256 verification
68
86
 
69
- ### 2. Install a skill
87
+ ---
70
88
 
71
- Install from GitHub with optional version pinning:
89
+ ## Commands
72
90
 
73
91
  ```bash
74
- # Latest version
75
- npx -y add-skill-kit agentskillkit/agent-skills
76
-
77
- # Specific skill
78
- npx -y add-skill-kit agentskillkit/agent-skills#react-patterns
92
+ # Install from repository
93
+ npx -y add-skill-kit <org/repo>
79
94
 
80
- # Specific version
81
- npx -y add-skill-kit agentskillkit/agent-skills#react-patterns@v1.0.0
82
- ```
95
+ # Install specific skill
96
+ npx -y add-skill-kit <org/repo>#skill-name
83
97
 
84
- ### 3. List installed skills
85
-
86
- ```bash
98
+ # List installed
87
99
  npx -y add-skill-kit list
88
- ```
89
100
 
90
- ### 4. Validate compliance
91
-
92
- ```bash
101
+ # Validate
93
102
  npx -y add-skill-kit validate
94
103
  ```
95
104
 
96
105
  ---
97
106
 
98
- ## Commands
107
+ ## Supported Agents
99
108
 
100
- | Command | Description |
101
- | :--- | :--- |
102
- | `init` | Initialize `.agent/skills` workspace |
103
- | `install <spec>` | Install a skill from GitHub or registry |
104
- | `uninstall <name>` | Remove an installed skill |
105
- | `update <name>` | Update a skill to latest version |
106
- | `upgrade-all` | Upgrade all skills in workspace |
107
- | `list` | List installed skills with metadata |
108
- | `validate` | Check Antigravity compliance |
109
- | `analyze <name>` | Inspect skill structure & Progressive Disclosure |
110
- | `doctor` | Check health & integrity |
111
- | `lock` | Generate `skill-lock.json` |
112
- | `cache clear` | Clear local cache |
109
+ | Agent | Status |
110
+ |-------|--------|
111
+ | **Antigravity** | ✅ Ready |
112
+ | Claude Code | 🔜 Coming |
113
+ | Gemini CLI | 🔜 Coming |
113
114
 
114
115
  ---
115
116
 
116
- ## Features
117
-
118
- ### Progressive Disclosure
119
-
120
- Skills follow a structured hierarchy that lets agents read only what they need:
121
-
122
- ```
123
- skill/
124
- ├── SKILL.md # Core instructions (always read)
125
- ├── resources/ # Reference materials (on-demand)
126
- ├── examples/ # Implementation patterns (when coding)
127
- ├── scripts/ # Helper utilities (when needed)
128
- ├── constitution/ # Governing rules
129
- └── doctrines/ # Behavioral policies
130
- ```
131
-
132
- ### Deterministic Locking
133
-
134
- Pin exact versions for reproducible builds across your team:
117
+ ## Install Now
135
118
 
136
119
  ```bash
137
- # Generate lockfile
138
- npx -y add-skill-kit lock
139
-
140
- # Install from lockfile
141
- npx -y add-skill-kit install --locked
120
+ npx -y add-skill-kit agentskillkit/agent-skills
142
121
  ```
143
122
 
144
- ### Security by Design
145
-
146
- | Feature | Description |
147
- | :--- | :--- |
148
- | **No Execution** | Skills are data artifacts, never executed |
149
- | **SHA-256 Hashing** | Every skill is verified against its Merkle hash |
150
- | **Integrity Checks** | `doctor` command detects tampering |
151
- | **Audit Trail** | Full provenance tracking in `.skill-source.json` |
152
-
153
- ---
154
-
155
- ## Documentation
156
-
157
- <table>
158
- <tbody>
159
- <tr>
160
- <td><a href="https://github.com/agentskillkit/add-skill-kit/blob/main/specs/SKILL_V1.md">Skill Spec v1.0</a></td>
161
- <td>The Antigravity Skills specification</td>
162
- </tr>
163
- <tr>
164
- <td><a href="https://github.com/agentskillkit/add-skill-kit/tree/main/examples">Examples</a></td>
165
- <td>Example skills and integration patterns</td>
166
- </tr>
167
- <tr>
168
- <td><a href="https://github.com/agentskillkit/add-skill-kit/issues">Issues</a></td>
169
- <td>Report bugs or request features</td>
170
- </tr>
171
- </tbody>
172
- </table>
173
-
174
- ---
175
-
176
- ## Community
177
-
178
- We welcome contributions! See our [Contributing Guide](https://github.com/agentskillkit/add-skill-kit/blob/main/CONTRIBUTING.md) to get started.
179
-
180
- <a href="https://github.com/agentskillkit/add-skill-kit/graphs/contributors">
181
- <img src="https://contrib.rocks/image?repo=agentskillkit/add-skill-kit" />
182
- </a>
183
-
184
- ---
185
-
186
123
  <p align="center">
187
- <sub>Built with ❤️ by <a href="https://github.com/agentskillkit">Agent Skill Kit</a></sub>
124
+ <sub>Built by <a href="https://github.com/agentskillkit">Agent Skill Kit</a></sub>
188
125
  </p>
189
126
 
190
127
  <p align="center">
191
128
  <a href="https://github.com/agentskillkit/add-skill-kit">GitHub</a> •
192
129
  <a href="https://www.npmjs.com/package/add-skill-kit">npm</a> •
193
- <a href="https://github.com/agentskillkit/add-skill-kit/blob/main/LICENSE">License</a>
130
+ <a href="https://github.com/agentskillkit/add-skill-kit/blob/main/LICENSE">MIT</a>
194
131
  </p>
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "add-skill-kit",
3
- "version": "1.0.3",
3
+ "version": "1.1.0",
4
4
  "description": "Enterprise-grade Agent Skill Manager with Antigravity Skills support, Progressive Disclosure detection, and semantic routing validation",
5
5
  "license": "MIT",
6
6
  "author": "agentskillkit <agentskillkit@gmail.com>",