add-skill-kit 1.3.3 → 1.5.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 (5) hide show
  1. package/README.md +121 -137
  2. package/bin/cli.js +2 -2
  3. package/bin/lib/commands/install.js +15 -1
  4. package/bin/lib/ui.js +30 -0
  5. package/package.json +1 -1
package/README.md CHANGED
@@ -1,204 +1,188 @@
1
- # add-skill-kit
1
+ # Add Skill Kit
2
2
 
3
- > **The package manager for AI Agent Skills**
3
+ > **Package Manager cho AI Agent Skills - Cài đặt 1 lệnh, dùng ngay lập tức**
4
4
 
5
5
  [![npm](https://img.shields.io/npm/v/add-skill-kit?style=flat&colorA=18181b&colorB=7c3aed)](https://www.npmjs.com/package/add-skill-kit)
6
6
  [![downloads](https://img.shields.io/npm/dm/add-skill-kit?style=flat&colorA=18181b&colorB=7c3aed)](https://www.npmjs.com/package/add-skill-kit)
7
- [![license](https://img.shields.io/github/license/agentskillkit/add-skill-kit?style=flat&colorA=18181b&colorB=7c3aed)](https://github.com/agentskillkit/add-skill-kit/blob/main/LICENSE)
7
+ [![license](https://img.shields.io/badge/license-MIT-7c3aed?style=flat&colorA=18181b)](LICENSE)
8
8
 
9
9
  ---
10
10
 
11
- ## Quick Install
11
+ ## 🎯 Lợi Ích Cho Bạn (Benefits)
12
+
13
+ ### ⚡ Từ 0 → Production-Ready Trong 30 Giây
12
14
 
13
15
  ```bash
14
16
  npx -y add-skill-kit agentskillkit/agent-skills
15
17
  ```
16
18
 
17
- Or install globally:
19
+ **Xong.** AI Agent của bạn đã có:
20
+ - 40+ skills chuyên môn
21
+ - 20 specialist agents
22
+ - 11 workflows có sẵn
18
23
 
19
- ```bash
20
- npm install -g add-skill-kit
21
- add-skill-kit agentskillkit/agent-skills
22
- ```
24
+ ### 🧩 Không Bao Giờ Copy-Paste Prompts Nữa
23
25
 
24
- This installs the `.agent` folder containing all templates into your project.
26
+ Quên việc:
27
+ - ❌ Tìm kiếm prompts tốt trên internet
28
+ - ❌ Copy-paste vào từng project
29
+ - ❌ Maintain nhiều phiên bản khác nhau
25
30
 
26
- ---
31
+ Với Add Skill Kit:
32
+ - ✅ **1 source of truth** - Cập nhật trung tâm, mọi project đều nhận
33
+ - ✅ **Symlink install** - Không duplicate files
34
+ - ✅ **Version control** - Rollback bất cứ lúc nào
27
35
 
28
- ## What's Included
36
+ ### 💡 AI Agent Của Bạn Tự Học
29
37
 
30
- | Component | Count | Description |
31
- |-----------|-------|-------------|
32
- | **Agents** | 20 | Specialist AI personas (frontend, backend, security, PM, QA, etc.) |
33
- | **Skills** | 40+ | Domain-specific knowledge modules |
34
- | **Workflows** | 11 | Slash command procedures |
38
+ ```bash
39
+ # Dạy AI một lesson mới
40
+ npx ag-smart learn --pattern "var " --message "Use const/let instead"
41
+
42
+ # Từ nay AI sẽ nhớ mãi và không lặp lại
43
+ ```
35
44
 
36
45
  ---
37
46
 
38
- ## Usage
47
+ ## 🚀 Quick Start
39
48
 
40
- ### Using Agents
49
+ ### Cài Đặt Skills
41
50
 
42
- **No need to mention agents explicitly!** The system automatically detects and applies the right specialist(s):
51
+ ```bash
52
+ # Install toàn bộ Agent Skills Kit
53
+ npx -y add-skill-kit agentskillkit/agent-skills
43
54
 
55
+ # Hoặc chỉ 1 skill cụ thể
56
+ npx -y add-skill-kit agentskillkit/agent-skills#react-patterns
44
57
  ```
45
- You: "Add JWT authentication"
46
- AI: 🤖 Applying @security-auditor + @backend-specialist...
47
58
 
48
- You: "Fix the dark mode button"
49
- AI: 🤖 Using @frontend-specialist...
50
-
51
- You: "Login returns 500 error"
52
- AI: 🤖 Using @debugger for systematic analysis...
53
- ```
59
+ ### Quản Lý Skills
54
60
 
55
- **How it works:**
56
- 1. Analyzes your request silently
57
- 2. Detects domain(s) automatically (frontend, backend, security, etc.)
58
- 3. Selects the best specialist(s)
59
- 4. Informs you which expertise is being applied
61
+ ```bash
62
+ # Liệt kê skills đã cài
63
+ add-skill-kit list
60
64
 
61
- **Benefits:**
62
- - ✅ Zero learning curve - just describe what you need
63
- - ✅ Always get expert responses
64
- - ✅ Transparent - shows which agent is being used
65
- - ✅ Can still override by mentioning agent explicitly
65
+ # Cập nhật skills
66
+ add-skill-kit update
66
67
 
67
- ---
68
+ # Gỡ cài đặt
69
+ add-skill-kit uninstall react-patterns
68
70
 
69
- ### Using Workflows
70
-
71
- Invoke workflows with slash commands:
72
-
73
- | Command | Description |
74
- |---------|-------------|
75
- | `/brainstorm` | Explore options before implementation |
76
- | `/create` | Create new features or apps |
77
- | `/debug` | Systematic debugging |
78
- | `/deploy` | Deploy application |
79
- | `/enhance` | Improve existing code |
80
- | `/orchestrate` | Multi-agent coordination |
81
- | `/plan` | Create task breakdown |
82
- | `/preview` | Preview changes locally |
83
- | `/status` | Check project status |
84
- | `/test` | Generate and run tests |
85
- | `/ui-ux-pro-max` | Design with 50 styles |
86
-
87
- **Example:**
88
- ```
89
- /brainstorm authentication system
90
- /create landing page with hero section
91
- /debug why login fails
71
+ # Kiểm tra health
72
+ add-skill-kit doctor
92
73
  ```
93
74
 
94
75
  ---
95
76
 
96
- ### Using Skills
77
+ ## 🏆 Ưu Điểm Vượt Trội (Advantages)
97
78
 
98
- Skills are loaded automatically based on task context:
99
-
100
- | Skill | Description |
101
- |-------|-------------|
102
- | `react-patterns` | Modern React hooks & composition |
103
- | `api-patterns` | REST, GraphQL, tRPC design |
104
- | `testing-patterns` | Unit, integration, E2E strategies |
105
- | `clean-code` | Pragmatic coding standards |
106
- | `systematic-debugging` | 4-phase debug methodology |
107
- | `vulnerability-scanner` | OWASP security audit |
108
- | ...and 30+ more | |
79
+ | Feature | Add Skill Kit | Copy-Paste Thủ Công |
80
+ |---------|---------------|---------------------|
81
+ | **Install time** | 30 giây | 30+ phút |
82
+ | **Cập nhật** | 1 lệnh | Manual mỗi file |
83
+ | **Consistency** | 100% đồng bộ | Dễ sai lệch |
84
+ | **Rollback** | ✅ Built-in | ❌ Manual backup |
85
+ | **Integrity check** | ✅ Merkle hash | ❌ Không có |
86
+ | **Self-learning** | ✅ Knowledge base | ❌ Không có |
109
87
 
110
88
  ---
111
89
 
112
- ## CLI Commands
90
+ ## 📦 Tính Năng Đầy Đủ (Features)
113
91
 
114
- ```bash
115
- # Install skills from repository
116
- npx -y add-skill-kit <org/repo>
92
+ ### 🔧 CLI Commands
117
93
 
118
- # Install specific skill
119
- npx -y add-skill-kit <org/repo>#skill-name
94
+ | Command | Chức năng |
95
+ |---------|-----------|
96
+ | `install` / `add` / `i` | Cài đặt skills từ GitHub |
97
+ | `uninstall` / `remove` / `rm` | Gỡ cài đặt |
98
+ | `update` | Cập nhật skills |
99
+ | `list` / `ls` | Liệt kê skills |
100
+ | `verify` | Kiểm tra integrity |
101
+ | `doctor` | Health check |
102
+ | `validate` / `check` | Validate spec |
103
+ | `analyze` | Phân tích skill |
104
+ | `info` / `show` | Thông tin skill |
105
+ | `lock` | Lock file |
106
+ | `cache` | Quản lý cache |
120
107
 
121
- # List installed skills
122
- npx -y add-skill-kit list
108
+ ### 🎯 Intelligent Installation
123
109
 
124
- # Validate skill integrity
125
- npx -y add-skill-kit validate
110
+ - **Interactive selection** - Chọn skills cần cài
111
+ - **Symlink mode** - Tiết kiệm disk space
112
+ - **Copy mode** - Offline support
113
+ - **Merkle verification** - Đảm bảo integrity
126
114
 
127
- # Check workspace health
128
- npx -y add-skill-kit doctor
129
- ```
115
+ ### 📁 Cài Đặt Đầy Đủ
130
116
 
131
- ---
132
-
133
- ## How It Works
134
-
135
- Skills are **data, not code**. They never execute on your system.
117
+ Một lệnh cài đặt tất cả:
136
118
 
137
119
  ```
138
- ┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
139
- │ GitHub Repo │────▶│ add-skill-kit │────▶│ .agent/skills │
140
- │ (source) │ │ (installer) │ │ (your project) │
141
- └─────────────────┘ └─────────────────┘ └─────────────────┘
142
- │
143
- ▼
144
- ┌─────────────────┐
145
- │ AI Agent │
146
- │ reads skills │
147
- └─────────────────┘
120
+ .agent/
121
+ ├── skills/ # 40+ domain skills
122
+ ├── agents/ # 20 specialist personas
123
+ ├── workflows/ # 11 slash commands
124
+ ├── knowledge/ # Self-learning memory
125
+ ├── rules/ # Global rules
126
+ ├── .shared/ # Shared resources
127
+ ├── GEMINI.md # Configuration
128
+ └── ARCHITECTURE.md
148
129
  ```
149
130
 
150
- **Security:**
151
- - ✅ Skills are read-only markdown & YAML
152
- - ✅ No scripts executed during install
153
- - ✅ SHA-256 integrity verification
154
- - ✅ Full audit trail in `.skill-source.json`
131
+ ### ⚡ 11 Slash Commands Có Sẵn
132
+ | Command | Chức năng |
133
+ |---------|-----------|
134
+ | `/brainstorm` | Khám phá options trước khi code |
135
+ | `/create` | Tạo features/apps mới |
136
+ | `/debug` | Debug có hệ thống |
137
+ | `/deploy` | Deploy production |
138
+ | `/enhance` | Thêm/cập nhật features |
139
+ | `/orchestrate` | Điều phối multi-agents |
140
+ | `/plan` | Lập kế hoạch task |
141
+ | `/preview` | Quản lý dev server |
142
+ | `/status` | Xem tiến độ project |
143
+ | `/test` | Tạo và chạy tests |
144
+ | `/ui-ux-pro-max` | Thiết kế UI chuyên sâu |
155
145
 
156
146
  ---
157
147
 
158
- ## Project Structure After Install
148
+ ## 🛠️ Development
159
149
 
160
- ```
161
- your-project/
162
- └── .agent/
163
- ├── skills/ # 40+ domain skills
164
- │ ├── react-patterns/
165
- │ ├── api-patterns/
166
- │ ├── testing-patterns/
167
- │ └── ...
168
- ├── workflows/ # Slash commands
169
- │ ├── brainstorm.md
170
- │ ├── debug.md
171
- │ └── ...
172
- └── GEMINI.md # Agent configuration
173
- ```
150
+ ```bash
151
+ # Clone
152
+ git clone https://github.com/agentskillkit/add-skill-kit.git
153
+ cd add-skill-kit
174
154
 
175
- ---
155
+ # Install dependencies
156
+ npm install
176
157
 
177
- ## Supported Agents
158
+ # Run tests
159
+ npm test
178
160
 
179
- | Agent | Status |
180
- |-------|--------|
181
- | **Antigravity** | ✅ Ready |
182
- | Claude Code | 🔜 Coming |
183
- | Gemini CLI | 🔜 Coming |
184
- | Codex | 🔜 Coming |
161
+ # Run linting
162
+ npm run lint
163
+ ```
185
164
 
186
165
  ---
187
166
 
188
- ## Requirements
167
+ ## 📋 Requirements
189
168
 
190
169
  - Node.js 18+
170
+ - Git (để clone repositories)
191
171
 
192
172
  ---
193
173
 
194
- ## Documentation
174
+ ## 🔗 Links
195
175
 
196
- - [GitHub Repository](https://github.com/agentskillkit/add-skill-kit)
197
- - [Issues & Feature Requests](https://github.com/agentskillkit/add-skill-kit/issues)
198
- - [npm Package](https://www.npmjs.com/package/add-skill-kit)
176
+ - [Agent Skills Kit (Content)](https://github.com/agentskillkit/agent-skills)
177
+ - [NPM Package](https://www.npmjs.com/package/add-skill-kit)
178
+ - [Issues](https://github.com/agentskillkit/add-skill-kit/issues)
199
179
 
200
180
  ---
201
181
 
202
- ## License
182
+ ## 📄 License
183
+
184
+ MIT - Sử dụng tự do.
185
+
186
+ ---
203
187
 
204
- MIT © [Agent Skill Kit](https://github.com/agentskillkit)
188
+ **⭐ Star nếu hữu ích. Cài đặt ngay. Build faster.**
package/bin/cli.js CHANGED
@@ -3,7 +3,7 @@
3
3
  * Install Agent Skill CLI
4
4
  * @description Package manager for AI Agent Skills
5
5
  */
6
- import { c, intro } from "./lib/ui.js";
6
+ import { c, brandedIntro } from "./lib/ui.js";
7
7
  import { command, params, VERSION } from "./lib/config.js";
8
8
 
9
9
  // --- Command Registry ---
@@ -52,7 +52,7 @@ function findCommand(cmd) {
52
52
 
53
53
  // --- MAIN ---
54
54
  async function main() {
55
- intro(c.bgBlue(c.white(` Add Skill Kit v${VERSION} `)));
55
+ brandedIntro(VERSION);
56
56
 
57
57
  try {
58
58
  // Handle version flag
package/bin/lib/commands/install.js CHANGED
@@ -302,7 +302,7 @@ export async function run(spec) {
302
302
 
303
303
  for (const sn of selectedSkills) {
304
304
  // Show actual target path
305
- const targetPath = path.relative(cwd, path.join(targetScope, sn));
305
+ const targetPath = path.relative(process.cwd(), path.join(targetScope, sn));
306
306
  summaryContent += `${c.cyan(targetPath)}\n`;
307
307
  summaryContent += ` ${c.dim(methodVerb)} ${c.gray("→")} ${c.dim(agentsString)}\n\n`;
308
308
  }
@@ -543,6 +543,20 @@ export async function run(spec) {
543
543
 
544
544
  fs.rmSync(tmp, { recursive: true, force: true });
545
545
 
546
+ // Install CLI package as devDependency
547
+ stepLine();
548
+ const cliSpinner = spinner();
549
+ cliSpinner.start("Installing Agent CLI");
550
+
551
+ try {
552
+ await execAsync("npm install -D @agent-skill-kit/cli", { timeout: 120000 });
553
+ cliSpinner.stop("Agent CLI installed");
554
+ step(c.dim("Run: npx agent"));
555
+ } catch (e) {
556
+ cliSpinner.stop(c.yellow("CLI installation skipped"));
557
+ step(c.dim("Run manually: npm i -D @agent-skill-kit/cli"));
558
+ }
559
+
546
560
  stepLine();
547
561
  console.log(` ${c.cyan("Done!")}`);
548
562
  console.log();
package/bin/lib/ui.js CHANGED
@@ -3,6 +3,7 @@
3
3
  */
4
4
 
5
5
  import kleur from "kleur";
6
+ import boxen from "boxen";
6
7
  import { intro, outro, multiselect, select, confirm, isCancel, cancel, text } from "@clack/prompts";
7
8
  import ora from "ora";
8
9
 
@@ -130,3 +131,32 @@ export function success(msg) {
130
131
  export function outputJSON(data, jsonMode) {
131
132
  if (jsonMode) console.log(JSON.stringify(data, null, 2));
132
133
  }
134
+
135
+ /**
136
+ * Create a nice box message
137
+ * @param {string} message - Message content
138
+ * @param {object} options - Box options
139
+ */
140
+ export function box(message, options = {}) {
141
+ return "\n" + boxen(message, {
142
+ padding: { top: 0, bottom: 0, left: 1, right: 1 },
143
+ margin: { top: 0, bottom: 0, left: 0, right: 0 },
144
+ borderStyle: "round",
145
+ borderColor: "blue",
146
+ ...options
147
+ });
148
+ }
149
+
150
+ /**
151
+ * Show branded intro with version
152
+ * @param {string} version - Package version
153
+ * @param {string} [status] - Optional status text
154
+ */
155
+ export function brandedIntro(version, status = "") {
156
+ const statusLine = status ? `\n\n ${c.dim(status)}` : "";
157
+ console.log(box(
158
+ `📦 Add Skill Kit v${version}${statusLine}`,
159
+ { borderColor: status.includes("✓") ? "green" : "blue" }
160
+ ));
161
+ }
162
+
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "add-skill-kit",
3
- "version": "1.3.3",
3
+ "version": "1.5.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>",