ai-developer-skill-os 3.0.0 → 3.1.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.
Files changed (43) hide show
  1. package/.agents/AGENTS.md +79 -46
  2. package/.github/workflows/ci.yml +56 -0
  3. package/CHANGELOG.md +53 -36
  4. package/README.md +97 -77
  5. package/bin/install.js +14 -2
  6. package/docs/GOVERNANCE.md +40 -0
  7. package/docs/SPEC.md +37 -0
  8. package/docs/adr/0001-intent-based-architecture.md +19 -0
  9. package/docs/adr/0002-kernel-freeze.md +21 -0
  10. package/docs/adr/0003-risk-based-verification.md +20 -0
  11. package/docs/adr/0004-progressive-evidence.md +19 -0
  12. package/docs/skill-classification.md +25 -0
  13. package/knowledge/backend/nodejs.md +52 -0
  14. package/knowledge/frontend/react.md +54 -0
  15. package/package.json +44 -34
  16. package/skills/qk-access-policy/SKILL.md +8 -1
  17. package/skills/qk-ai-builder/SKILL.md +8 -1
  18. package/skills/qk-api-lifecycle/SKILL.md +9 -1
  19. package/skills/qk-bug-resolution/SKILL.md +11 -2
  20. package/skills/qk-context-loader/SKILL.md +9 -1
  21. package/skills/qk-data-lifecycle/SKILL.md +9 -1
  22. package/skills/qk-design-to-code/SKILL.md +8 -1
  23. package/skills/qk-docs/SKILL.md +9 -1
  24. package/skills/qk-documentation-system/SKILL.md +8 -1
  25. package/skills/qk-engineering-standard/SKILL.md +10 -2
  26. package/skills/qk-feature-delivery/SKILL.md +12 -2
  27. package/skills/qk-help/SKILL.md +8 -1
  28. package/skills/qk-orchestrator/SKILL.md +9 -1
  29. package/skills/qk-policy-engine/SKILL.md +9 -1
  30. package/skills/qk-production-release/SKILL.md +9 -2
  31. package/skills/qk-project-bootstrap/SKILL.md +8 -1
  32. package/skills/qk-project-health/SKILL.md +10 -2
  33. package/skills/qk-project-memory/SKILL.md +8 -1
  34. package/skills/qk-system-evolution/SKILL.md +10 -2
  35. package/skills/qk-ui-audit/SKILL.md +10 -2
  36. package/skills/qk-ui-system-builder/SKILL.md +8 -1
  37. package/skills/qk-validation-gate/SKILL.md +10 -2
  38. package/skills.json +433 -556
  39. package/templates/skill-template.md +38 -0
  40. package/tests/install-script.test.js +38 -0
  41. package/tests/registry.test.js +111 -0
  42. package/tests/spec-compliance.test.js +193 -0
  43. package/vitest.config.js +11 -0
package/skills.json CHANGED
@@ -1,122 +1,95 @@
1
1
  {
2
- "version": "1.0.1",
2
+ "$schema": "https://ai-developer-skill-os.dev/schema/skills-registry.json",
3
+ "version": "3.1.0",
3
4
  "name": "AI Developer Skill OS",
4
- "description": "Multi-agent skill package for AI coding agents — Engineering + Frontend + Backend",
5
+ "description": "Enterprise-ready Agentic Framework for AI Coding Agents — Engineering + Frontend + Backend",
5
6
  "language": "en",
6
7
  "author": "Quang Khánh",
7
8
  "homepage": "https://github.com/phamquangkhanh2999/ai-developer-skill-os.git",
9
+ "kernel": {
10
+ "policy": "intent-based",
11
+ "contractVersion": "4.0",
12
+ "specRef": "docs/SPEC.md"
13
+ },
8
14
  "skills": [
9
15
  {
10
- "name": "qk-help",
11
- "path": "skills/qk-help/SKILL.md",
12
- "version": "1.0.0",
13
- "category": "engineering",
14
- "priority": "P0",
16
+ "name": "qk-access-policy",
17
+ "path": "skills/qk-access-policy/SKILL.md",
18
+ "version": "3.0.0",
19
+ "category": "security",
20
+ "subcategory": "orchestration",
21
+ "behavior": "static-analysis",
22
+ "intent": "review-code",
23
+ "priority": "high",
24
+ "tags": ["security", "rbac", "auth", "permissions"],
15
25
  "trigger": [
16
- "help",
17
- "list skills",
18
- "show tips",
19
- "danh sách skill"
26
+ "add roles",
27
+ "restrict access",
28
+ "authentication logic",
29
+ "RBAC",
30
+ "ABAC"
20
31
  ],
21
32
  "dependencies": [],
22
33
  "conflicts": [],
23
- "platforms": [
24
- "antigravity",
25
- "claude-code",
26
- "kilo-code",
27
- "cursor",
28
- "windsurf"
29
- ],
30
- "status": "planned",
31
- "description": "Tra cứu danh sách toàn bộ kỹ năng (skills) hiện có và đọc các mẹo kết hợp để code hiệu quả."
34
+ "platforms": ["claude-code", "cursor", "windsurf", "gemini-cli"],
35
+ "status": "ready",
36
+ "description": "Manage RBAC, ABAC, and security boundaries."
32
37
  },
33
38
  {
34
- "name": "qk-agent-orchestrator",
35
- "path": "skills/qk-agent-orchestrator/SKILL.md",
36
- "version": "1.0.0",
37
- "category": "engineering",
38
- "priority": "P0",
39
+ "name": "qk-ai-builder",
40
+ "path": "skills/qk-ai-builder/SKILL.md",
41
+ "version": "3.0.0",
42
+ "category": "ai",
43
+ "subcategory": "engineering",
44
+ "behavior": "development",
45
+ "intent": "implement-feature",
46
+ "priority": "medium",
47
+ "tags": ["ai", "llm", "prompt-engineering", "rag", "agents"],
39
48
  "trigger": [
40
- "plan this task",
41
- "how should I approach",
42
- "what should I do first",
43
- "help me organize",
44
- "break down this task",
45
- "where do I start"
49
+ "build a chatbot",
50
+ "add AI features",
51
+ "write prompts",
52
+ "RAG pipeline"
46
53
  ],
47
54
  "dependencies": [],
48
55
  "conflicts": [],
49
- "platforms": [
50
- "antigravity",
51
- "claude-code",
52
- "kilo-code",
53
- "cursor",
54
- "windsurf"
55
- ],
56
- "status": "planned",
57
- "description": "Phân tích yêu cầu, lên kế hoạch thực thi chi tiết và điều phối các tác vụ cho đúng skill. Không tự viết code."
56
+ "platforms": ["claude-code", "cursor", "windsurf", "gemini-cli"],
57
+ "status": "ready",
58
+ "description": "Design AI Logic, Prompts, RAG pipelines, and Agents."
58
59
  },
59
60
  {
60
- "name": "qk-context-manager",
61
- "path": "skills/qk-context-manager/SKILL.md",
62
- "version": "1.0.0",
61
+ "name": "qk-api-lifecycle",
62
+ "path": "skills/qk-api-lifecycle/SKILL.md",
63
+ "version": "3.0.0",
63
64
  "category": "engineering",
64
- "priority": "P0",
65
+ "subcategory": "backend",
66
+ "behavior": "development",
67
+ "intent": "implement-feature",
68
+ "priority": "high",
69
+ "tags": ["api", "backend", "frontend-integration", "endpoints"],
65
70
  "trigger": [
66
- "what files should I read",
67
- "summarize the project",
68
- "understand codebase",
69
- "project overview",
70
- "what is the architecture"
71
+ "create a new API",
72
+ "fix an API",
73
+ "integrate frontend with backend",
74
+ "API route",
75
+ "swagger"
71
76
  ],
72
77
  "dependencies": [],
73
78
  "conflicts": [],
74
- "platforms": [
75
- "antigravity",
76
- "claude-code",
77
- "kilo-code",
78
- "cursor",
79
- "windsurf"
80
- ],
81
- "status": "planned",
82
- "description": "Xác định các file cần thiết, tóm tắt kiến trúc và quản lý bộ nhớ ngữ cảnh để tránh tràn bộ nhớ."
83
- },
84
- {
85
- "name": "qk-project-audit",
86
- "path": "skills/qk-project-audit/SKILL.md",
87
- "version": "1.0.0",
88
- "category": "engineering",
89
- "priority": "P0",
90
- "trigger": [
91
- "audit",
92
- "review the codebase",
93
- "check for bugs",
94
- "health check",
95
- "analyze project",
96
- "what's wrong with",
97
- "find issues",
98
- "code review"
99
- ],
100
- "dependencies": [
101
- "context-manager"
102
- ],
103
- "conflicts": [],
104
- "platforms": [
105
- "antigravity",
106
- "claude-code",
107
- "kilo-code",
108
- "cursor",
109
- "windsurf"
110
- ],
111
- "status": "planned",
112
- "description": "Kiểm toán toàn bộ dự án để phát hiện bug ẩn, rủi ro bảo mật, vấn đề hiệu năng và nợ kỹ thuật trước khi sửa code."
79
+ "platforms": ["claude-code", "cursor", "windsurf", "gemini-cli"],
80
+ "status": "ready",
81
+ "description": "Design, implement, and integrate API endpoints."
113
82
  },
114
83
  {
115
- "name": "qk-bug-fix",
116
- "path": "skills/qk-bug-fix/SKILL.md",
117
- "version": "2.0.0",
84
+ "name": "qk-bug-resolution",
85
+ "path": "skills/qk-bug-resolution/SKILL.md",
86
+ "version": "3.0.0",
118
87
  "category": "engineering",
119
- "priority": "P0",
88
+ "subcategory": "validation",
89
+ "behavior": "development",
90
+ "intent": "fix-bug",
91
+ "priority": "high",
92
+ "tags": ["bug", "debug", "regression", "error"],
120
93
  "trigger": [
121
94
  "fix this bug",
122
95
  "it's broken",
@@ -129,563 +102,467 @@
129
102
  ],
130
103
  "dependencies": [],
131
104
  "conflicts": [],
132
- "platforms": [
133
- "antigravity",
134
- "claude-code",
135
- "kilo-code",
136
- "cursor",
137
- "windsurf"
138
- ],
139
- "status": "migrating",
140
- "description": "Chẩn đoán và sửa lỗi an toàn. Tái hiện lỗi, tìm nguyên nhân gốc rễ và áp dụng bản sửa lỗi tối thiểu, có kiểm chứng."
105
+ "platforms": ["claude-code", "cursor", "windsurf", "gemini-cli"],
106
+ "status": "ready",
107
+ "description": "Fix bugs and prevent regressions."
141
108
  },
142
109
  {
143
- "name": "qk-refactor",
144
- "path": "skills/qk-refactor/SKILL.md",
145
- "version": "1.0.0",
146
- "category": "engineering",
147
- "priority": "P2",
110
+ "name": "qk-context-loader",
111
+ "path": "skills/qk-context-loader/SKILL.md",
112
+ "version": "3.0.0",
113
+ "category": "utilities",
114
+ "subcategory": "orchestration",
115
+ "behavior": "static-analysis",
116
+ "intent": "review-code",
117
+ "priority": "medium",
118
+ "tags": ["context", "filesystem", "dependencies", "graph"],
148
119
  "trigger": [
149
- "refactor",
150
- "clean up",
151
- "restructure",
152
- "improve code quality",
153
- "too messy",
154
- "hard to maintain"
155
- ],
156
- "dependencies": [
157
- "project-audit"
120
+ "understand the codebase",
121
+ "what files should I read",
122
+ "project overview",
123
+ "what is the architecture",
124
+ "dependency graph"
158
125
  ],
126
+ "dependencies": [],
159
127
  "conflicts": [],
160
- "platforms": [
161
- "antigravity",
162
- "claude-code",
163
- "kilo-code",
164
- "cursor",
165
- "windsurf"
166
- ],
167
- "status": "planned",
168
- "description": "Tái cấu trúc và dọn dẹp mã nguồn để dễ bảo trì hơn mà không làm thay đổi logic hoạt động bên ngoài."
128
+ "platforms": ["claude-code", "cursor", "windsurf", "gemini-cli"],
129
+ "status": "ready",
130
+ "description": "Load relevant files and map the dependency graph for a task."
169
131
  },
170
132
  {
171
- "name": "qk-api-integration",
172
- "path": "skills/qk-api-integration/SKILL.md",
173
- "version": "2.0.0",
174
- "category": "engineering",
175
- "priority": "P1",
133
+ "name": "qk-data-lifecycle",
134
+ "path": "skills/qk-data-lifecycle/SKILL.md",
135
+ "version": "3.0.0",
136
+ "category": "database",
137
+ "subcategory": "backend",
138
+ "behavior": "development",
139
+ "intent": "implement-feature",
140
+ "priority": "medium",
141
+ "tags": ["database", "sql", "migration", "schema", "orm"],
176
142
  "trigger": [
177
- "integrate API",
178
- "call endpoint",
179
- "curl",
180
- "swagger",
181
- "openapi",
182
- "fetch data from",
183
- "connect to backend",
184
- "api layer"
143
+ "create a new database table",
144
+ "modify schema",
145
+ "write complex queries",
146
+ "migration",
147
+ "prisma",
148
+ "drizzle"
185
149
  ],
186
150
  "dependencies": [],
187
151
  "conflicts": [],
188
- "platforms": [
189
- "antigravity",
190
- "claude-code",
191
- "kilo-code",
192
- "cursor",
193
- "windsurf"
194
- ],
195
- "status": "migrating",
196
- "description": "Chuyển đổi tài liệu API (curl, swagger...) thành code tích hợp frontend chuẩn xác, có type an toàn và xử lý lỗi."
152
+ "platforms": ["claude-code", "cursor", "windsurf", "gemini-cli"],
153
+ "status": "ready",
154
+ "description": "Manage Database Schema, Migrations, and Repositories."
197
155
  },
198
156
  {
199
- "name": "qk-migration",
200
- "path": "skills/qk-migration/SKILL.md",
201
- "version": "1.0.0",
202
- "category": "engineering",
203
- "priority": "P2",
157
+ "name": "qk-design-to-code",
158
+ "path": "skills/qk-design-to-code/SKILL.md",
159
+ "version": "3.0.0",
160
+ "category": "frontend",
161
+ "subcategory": "visual",
162
+ "behavior": "development",
163
+ "intent": "implement-feature",
164
+ "priority": "high",
165
+ "tags": ["ui", "figma", "frontend", "styling", "css"],
204
166
  "trigger": [
205
- "upgrade",
206
- "migrate",
207
- "update dependencies",
208
- "breaking change",
209
- "version bump",
210
- "npm update",
211
- "library replacement"
212
- ],
213
- "dependencies": [
214
- "project-audit"
167
+ "upload image mockup",
168
+ "design requirement",
169
+ "pixel-perfect",
170
+ "convert to code"
215
171
  ],
172
+ "dependencies": [],
216
173
  "conflicts": [],
217
- "platforms": [
218
- "antigravity",
219
- "claude-code",
220
- "kilo-code",
221
- "cursor",
222
- "windsurf"
223
- ],
224
- "status": "planned",
225
- "description": "Nâng cấp dependency, chuyển đổi framework và thay thế thư viện một cách an toàn với chiến lược không downtime."
174
+ "platforms": ["claude-code", "cursor", "windsurf", "gemini-cli"],
175
+ "status": "ready",
176
+ "description": "Convert Figma/Images to semantic, pixel-perfect code components."
226
177
  },
227
178
  {
228
- "name": "qk-git-engineer",
229
- "path": "skills/qk-git-engineer/SKILL.md",
230
- "version": "1.0.0",
231
- "category": "engineering",
232
- "priority": "P2",
179
+ "name": "qk-docs",
180
+ "path": "skills/qk-docs/SKILL.md",
181
+ "version": "3.0.0",
182
+ "category": "documentation",
183
+ "subcategory": "maintenance",
184
+ "behavior": "static-analysis",
185
+ "intent": "maintain",
186
+ "priority": "low",
187
+ "tags": ["docs", "markdown", "jsdoc", "readme"],
233
188
  "trigger": [
234
- "commit",
235
- "write PR",
236
- "pull request",
237
- "changelog",
238
- "release notes",
239
- "git"
189
+ "write docs",
190
+ "update the README",
191
+ "generate JSDoc",
192
+ "documentation"
240
193
  ],
241
194
  "dependencies": [],
242
195
  "conflicts": [],
243
- "platforms": [
244
- "antigravity",
245
- "claude-code",
246
- "kilo-code",
247
- "cursor",
248
- "windsurf"
249
- ],
250
- "status": "planned",
251
- "description": "Viết commit message chuẩn Conventional Commits, mô tả Pull Request, Changelog và Release Notes chuyên nghiệp."
196
+ "platforms": ["claude-code", "cursor", "windsurf", "gemini-cli"],
197
+ "status": "ready",
198
+ "description": "Write and maintain human-readable project documentation."
252
199
  },
253
200
  {
254
- "name": "qk-frontend-architecture",
255
- "path": "skills/qk-frontend-architecture/SKILL.md",
256
- "version": "1.0.0",
257
- "category": "frontend",
258
- "priority": "P1",
201
+ "name": "qk-documentation-system",
202
+ "path": "skills/qk-documentation-system/SKILL.md",
203
+ "version": "3.0.0",
204
+ "category": "documentation",
205
+ "subcategory": "maintenance",
206
+ "behavior": "static-analysis",
207
+ "intent": "maintain",
208
+ "priority": "low",
209
+ "tags": ["architecture", "diagrams", "mermaid", "runbooks"],
259
210
  "trigger": [
260
- "where should I put this file",
261
- "folder structure",
262
- "project structure",
263
- "how to organize",
264
- "which directory"
265
- ],
266
- "dependencies": [
267
- "context-manager"
211
+ "generate architecture diagrams",
212
+ "DevOps manuals",
213
+ "system docs",
214
+ "mermaid diagram"
268
215
  ],
216
+ "dependencies": [],
269
217
  "conflicts": [],
270
- "platforms": [
271
- "antigravity",
272
- "claude-code",
273
- "kilo-code",
274
- "cursor",
275
- "windsurf"
276
- ],
277
- "status": "planned",
278
- "description": "Phân tích cấu trúc thư mục frontend và quyết định vị trí đặt file chuẩn xác theo kiến trúc hiện tại."
218
+ "platforms": ["claude-code", "cursor", "windsurf", "gemini-cli"],
219
+ "status": "ready",
220
+ "description": "Maintain system-level architecture docs and DevOps runbooks."
279
221
  },
280
222
  {
281
- "name": "qk-design-system",
282
- "path": "skills/qk-design-system/SKILL.md",
283
- "version": "1.0.0",
284
- "category": "frontend",
285
- "priority": "P1",
223
+ "name": "qk-engineering-standard",
224
+ "path": "skills/qk-engineering-standard/SKILL.md",
225
+ "version": "3.0.0",
226
+ "category": "standard",
227
+ "subcategory": "validation",
228
+ "behavior": "static-analysis",
229
+ "intent": "review-code",
230
+ "priority": "critical",
231
+ "tags": ["clean-code", "architecture", "refactoring", "solid", "naming"],
286
232
  "trigger": [
287
- "use button component",
288
- "design system",
289
- "component library",
290
- "which component to use",
291
- "UI tokens",
292
- "theme"
293
- ],
294
- "dependencies": [
295
- "frontend-architecture"
233
+ "review code",
234
+ "refactor code",
235
+ "clean code",
236
+ "SOLID",
237
+ "DRY",
238
+ "naming conventions"
296
239
  ],
240
+ "dependencies": [],
297
241
  "conflicts": [],
298
- "platforms": [
299
- "antigravity",
300
- "claude-code",
301
- "kilo-code",
302
- "cursor",
303
- "windsurf"
304
- ],
305
- "status": "planned",
306
- "description": "Ép buộc sử dụng design system, component library và token hiện có, ngăn chặn việc viết HTML/CSS rác."
242
+ "platforms": ["claude-code", "cursor", "windsurf", "gemini-cli"],
243
+ "status": "ready",
244
+ "description": "Enforce SOLID, DRY, Clean Code, and Naming conventions."
307
245
  },
308
246
  {
309
- "name": "qk-ui-builder",
310
- "path": "skills/qk-ui-builder/SKILL.md",
311
- "version": "1.0.0",
312
- "category": "frontend",
313
- "priority": "P1",
247
+ "name": "qk-feature-delivery",
248
+ "path": "skills/qk-feature-delivery/SKILL.md",
249
+ "version": "3.0.0",
250
+ "category": "engineering",
251
+ "subcategory": "fullstack",
252
+ "behavior": "development",
253
+ "intent": "implement-feature",
254
+ "priority": "high",
255
+ "tags": ["feature", "development", "e2e", "ui", "api"],
314
256
  "trigger": [
315
- "create page",
316
- "build UI",
317
- "add screen",
318
- "design layout",
319
- "make a form",
320
- "new view",
321
- "implement UI"
322
- ],
323
- "dependencies": [
324
- "design-system",
325
- "frontend-architecture"
257
+ "create a new page",
258
+ "build a new component",
259
+ "new endpoint",
260
+ "implement feature"
326
261
  ],
262
+ "dependencies": [],
327
263
  "conflicts": [],
328
- "platforms": [
329
- "antigravity",
330
- "claude-code",
331
- "kilo-code",
332
- "cursor",
333
- "windsurf"
334
- ],
335
- "status": "planned",
336
- "description": "Xây dựng các màn hình và layout phức tạp từ yêu cầu, tái sử dụng component và đảm bảo responsive."
264
+ "platforms": ["claude-code", "cursor", "windsurf", "gemini-cli"],
265
+ "status": "ready",
266
+ "description": "Develop new features end-to-end (Frontend & Backend)."
337
267
  },
338
268
  {
339
- "name": "qk-component-generator",
340
- "path": "skills/qk-component-generator/SKILL.md",
341
- "version": "1.0.0",
342
- "category": "frontend",
343
- "priority": "P1",
344
- "trigger": [
345
- "create component",
346
- "new component",
347
- "generate component",
348
- "add reusable"
349
- ],
350
- "dependencies": [
351
- "design-system",
352
- "frontend-architecture"
353
- ],
354
- "conflicts": [],
355
- "platforms": [
356
- "antigravity",
357
- "claude-code",
358
- "kilo-code",
359
- "cursor",
360
- "windsurf"
361
- ],
362
- "status": "planned",
363
- "description": "Tạo các UI Component độc lập, tái sử dụng được, có type an toàn và tuân thủ chuẩn design system."
364
- },
365
- {
366
- "name": "qk-state-management",
367
- "path": "skills/qk-state-management/SKILL.md",
368
- "version": "1.0.0",
369
- "category": "frontend",
370
- "priority": "P2",
269
+ "name": "qk-help",
270
+ "path": "skills/qk-help/SKILL.md",
271
+ "version": "3.0.0",
272
+ "category": "utilities",
273
+ "subcategory": "orchestration",
274
+ "behavior": "static-analysis",
275
+ "intent": "review-code",
276
+ "priority": "low",
277
+ "tags": ["help", "manual", "list", "tutorial"],
371
278
  "trigger": [
372
- "state",
373
- "zustand",
374
- "redux",
375
- "react query",
376
- "global state",
377
- "store",
378
- "context"
379
- ],
380
- "dependencies": [
381
- "frontend-architecture"
279
+ "help",
280
+ "list skills",
281
+ "show tips",
282
+ "danh sách skill",
283
+ "how to use"
382
284
  ],
285
+ "dependencies": [],
383
286
  "conflicts": [],
384
- "platforms": [
385
- "antigravity",
386
- "claude-code",
387
- "kilo-code",
388
- "cursor",
389
- "windsurf"
390
- ],
391
- "status": "planned",
392
- "description": "Xác định và triển khai chiến lược quản lý state phù hợp (Zustand, Redux, React Query, Local State)."
287
+ "platforms": ["claude-code", "cursor", "windsurf", "gemini-cli"],
288
+ "status": "ready",
289
+ "description": "Display the list of available skills and pro-tips."
393
290
  },
394
291
  {
395
- "name": "qk-form-builder",
396
- "path": "skills/qk-form-builder/SKILL.md",
397
- "version": "1.0.0",
398
- "category": "frontend",
399
- "priority": "P2",
292
+ "name": "qk-orchestrator",
293
+ "path": "skills/qk-orchestrator/SKILL.md",
294
+ "version": "3.0.0",
295
+ "category": "orchestration",
296
+ "subcategory": "meta",
297
+ "behavior": "static-analysis",
298
+ "intent": "review-code",
299
+ "priority": "critical",
300
+ "tags": ["router", "orchestrator", "delegation", "ai-manager"],
400
301
  "trigger": [
401
- "build form",
402
- "create form",
403
- "form validation",
404
- "login form",
405
- "edit form",
406
- "react hook form",
407
- "zod schema"
408
- ],
409
- "dependencies": [
410
- "design-system",
411
- "component-generator"
302
+ "plan this task",
303
+ "how should I approach",
304
+ "what should I do first",
305
+ "help me organize",
306
+ "break down this task",
307
+ "where do I start"
412
308
  ],
309
+ "dependencies": [],
413
310
  "conflicts": [],
414
- "platforms": [
415
- "antigravity",
416
- "claude-code",
417
- "kilo-code",
418
- "cursor",
419
- "windsurf"
420
- ],
421
- "status": "planned",
422
- "description": "Xây dựng Form chuẩn xác với quản lý trạng thái, validate dữ liệu (Zod, Yup) và xử lý hiển thị lỗi."
311
+ "platforms": ["claude-code", "cursor", "windsurf", "gemini-cli"],
312
+ "status": "ready",
313
+ "description": "Route user requests, parse intents, and delegate to the correct sub-skills."
423
314
  },
424
315
  {
425
- "name": "qk-table-crud-generator",
426
- "path": "skills/qk-table-crud-generator/SKILL.md",
427
- "version": "1.0.0",
428
- "category": "frontend",
429
- "priority": "P2",
316
+ "name": "qk-policy-engine",
317
+ "path": "skills/qk-policy-engine/SKILL.md",
318
+ "version": "3.0.0",
319
+ "category": "security",
320
+ "subcategory": "orchestration",
321
+ "behavior": "static-analysis",
322
+ "intent": "review-code",
323
+ "priority": "high",
324
+ "tags": ["security", "policy", "guardrails", "authorization"],
430
325
  "trigger": [
431
- "data table",
432
- "list screen",
433
- "CRUD",
434
- "admin table",
435
- "pagination",
436
- "filter table",
437
- "sort column"
438
- ],
439
- "dependencies": [
440
- "design-system",
441
- "api-integration"
326
+ "high-risk destructive action",
327
+ "DROP table",
328
+ "mass delete",
329
+ "policy evaluation"
442
330
  ],
331
+ "dependencies": [],
443
332
  "conflicts": [],
444
- "platforms": [
445
- "antigravity",
446
- "claude-code",
447
- "kilo-code",
448
- "cursor",
449
- "windsurf"
450
- ],
451
- "status": "planned",
452
- "description": "Tạo các bảng dữ liệu admin với đầy đủ tính năng phân trang, sắp xếp, lọc và thao tác thêm/sửa/xóa (CRUD)."
333
+ "platforms": ["claude-code", "cursor", "windsurf", "gemini-cli"],
334
+ "status": "ready",
335
+ "description": "Policy evaluation engine to ensure actions are authorized and safe."
453
336
  },
454
337
  {
455
- "name": "qk-frontend-debug",
456
- "path": "skills/qk-frontend-debug/SKILL.md",
457
- "version": "1.0.0",
458
- "category": "frontend",
459
- "priority": "P2",
338
+ "name": "qk-production-release",
339
+ "path": "skills/qk-production-release/SKILL.md",
340
+ "version": "3.0.0",
341
+ "category": "operations",
342
+ "subcategory": "devops",
343
+ "behavior": "validation",
344
+ "intent": "validate",
345
+ "priority": "high",
346
+ "tags": ["deploy", "release", "build", "production"],
460
347
  "trigger": [
461
- "react error",
462
- "hydration error",
463
- "component not rendering",
464
- "state not updating",
465
- "infinite rerender",
466
- "UI bug",
467
- "CSS issue"
348
+ "deploy the app",
349
+ "build for production",
350
+ "release a new version",
351
+ "CI/CD"
468
352
  ],
469
353
  "dependencies": [],
470
354
  "conflicts": [],
471
- "platforms": [
472
- "antigravity",
473
- "claude-code",
474
- "kilo-code",
475
- "cursor",
476
- "windsurf"
477
- ],
478
- "status": "planned",
479
- "description": "Chẩn đoán và sửa các lỗi đặc thù frontend như Hydration error, infinite re-render, stale closure và vỡ CSS."
355
+ "platforms": ["claude-code", "cursor", "windsurf", "gemini-cli"],
356
+ "status": "ready",
357
+ "description": "Prepare the codebase for a production release (Build, CI/CD, Security)."
480
358
  },
481
359
  {
482
- "name": "qk-frontend-testing",
483
- "path": "skills/qk-frontend-testing/SKILL.md",
484
- "version": "1.0.0",
485
- "category": "frontend",
486
- "priority": "P2",
360
+ "name": "qk-project-bootstrap",
361
+ "path": "skills/qk-project-bootstrap/SKILL.md",
362
+ "version": "3.0.0",
363
+ "category": "setup",
364
+ "subcategory": "engineering",
365
+ "behavior": "development",
366
+ "intent": "implement-feature",
367
+ "priority": "high",
368
+ "tags": ["bootstrap", "scaffolding", "setup", "init"],
487
369
  "trigger": [
488
- "write test",
489
- "unit test",
490
- "component test",
491
- "e2e",
492
- "jest",
493
- "vitest",
494
- "testing library"
495
- ],
496
- "dependencies": [
497
- "component-generator"
370
+ "start a new project",
371
+ "create a new repo",
372
+ "setup standard configurations",
373
+ "scaffold"
498
374
  ],
375
+ "dependencies": [],
499
376
  "conflicts": [],
500
- "platforms": [
501
- "antigravity",
502
- "claude-code",
503
- "kilo-code",
504
- "cursor",
505
- "windsurf"
506
- ],
507
- "status": "planned",
508
- "description": "Viết Unit, Component và E2E test bằng Jest, Vitest, RTL, Cypress. Tập trung vào hành vi người dùng."
377
+ "platforms": ["claude-code", "cursor", "windsurf", "gemini-cli"],
378
+ "status": "ready",
379
+ "description": "Initialize a new project with best practices, linters, and folder structures."
509
380
  },
510
381
  {
511
- "name": "qk-frontend-performance",
512
- "path": "skills/qk-frontend-performance/SKILL.md",
513
- "version": "1.0.0",
514
- "category": "frontend",
515
- "priority": "P2",
382
+ "name": "qk-project-health",
383
+ "path": "skills/qk-project-health/SKILL.md",
384
+ "version": "3.0.0",
385
+ "category": "architecture",
386
+ "subcategory": "validation",
387
+ "behavior": "static-analysis",
388
+ "intent": "review-code",
389
+ "priority": "medium",
390
+ "tags": ["audit", "architecture", "tech-debt", "code-smell"],
516
391
  "trigger": [
517
- "slow rendering",
518
- "performance",
519
- "bundle size",
520
- "too many rerenders",
521
- "lazy load",
522
- "optimize"
523
- ],
524
- "dependencies": [
525
- "project-audit"
392
+ "project review",
393
+ "architecture audit",
394
+ "health check",
395
+ "code smells",
396
+ "tech debt"
526
397
  ],
398
+ "dependencies": [],
527
399
  "conflicts": [],
528
- "platforms": [
529
- "antigravity",
530
- "claude-code",
531
- "kilo-code",
532
- "cursor",
533
- "windsurf"
534
- ],
535
- "status": "planned",
536
- "description": "Tối ưu hóa hiệu năng frontend: giảm kích thước bundle, chặn re-render thừa, lazy load và cải thiện Web Vitals."
400
+ "platforms": ["claude-code", "cursor", "windsurf", "gemini-cli"],
401
+ "status": "ready",
402
+ "description": "Comprehensive audit of Code Smells, Tech Debt, and Architecture."
537
403
  },
538
404
  {
539
- "name": "qk-accessibility-audit",
540
- "path": "skills/qk-accessibility-audit/SKILL.md",
541
- "version": "1.0.0",
542
- "category": "frontend",
543
- "priority": "P2",
405
+ "name": "qk-project-memory",
406
+ "path": "skills/qk-project-memory/SKILL.md",
407
+ "version": "3.0.0",
408
+ "category": "utilities",
409
+ "subcategory": "maintenance",
410
+ "behavior": "static-analysis",
411
+ "intent": "maintain",
412
+ "priority": "low",
413
+ "tags": ["memory", "context", "storage"],
544
414
  "trigger": [
545
- "accessibility",
546
- "a11y",
547
- "aria",
548
- "screen reader",
549
- "keyboard navigation",
550
- "contrast"
551
- ],
552
- "dependencies": [
553
- "ui-builder"
415
+ "remember a specific configuration",
416
+ "architectural decision",
417
+ "store context",
418
+ "long-term memory"
554
419
  ],
420
+ "dependencies": [],
555
421
  "conflicts": [],
556
- "platforms": [
557
- "antigravity",
558
- "claude-code",
559
- "kilo-code",
560
- "cursor",
561
- "windsurf"
562
- ],
563
- "status": "planned",
564
- "description": "Kiểm tra và sửa lỗi khả năng tiếp cận (a11y/WCAG). Đảm bảo hỗ trợ phím, screen reader và semantic HTML."
422
+ "platforms": ["claude-code", "cursor", "windsurf", "gemini-cli"],
423
+ "status": "ready",
424
+ "description": "Store and retrieve long-term project context across sessions."
565
425
  },
566
426
  {
567
- "name": "qk-backend-architecture",
568
- "path": "skills/qk-backend-architecture/SKILL.md",
569
- "version": "1.0.0",
570
- "category": "backend",
571
- "priority": "P3",
427
+ "name": "qk-system-evolution",
428
+ "path": "skills/qk-system-evolution/SKILL.md",
429
+ "version": "3.0.0",
430
+ "category": "operations",
431
+ "subcategory": "maintenance",
432
+ "behavior": "maintenance",
433
+ "intent": "maintain",
434
+ "priority": "high",
435
+ "tags": ["upgrade", "migration", "devops", "dependencies"],
572
436
  "trigger": [
573
- "backend structure",
574
- "service layer",
575
- "controller",
576
- "repository pattern",
577
- "clean architecture"
578
- ],
579
- "dependencies": [
580
- "context-manager"
437
+ "update a library",
438
+ "upgrade a framework",
439
+ "perform a major refactor",
440
+ "Next.js 13 to 14"
581
441
  ],
442
+ "dependencies": [],
582
443
  "conflicts": [],
583
- "platforms": [
584
- "antigravity",
585
- "claude-code",
586
- "kilo-code",
587
- "cursor",
588
- "windsurf"
589
- ],
590
- "status": "planned",
591
- "description": "Kiểm soát cấu trúc backend, ép buộc tuân thủ mô hình Layer (Controller/Service/Repository) và vị trí file."
444
+ "platforms": ["claude-code", "cursor", "windsurf", "gemini-cli"],
445
+ "status": "ready",
446
+ "description": "Safely upgrade dependencies, migrate frameworks, and manage rollbacks."
592
447
  },
593
448
  {
594
- "name": "qk-database-engineer",
595
- "path": "skills/qk-database-engineer/SKILL.md",
596
- "version": "1.0.0",
597
- "category": "backend",
598
- "priority": "P3",
449
+ "name": "qk-ui-audit",
450
+ "path": "skills/qk-ui-audit/SKILL.md",
451
+ "version": "3.0.0",
452
+ "category": "validation",
453
+ "subcategory": "frontend",
454
+ "behavior": "static-analysis",
455
+ "intent": "review-code",
456
+ "priority": "medium",
457
+ "tags": ["ui", "audit", "frontend", "a11y", "responsive"],
599
458
  "trigger": [
600
- "schema",
601
- "migration",
602
- "database",
603
- "query",
604
- "index",
605
- "prisma",
606
- "drizzle",
607
- "sql"
608
- ],
609
- "dependencies": [
610
- "backend-architecture"
459
+ "check the UI",
460
+ "review styling",
461
+ "run an audit",
462
+ "accessibility",
463
+ "contrast"
611
464
  ],
465
+ "dependencies": [],
612
466
  "conflicts": [],
613
- "platforms": [
614
- "antigravity",
615
- "claude-code",
616
- "kilo-code",
617
- "cursor",
618
- "windsurf"
619
- ],
620
- "status": "planned",
621
- "description": "Thiết kế database schema, viết script migration và tối ưu truy vấn cho SQL/NoSQL bằng ORM (Prisma, Drizzle...)."
467
+ "platforms": ["claude-code", "cursor", "windsurf", "gemini-cli"],
468
+ "status": "ready",
469
+ "description": "Audit UI for Consistency, Accessibility, Responsive, and Performance."
622
470
  },
623
471
  {
624
- "name": "qk-auth-security",
625
- "path": "skills/qk-auth-security/SKILL.md",
626
- "version": "1.0.0",
627
- "category": "backend",
628
- "priority": "P3",
472
+ "name": "qk-ui-system-builder",
473
+ "path": "skills/qk-ui-system-builder/SKILL.md",
474
+ "version": "3.0.0",
475
+ "category": "frontend",
476
+ "subcategory": "design",
477
+ "behavior": "development",
478
+ "intent": "implement-feature",
479
+ "priority": "medium",
480
+ "tags": ["design-system", "tokens", "shared-components", "storybook"],
629
481
  "trigger": [
630
- "authentication",
631
- "authorization",
632
- "JWT",
633
- "OAuth",
634
- "RBAC",
635
- "login system",
636
- "security"
637
- ],
638
- "dependencies": [
639
- "backend-architecture"
482
+ "create a shared component",
483
+ "extract color palette",
484
+ "design tokens",
485
+ "storybook"
640
486
  ],
487
+ "dependencies": [],
641
488
  "conflicts": [],
642
- "platforms": [
643
- "antigravity",
644
- "claude-code",
645
- "kilo-code",
646
- "cursor",
647
- "windsurf"
648
- ],
649
- "status": "planned",
650
- "description": "Triển khai tính năng đăng nhập (JWT, OAuth), phân quyền (RBAC) và bảo vệ app khỏi các lỗ hổng OWASP."
489
+ "platforms": ["claude-code", "cursor", "windsurf", "gemini-cli"],
490
+ "status": "ready",
491
+ "description": "Build and maintain Design Systems, Token extraction, and shared UI libraries."
651
492
  },
652
493
  {
653
- "name": "qk-deployment",
654
- "path": "skills/qk-deployment/SKILL.md",
655
- "version": "1.0.0",
656
- "category": "backend",
657
- "priority": "P3",
494
+ "name": "qk-validation-gate",
495
+ "path": "skills/qk-validation-gate/SKILL.md",
496
+ "version": "3.0.0",
497
+ "category": "validation",
498
+ "subcategory": "quality",
499
+ "behavior": "validation",
500
+ "intent": "validate",
501
+ "priority": "critical",
502
+ "tags": ["ci", "testing", "linting", "security", "gatekeeper"],
658
503
  "trigger": [
659
- "deploy",
660
- "CI/CD",
661
- "docker",
662
- "kubernetes",
663
- "pipeline",
664
- "release",
665
- "environment"
504
+ "check the code",
505
+ "run validation",
506
+ "lint",
507
+ "test",
508
+ "type check",
509
+ "quality gate"
666
510
  ],
667
511
  "dependencies": [],
668
512
  "conflicts": [],
669
- "platforms": [
670
- "antigravity",
671
- "claude-code",
672
- "kilo-code",
673
- "cursor",
674
- "windsurf"
675
- ],
676
- "status": "planned",
677
- "description": "Cấu hình CI/CD pipelines, tạo Dockerfile và thiết lập môi trường để deploy lên Vercel, AWS hoặc VPS."
513
+ "platforms": ["claude-code", "cursor", "windsurf", "gemini-cli"],
514
+ "status": "ready",
515
+ "description": "Mandatory Quality Gate (Test, Lint, Security)."
678
516
  }
679
517
  ],
680
- "entries": [
681
- {
682
- "path": "skills/qk-"
683
- },
684
- {
685
- "path": "skills/qk-"
686
- },
687
- {
688
- "path": "skills/qk-"
689
- }
690
- ]
691
- }
518
+ "categories": {
519
+ "static-analysis": [
520
+ "qk-access-policy",
521
+ "qk-context-loader",
522
+ "qk-docs",
523
+ "qk-documentation-system",
524
+ "qk-engineering-standard",
525
+ "qk-help",
526
+ "qk-orchestrator",
527
+ "qk-policy-engine",
528
+ "qk-project-health",
529
+ "qk-project-memory",
530
+ "qk-ui-audit"
531
+ ],
532
+ "development": [
533
+ "qk-ai-builder",
534
+ "qk-api-lifecycle",
535
+ "qk-data-lifecycle",
536
+ "qk-design-to-code",
537
+ "qk-feature-delivery",
538
+ "qk-project-bootstrap",
539
+ "qk-ui-system-builder"
540
+ ],
541
+ "validation": [
542
+ "qk-production-release",
543
+ "qk-validation-gate"
544
+ ],
545
+ "maintenance": [
546
+ "qk-system-evolution"
547
+ ]
548
+ },
549
+ "knowledge": [
550
+ "knowledge/frontend/react.md",
551
+ "knowledge/backend/nodejs.md"
552
+ ],
553
+ "templates": [
554
+ "templates/bug-report.md",
555
+ "templates/feature-report.md",
556
+ "templates/review-report.md",
557
+ "templates/design-report.md",
558
+ "templates/skill-template.md"
559
+ ],
560
+ "meta": {
561
+ "lastAudited": "2026-07-02",
562
+ "auditedBy": "kilo-auto/free",
563
+ "specCompliance": "4.0",
564
+ "totalSkills": 22,
565
+ "readySkills": 22,
566
+ "archivedSkills": 22
567
+ }
568
+ }