add-skill-kit 1.3.2 → 1.4.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 (3) hide show
  1. package/README.md +107 -138
  2. package/bin/lib/commands/install.js +22 -1
  3. package/package.json +1 -1
package/README.md CHANGED
@@ -1,204 +1,173 @@
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...
59
+ ### Quản Lý Skills
50
60
 
51
- You: "Login returns 500 error"
52
- AI: 🤖 Using @debugger for systematic analysis...
53
- ```
61
+ ```bash
62
+ # Liệt kê skills đã cài
63
+ add-skill-kit list
54
64
 
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
65
+ # Cập nhật skills
66
+ add-skill-kit update
60
67
 
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
68
+ # Gỡ cài đặt
69
+ add-skill-kit uninstall react-patterns
66
70
 
67
- ---
68
-
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
97
-
98
- Skills are loaded automatically based on task context:
77
+ ## 🏆 Ưu Điểm Vượt Trội (Advantages)
99
78
 
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>
117
-
118
- # Install specific skill
119
- npx -y add-skill-kit <org/repo>#skill-name
92
+ ### 🔧 CLI Commands
120
93
 
121
- # List installed skills
122
- npx -y add-skill-kit list
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 |
123
107
 
124
- # Validate skill integrity
125
- npx -y add-skill-kit validate
108
+ ### 🎯 Intelligent Installation
126
109
 
127
- # Check workspace health
128
- npx -y add-skill-kit doctor
129
- ```
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
130
114
 
131
- ---
115
+ ### 📁 Cài Đặt Đầy Đủ
132
116
 
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`
155
-
156
131
  ---
157
132
 
158
- ## Project Structure After Install
133
+ ## 🛠️ Development
159
134
 
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
- ```
135
+ ```bash
136
+ # Clone
137
+ git clone https://github.com/agentskillkit/add-skill-kit.git
138
+ cd add-skill-kit
174
139
 
175
- ---
140
+ # Install dependencies
141
+ npm install
176
142
 
177
- ## Supported Agents
143
+ # Run tests
144
+ npm test
178
145
 
179
- | Agent | Status |
180
- |-------|--------|
181
- | **Antigravity** | ✅ Ready |
182
- | Claude Code | 🔜 Coming |
183
- | Gemini CLI | 🔜 Coming |
184
- | Codex | 🔜 Coming |
146
+ # Run linting
147
+ npm run lint
148
+ ```
185
149
 
186
150
  ---
187
151
 
188
- ## Requirements
152
+ ## 📋 Requirements
189
153
 
190
154
  - Node.js 18+
155
+ - Git (để clone repositories)
191
156
 
192
157
  ---
193
158
 
194
- ## Documentation
159
+ ## 🔗 Links
195
160
 
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)
161
+ - [Agent Skills Kit (Content)](https://github.com/agentskillkit/agent-skills)
162
+ - [NPM Package](https://www.npmjs.com/package/add-skill-kit)
163
+ - [Issues](https://github.com/agentskillkit/add-skill-kit/issues)
199
164
 
200
165
  ---
201
166
 
202
- ## License
167
+ ## 📄 License
168
+
169
+ MIT - Sử dụng tự do.
170
+
171
+ ---
203
172
 
204
- MIT © [Agent Skill Kit](https://github.com/agentskillkit)
173
+ **⭐ Star nếu hữu ích. Cài đặt ngay. Build faster.**
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
  }
@@ -460,6 +460,22 @@ export async function run(spec) {
460
460
  }
461
461
  }
462
462
 
463
+ // Install .shared if it exists (contains shared resources like ui-ux-pro-max data)
464
+ const sharedDir = path.join(tmp, ".agent", ".shared");
465
+ const targetSharedDir = path.join(WORKSPACE, "..", ".shared");
466
+ let sharedInstalled = false;
467
+
468
+ if (fs.existsSync(sharedDir) && !fs.existsSync(targetSharedDir)) {
469
+ stepLine();
470
+ const ss = spinner();
471
+ ss.start("Installing shared resources");
472
+
473
+ fs.cpSync(sharedDir, targetSharedDir, { recursive: true });
474
+ sharedInstalled = true;
475
+
476
+ ss.stop("Installed .shared/ (ui-ux-pro-max data)");
477
+ }
478
+
463
479
  // Installation complete step
464
480
  stepLine();
465
481
  step("Installation complete");
@@ -506,6 +522,11 @@ export async function run(spec) {
506
522
  successContent += `${c.cyan("✓")} ${c.dim(`.agent/rules/ (${rulesInstalled} files)`)}\n`;
507
523
  }
508
524
 
525
+ // Shared resources summary
526
+ if (sharedInstalled) {
527
+ successContent += `${c.cyan("✓")} ${c.dim(".agent/.shared/ (ui-ux-pro-max data)")}\n`;
528
+ }
529
+
509
530
  // Build title
510
531
  const parts = [`${selectedSkills.length} skills`];
511
532
  if (workflowsInstalled > 0) parts.push(`${workflowsInstalled} workflows`);
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "add-skill-kit",
3
- "version": "1.3.2",
3
+ "version": "1.4.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>",