ai-developer-skill-os 1.6.0 → 1.8.1

package/README.md

@@ -57,6 +57,16 @@ Sau khi thư mục kỹ năng đã xuất hiện trong dự án của bạn, hã
 **Không cần cấu hình gì thêm!** Nếu bạn đã cài đặt bằng cờ `--gemini` (thư mục `.agents/skills/`), hệ thống sẽ tự động quét và load toàn bộ 23 kỹ năng này. Bạn có thể sử dụng ngay lập tức!
 
 ### Cho Claude Code / Kilo Code (CLI Agents)
+#### Cách 1: Cài đặt Native (Khuyên dùng cho Kilo Code)
+Chạy `npx ai-developer-skill-os init` và chọn **(6) Kilo Code**.
+Hệ thống sẽ tự động:
+- Copy toàn bộ skills vào `.kilo/skills/` (Local) hoặc `~/.kilo/skills/` (Global)
+- Cấu hình `kilo.json` hoặc `~/.config/kilo/kilo.json` để Kilo nhận diện
+- Tạo file `CLAUDE.md` như hướng dẫn bổ sung
+
+Sau đó mở Kilo Code, dùng `<leader>t` hoặc `/themes` để kiểm tra skills đã được cài.
+
+#### Cách 2: Thủ công
 Tạo file `CLAUDE.md` (hoặc `KILO.md`) ở gốc dự án và dán đoạn sau vào:
 ```md
 # System Instructions
@@ -133,10 +143,15 @@ Trước khi đổi một cấu trúc lớn, hãy bắt AI dò mìn:
 
 ---
 
-## 💎 Danh sách 23+ Kỹ Năng Độc Quyền
+## 💎 **Danh sách đầy đủ các Kỹ năng đang có trong Skill OS:**
+*(Bạn có thể gọi trực tiếp trên Terminal hoặc Chat)*
+
+> 💡 **Mẹo (Pro-Tip):** Bất cứ khi nào bạn quên mất danh sách kỹ năng hoặc cách dùng, chỉ cần gõ lệnh `./qk-help` (hoặc `@qk-help`), hệ thống sẽ xuất ra toàn bộ cẩm nang sử dụng và bí kíp kết hợp Kỹ năng (Skill Chaining) ngay lập tức!
 
-| Phân hệ | Kỹ năng tiêu biểu | Chức năng chính |
-|---------|-------------------|-----------------|
+| Kỹ năng (Skill) | Nhiệm vụ chuyên môn |
+|-----------------|---------------------|
+| 🧠 **`qk-help`** | **[MỚI] Sách hướng dẫn tra cứu nhanh danh sách Skill và Bí kíp kết hợp** |
+| 🧑‍💻 **`qk-ui-builder`** | Xây dựng UI, vẽ Màn hình, chia Layout, tạo Modal cực đẹp |
 | 🏗️ **Engineering** | `qk-project-audit`, `qk-agent-orchestrator` | Kiểm toán dự án, lập kế hoạch, quản lý Git, Refactor code. |
 | 🎨 **Frontend** | `qk-ui-builder`, `qk-frontend-performance` | Dựng UI, tối ưu tốc độ, test component, quản lý State. |
 | ⚙️ **Backend** | `qk-database-engineer`, `qk-auth-security` | Thiết kế DB Schema, bảo mật JWT/OAuth, cấu hình CI/CD. |

package/bin/install.js

@@ -28,19 +28,56 @@ function cleanOldSkills(targetSkillsDir, isGeminiGlobal) {
   if (fs.existsSync(targetSkillsDir)) {
     console.log('🧹 Đang dọn dẹp phiên bản cũ để tối ưu hệ thống...');
     if (isGeminiGlobal) {
-      // Chỉ xoá các thư mục qk-* để không ảnh hưởng các skill khác của người dùng
       fs.readdirSync(targetSkillsDir).forEach(item => {
         if (item.startsWith('qk-')) {
           fs.rmSync(path.join(targetSkillsDir, item), { recursive: true, force: true });
         }
       });
     } else {
-      // Xoá sạch toàn bộ thư mục kỹ năng của bộ công cụ này
       fs.rmSync(targetSkillsDir, { recursive: true, force: true });
     }
   }
 }
 
+function ensureKiloConfig(kiloJsonPath, kiloSkillsDir, kiloThemesDir, kiloCommandsDir) {
+  if (!fs.existsSync(kiloSkillsDir)) {
+    fs.mkdirSync(kiloSkillsDir, { recursive: true });
+  }
+  if (!fs.existsSync(kiloThemesDir)) {
+    fs.mkdirSync(kiloThemesDir, { recursive: true });
+  }
+  if (!fs.existsSync(kiloCommandsDir)) {
+    fs.mkdirSync(kiloCommandsDir, { recursive: true });
+  }
+
+  const srcSkills = path.join(sourceDir, 'skills');
+  if (fs.existsSync(srcSkills)) {
+    copyRecursiveSync(srcSkills, kiloSkillsDir);
+  }
+
+  let kiloConfig = {};
+  if (fs.existsSync(kiloJsonPath)) {
+    try {
+      kiloConfig = JSON.parse(fs.readFileSync(kiloJsonPath, 'utf8'));
+    } catch (e) {
+      kiloConfig = {};
+    }
+  }
+
+  const skillPaths = [kiloSkillsDir];
+  if (!Array.isArray(kiloConfig.skills) || typeof kiloConfig.skills !== 'object' || !kiloConfig.skills.paths) {
+    kiloConfig.skills = { paths: skillPaths };
+  } else {
+    const exists = kiloConfig.skills.paths.some(p => path.resolve(p) === path.resolve(kiloSkillsDir));
+    if (!exists) {
+      kiloConfig.skills.paths = [...kiloConfig.skills.paths, ...skillPaths];
+    }
+  }
+
+  fs.writeFileSync(kiloJsonPath, JSON.stringify(kiloConfig, null, 2) + '\n');
+  return kiloJsonPath;
+}
+
 const rl = readline.createInterface({
   input: process.stdin,
   output: process.stdout
@@ -55,9 +92,10 @@ const questionIde = `Vui lòng chọn IDE/AI Assistant bạn đang sử dụng:
 (4) Antigravity / Gemini
 (5) Codex
 (6) Kilo Code
+(7) Tất cả các IDE (Multi-IDE)
 (0) Bỏ qua (Không tạo config tự động)
 
-Nhập số (0-6): `;
+Nhập số (0-7): `;
 
 const questionScope = `
 Bạn muốn cài đặt bộ kỹ năng ở đâu?
@@ -68,6 +106,8 @@ Nhập số (1-2): `;
 
 rl.question(questionIde, (answerIde) => {
   let isGemini = false;
+  let isKilo = false;
+  let isMultiIde = false;
   let ruleFileName = null;
   const ideCode = answerIde.trim();
 
@@ -77,20 +117,35 @@ rl.question(questionIde, (answerIde) => {
     case '3': ruleFileName = '.clinerules'; break;
     case '4': isGemini = true; break;
     case '5': ruleFileName = '.codexrules'; break;
-    case '6': ruleFileName = '.kilorules'; break;
+    case '6': ruleFileName = '.kilorules'; isKilo = true; break;
+    case '7': isMultiIde = true; ruleFileName = null; break;
     case '0': default: break;
   }
 
   rl.question(questionScope, (answerScope) => {
     const isGlobal = answerScope.trim() === '2';
     
+    const homeDir = os.homedir();
+    const cwd = process.cwd();
     let targetDir = '';
     let ruleFilePath = null;
     let baseFolderForPrompt = '';
-    const homeDir = os.homedir();
-    const cwd = process.cwd();
+    let kiloJsonPath = null;
+    let kiloSkillsDir = null;
+    let kiloThemesDir = null;
+    let kiloCommandsDir = null;
 
-    if (isGemini) {
+    if (isMultiIde) {
+      targetDir = path.join(cwd, '.qk-ai-skill-os');
+      baseFolderForPrompt = './.qk-ai-skill-os';
+      ruleFilePath = path.join(cwd, 'CLAUDE.md');
+      if (!isGlobal) {
+        kiloSkillsDir = path.join(cwd, '.kilo', 'skills');
+        kiloThemesDir = path.join(cwd, '.kilo', 'themes');
+        kiloCommandsDir = path.join(cwd, '.kilo', 'command');
+        kiloJsonPath = path.join(cwd, 'kilo.json');
+      }
+    } else if (isGemini) {
       if (isGlobal) {
         targetDir = path.join(homeDir, '.gemini', 'config');
         ruleFilePath = path.join(targetDir, 'AGENTS.md');
@@ -100,6 +155,23 @@ rl.question(questionIde, (answerIde) => {
         ruleFilePath = path.join(cwd, '.agents', 'AGENTS.md');
         baseFolderForPrompt = '.agents/skills';
       }
+    } else if (isKilo) {
+      if (isGlobal) {
+        targetDir = path.join(homeDir, '.qk-ai-skill-os');
+        baseFolderForPrompt = targetDir.replace(/\\/g, '/');
+        kiloSkillsDir = path.join(homeDir, '.kilo', 'skills');
+        kiloThemesDir = path.join(homeDir, '.config', 'kilo', 'themes');
+        kiloCommandsDir = path.join(homeDir, '.config', 'kilo', 'command');
+        kiloJsonPath = path.join(homeDir, '.config', 'kilo', 'kilo.json');
+      } else {
+        targetDir = path.join(cwd, '.qk-ai-skill-os');
+        baseFolderForPrompt = './.qk-ai-skill-os';
+        kiloSkillsDir = path.join(cwd, '.kilo', 'skills');
+        kiloThemesDir = path.join(cwd, '.kilo', 'themes');
+        kiloCommandsDir = path.join(cwd, '.kilo', 'command');
+        kiloJsonPath = path.join(cwd, 'kilo.json');
+      }
+      ruleFilePath = path.join(cwd, 'CLAUDE.md');
     } else {
       if (isGlobal) {
         targetDir = path.join(homeDir, '.qk-ai-skill-os');
@@ -136,49 +208,78 @@ Nếu người dùng sử dụng tham số (argument), bạn BẮT BUỘC phải
         'skills', '_template', 'docs', 'skills.json', 'README.md', 'CHANGELOG.md', 'LICENSE'
       ];
 
-      // Nếu là Gemini Global, chỉ cần copy skills và skills.json để tránh rác
       if (isGemini && isGlobal) {
         if (fs.existsSync(path.join(sourceDir, 'skills'))) {
-            copyRecursiveSync(path.join(sourceDir, 'skills'), path.join(targetDir, 'skills'));
+          copyRecursiveSync(path.join(sourceDir, 'skills'), path.join(targetDir, 'skills'));
         }
         if (fs.existsSync(path.join(sourceDir, 'skills.json'))) {
-            fs.copyFileSync(path.join(sourceDir, 'skills.json'), path.join(targetDir, 'skills', 'skills.json'));
+          fs.copyFileSync(path.join(sourceDir, 'skills.json'), path.join(targetDir, 'skills', 'skills.json'));
         }
       } else {
         filesAndFolders.forEach(item => {
-            const src = path.join(sourceDir, item);
-            let dest = path.join(targetDir, item);
-            if (fs.existsSync(src)) {
-                copyRecursiveSync(src, dest);
-            }
+          const src = path.join(sourceDir, item);
+          let dest = path.join(targetDir, item);
+          if (fs.existsSync(src)) {
+            copyRecursiveSync(src, dest);
+          }
         });
       }
 
       if (ruleFilePath) {
-          const ruleDir = path.dirname(ruleFilePath);
-          if (ruleDir !== cwd && !fs.existsSync(ruleDir)) {
-              fs.mkdirSync(ruleDir, { recursive: true });
-          }
-          
-          let writeContent = systemPrompt;
-          if (isGemini) {
-              writeContent = `\n<RULE[ai_skill_os]>\n---\ntrigger: always_on\n---\n${systemPrompt}\n</RULE[ai_skill_os]>\n`;
-          }
+        const ruleDir = path.dirname(ruleFilePath);
+        if (ruleDir !== cwd && !fs.existsSync(ruleDir)) {
+          fs.mkdirSync(ruleDir, { recursive: true });
+        }
 
-          if (fs.existsSync(ruleFilePath)) {
-              fs.appendFileSync(ruleFilePath, "\n\n" + writeContent);
-              console.log(`✅ Đã GHI THÊM cấu hình tự động vào file: ${ruleFilePath}`);
-          } else {
-              fs.writeFileSync(ruleFilePath, writeContent);
-              console.log(`✅ Đã TẠO MỚI file cấu hình: ${ruleFilePath}`);
-          }
+        let writeContent = systemPrompt;
+        if (isGemini) {
+          writeContent = `\n<RULE[ai_skill_os]>\n---\ntrigger: always_on\n---\n${systemPrompt}\n</RULE[ai_skill_os]>\n`;
+        }
+
+        if (fs.existsSync(ruleFilePath)) {
+          fs.appendFileSync(ruleFilePath, "\n\n" + writeContent);
+          console.log(`✅ Đã GHI THÊM cấu hình tự động vào file: ${ruleFilePath}`);
+        } else {
+          fs.writeFileSync(ruleFilePath, writeContent);
+          console.log(`✅ Đã TẠO MỚI file cấu hình: ${ruleFilePath}`);
+        }
+      }
+
+      if (isKilo) {
+        ensureKiloConfig(kiloJsonPath, kiloSkillsDir, kiloThemesDir, kiloCommandsDir);
+        console.log(`✅ Đã cấu hình Kilo Code tại: ${kiloJsonPath}`);
+        console.log(`   → Skills: ${kiloSkillsDir}`);
+        console.log(`   → Themes: ${kiloThemesDir}`);
+        console.log(`   → Commands: ${kiloCommandsDir}`);
+      }
+
+      if (isMultiIde) {
+        if (kiloJsonPath && kiloSkillsDir) {
+          ensureKiloConfig(kiloJsonPath, kiloSkillsDir, kiloThemesDir, kiloCommandsDir);
+          console.log(`✅ Đã cấu hình Kilo Code (Multi-IDE) tại: ${kiloJsonPath}`);
+          console.log(`   → Skills: ${kiloSkillsDir}`);
+          console.log(`   → Themes: ${kiloThemesDir}`);
+          console.log(`   → Commands: ${kiloCommandsDir}`);
+        } else if (ruleFilePath) {
+          console.log(`✅ Đã tạo file cấu hình Multi-IDE: ${ruleFilePath}`);
+        }
       }
 
       console.log(`\n🎉 HOÀN TẤT! Dữ liệu kỹ năng đã được lưu tại: ${targetDir}`);
       if (isGlobal && !isGemini) {
-        console.log(`💡 Lưu ý: Kỹ năng đã được cài ở cấp độ máy tính (Global). File cấu hình cục bộ (${ruleFileName}) ở dự án này đang trỏ thẳng về thư mục Global đó.`);
+        const name = ruleFilePath ? path.basename(ruleFilePath) : 'CLAUDE.md';
+        console.log(`💡 Lưu ý: Kỹ năng đã được cài ở cấp độ máy tính (Global). File cấu hình cục bộ (${name}) ở dự án này đang trỏ thẳng về thư mục Global đó.`);
       } else if (isGlobal && isGemini) {
         console.log(`💡 Lưu ý: Antigravity đã được cài Global. Từ nay bạn mở BẤT KỲ DỰ ÁN NÀO trên máy tính này, Antigravity cũng sẽ tự động có đủ 23 kỹ năng mà không cần cài lại!`);
+      } else if (isKilo) {
+        console.log(`💡 Lưu ý: Kilo Code đã sẵn sàng. Dùng \`<leader>t\` hoặc \`/themes\` để xem, và \`/skills\` để xem danh sách skill đã cài.`);
+      }
+
+      if (!isGemini && !isKilo && !isMultiIde) {
+        if (fs.existsSync(path.join(cwd, '.kilorules'))) {
+          fs.unlinkSync(path.join(cwd, '.kilorules'));
+          console.log(`🧹 Đã xoá file .kilorules cũ (không còn cần thiết).`);
+        }
       }
 
     } catch (error) {

package/docs/HUONG_DAN_SU_DUNG.md

@@ -59,6 +59,16 @@ Speak to me in Vietnamese, but write all code in English.
 ```
 
 ### Cho Claude Code / Kilo Code (CLI Agents)
+#### Cách 1: Cài đặt Native (Khuyên dùng cho Kilo Code)
+Chạy `npx ai-developer-skill-os init` và chọn **(6) Kilo Code**.
+Hệ thống sẽ tự động:
+- Copy toàn bộ skills vào `.kilo/skills/` (Local) hoặc `~/.kilo/skills/` (Global)
+- Cấu hình `kilo.json` hoặc `~/.config/kilo/kilo.json` để Kilo nhận diện
+- Tạo file `CLAUDE.md` như hướng dẫn bổ sung
+
+Sau đó mở Kilo Code, dùng `<leader>t` hoặc `/themes` để kiểm tra skills đã được cài.
+
+#### Cách 2: Thủ công
 Tạo file `CLAUDE.md` (hoặc `KILO.md`) ở gốc dự án và dán đoạn sau vào:
 ```md
 # System Instructions

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-developer-skill-os",
-  "version": "1.6.0",
+  "version": "1.8.1",
   "description": "Multi-agent skill package cho AI coding agents (Claude, Cursor, Windsurf, Antigravity) với 23 skills chuyên nghiệp.",
   "main": "bin/install.js",
   "bin": {

package/skills/qk-api-integration/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: qk-api-integration
+name: qk-api-integration
 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.
 version: 2.0.0
@@ -37,6 +37,248 @@ Activate this skill when the user provides any of:
 - ✅ Generate typed service/client, hooks/queries, and TypeScript types
 - ✅ Follow and extend existing architecture — never duplicate it
 - ✅ Handle special cases: file upload, file download, pagination, auth, WebSocket
+
+---
+
+## Non-goals
+
+- ❌ Do NOT create a new HTTP client if one already exists
+- ❌ Do NOT introduce a new state system if one is already in use
+- ❌ Do NOT hardcode URLs, tokens, or secrets
+- ❌ Do NOT use `any` when types can be inferred
+- ❌ Do NOT overwrite existing files without explicit user approval
+
+---
+
+## Severity Levels
+
+| Level | Meaning |
+|-------|---------|
+| P0 | Conflict with existing endpoint or type — must resolve before generating |
+| P1 | Missing critical info (auth, response schema) — ask before proceeding |
+| P2 | Naming or structure inconsistency — warn and apply best guess |
+| P3 | Missing optional fields — document assumption and proceed |
+
+---
+
+## Workflow
+
+### Phase 1 — Input Validation
+
+Before parsing, verify:
+- URL is valid and method is correct (GET/POST/PUT/PATCH/DELETE)
+- Auth format is identifiable (Bearer, API Key, OAuth2, Basic, Cookie)
+- Request info is present (path params, query params, body)
+- Response structure is clear (JSON, binary, stream, paginated)
+- Error cases are documented
+
+If critical info is missing → **stop and ask**. Do not guess.
+
+```json
+{
+  "validation": {
+    "status": "VALID | INVALID | INCOMPLETE",
+    "confidence": 0.95,
+    "errors": [],
+    "warnings": [],
+    "input_type": "curl | openapi | postman | docs | code"
+  }
+}
+```
+
+---
+
+### Phase 2 — API Contract Extraction
+
+Extract the full contract:
+
+```
+metadata:
+  name, domain, endpoint, method, version, description
+
+request:
+  pathParams:    { name, type, required }
+  queryParams:   { name, type, required, default }
+  headers:       { name, value, required }
+  body:          { contentType, schema { field, type, required, nullable } }
+  auth:          { type, location, name }
+
+response:
+  success:       { statusCode, contentType, schema, pagination? }
+  errors:        [ { statusCode, message, businessCode? } ]
+
+special:
+  rateLimit, timeout, retryable, streaming
+```
+
+Map each field: `type`, `required`, `nullable`, `enum`, `example`.
+
+---
+
+### Phase 3 — Project Profile Detection
+
+1. Check for `.api-config.json` at project root → use if present
+2. Otherwise infer from:
+   - Framework: `package.json`, config files, imports
+   - HTTP client: existing axios instance, fetch wrapper, custom client
+   - State management: React Query, Redux, Zustand, Pinia, Apollo, Vuex
+   - Type system: `tsconfig.json`, JSDoc, plain JS
+   - Folder conventions: `services/`, `hooks/`, `api/`, `types/`, `adapters/`
+   - Naming: camelCase, PascalCase, snake_case, file patterns
+3. Read 1-2 existing API files to capture exact patterns for imports, typing, error handling, naming
+
+If project context is ambiguous → use conservative defaults and document all assumptions.
+
+---
+
+### Phase 4 — Conflict Detection
+
+Before generating code, check for:
+
+| Conflict | Action |
+|----------|--------|
+| `ENDPOINT_DUPLICATE` — endpoint already exists | Reuse if same, warn if different |
+| `FUNCTION_DUPLICATE` — function name conflicts | Warn, propose new name |
+| `TYPE_DUPLICATE` — type already defined | Extend or reuse existing |
+| `LOGIC_OVERLAP` — logic exists in another service | Consolidate, don't duplicate |
+| `IMPORT_CONFLICT` — import path conflicts | Resolve before generating |
+
+**P0 conflict → stop, report, wait for user decision before proceeding.**
+
+---
+
+### Phase 5 — Code Generation
+
+Generate the minimum necessary set for the task:
+
+#### TypeScript Types
+```typescript
+// Request types
+export interface CreateUserRequest {
+  name: string;
+  email: string;
+  role?: UserRole;
+}
+
+// Response types
+export interface CreateUserResponse {
+  id: string;
+  name: string;
+  email: string;
+  createdAt: string;
+}
+
+// Error types
+export interface ApiError {
+  code: string;
+  message: string;
+  details?: Record<string, unknown>;
+}
+```
+
+#### Service / API Layer
+```typescript
+// Thin layer: HTTP + mapping only. No UI, no business logic.
+export const createUser = async (
+  data: CreateUserRequest
+): Promise<CreateUserResponse> => {
+  const response = await apiClient.post<CreateUserResponse>('/users', data);
+  return response.data;
+};
+```
+
+#### Hook / Query (if project uses React Query)
+```typescript
+export const useCreateUser = () => {
+  return useMutation<CreateUserResponse, ApiError, CreateUserRequest>({
+    mutationFn: createUser,
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: ['users'] });
+    },
+  });
+};
+```
+
+**If project uses Redux** → follow existing slice/thunk pattern.
+**If project uses Zustand** → follow existing store pattern.
+**If project uses Pinia/Vuex** → follow existing composable/action pattern.
+
+Do NOT mix patterns.
+
+---
+
+### Phase 6 — Special Case Handling
+
+#### File Upload (`multipart/form-data`)
+```typescript
+// Always use FormData — never send File object in JSON
+const formData = new FormData();
+formData.append('file', file);
+formData.append('name', name);
+await apiClient.post('/upload', formData, {
+  headers: { 'Content-Type': 'multipart/form-data' },
+});
+```
+
+#### File Download (binary response)
+```typescript
+const response = await apiClient.get('/export', { responseType: 'blob' });
+const url = URL.createObjectURL(response.data);
+const a = document.createElement('a');
+a.href = url;
+a.download = filename;
+a.click();
+URL.revokeObjectURL(url);
+```
+
+#### Pagination
+```typescript
+interface PaginatedResponse<T> {
+  items: T[];
+  total: number;
+  page: number;
+  limit: number;
+}
+// Implement consistently with existing project pagination pattern
+```
+
+#### Authentication
+- Follow existing auth mechanism (interceptor, header injection, cookie)
+- Never hardcode tokens or credentials
+- Refresh token logic belongs in the existing interceptor
+
+---
+
+### Phase 7 — Quality Validation
+
+Before marking as ready:
+
+- [ ] TypeScript strict — compiles clean, no `any` without justification
+- [ ] All functions/params have explicit types and return types
+- [ ] No unused imports, no debug code
+- [ ] Error handling complete (try/catch, `.catch`, fallback)
+- [ ] No hardcoded URLs, tokens, or secrets — use env vars
+- [ ] Naming matches project conventions
+- [ ] Reuses existing HTTP client, interceptors, and query client
+- [ ] JSDoc added for public API if project convention requires it
+- [ ] React: dependency arrays correct, cleanup present, no race conditions
+
+---
+
+### Phase 8 — End-to-End UI Integration (Optional / On-Demand)
+
+If the user explicitly requests to integrate the API directly into the UI (End-to-End):
+1. **Find Target Component:** Identify the UI component where the API should be called.
+2. **Wire State:** Inject the generated Hook/Query/Service into the component.
+3. **Handle States:** Implement Loading (spinners, skeletons), Error (toast, alert), and Success (redirect, form reset, table refetch) states in the UI.
+4. **Data Binding:** Bind the API response data to the UI elements (Table rows, Dropdowns, etc.) and bind UI inputs to the API request payload.
+
+---
+
+## Decision Tree
+
+```
+Is required info complete?
   ├── No  → Ask for missing info (auth, response schema, base URL)
   └── Yes → Check for conflicts
               ├── P0 conflict → Stop, report, wait for user decision

package/skills/qk-help/SKILL.md

@@ -0,0 +1,67 @@
+---
+name: qk-help
+description: >-
+  Tra cứu danh sách toàn bộ kỹ năng (skills) hiện có và đọc các mẹo (pro-tips) kết hợp kỹ năng để tăng tốc độ code.
+version: 1.0.0
+category: engineering
+tags: [help, list, tips, guide, manual]
+platforms: [antigravity, claude-code, kilo-code, cursor, windsurf]
+---
+
+# 📚 Cẩm nang AI Developer Skill OS
+
+> **Nhiệm vụ của bạn (AI):** Khi người dùng gọi lệnh `./qk-help`, hãy xuất ra màn hình (bằng tiếng Việt) danh sách các kỹ năng phân theo nhóm và các Mẹo sử dụng (Pro-tips) dưới đây một cách sinh động, dễ đọc (dùng markdown, in đậm, emoji). Không cần phân tích code, chỉ đóng vai trò là "Sách hướng dẫn sử dụng".
+
+---
+
+## 🎯 1. Danh sách Kỹ năng (Skills Directory)
+
+Dưới đây là các kỹ năng chính bạn có thể gọi bằng cách gõ `./qk-[tên-kỹ-năng]`:
+
+### 🎨 Frontend (Giao diện)
+- **`qk-ui-builder`**: Xây dựng UI, Layout, Component, Modal phức tạp.
+- **`qk-table-crud-generator`**: Chuyên vẽ bảng danh sách (Table), phân trang, lọc và form Thêm/Sửa/Xóa.
+- **`qk-form-builder`**: Chuyên làm Form nhập liệu, validate (Zod/Yup).
+- **`qk-component-generator`**: Tạo Component độc lập, tái sử dụng (Button, Input, Card).
+- **`qk-state-management`**: Xử lý Redux, Zustand, React Query.
+- **`qk-frontend-debug`**: Bắt bệnh vỡ layout, infinite re-render, lỗi Hydration.
+- **`qk-frontend-performance`**: Tối ưu tốc độ, chống re-render thừa.
+- **`qk-frontend-architecture`**: Tư vấn kiến trúc thư mục Frontend.
+- **`qk-frontend-testing`**: Viết Unit Test / E2E Test cho Frontend.
+- **`qk-accessibility-audit`**: Sửa lỗi a11y, hỗ trợ Screen reader.
+
+### ⚙️ Engineering & Integration (Tích hợp)
+- **`qk-api-integration`**: [Cực mạnh] Bóc tách tài liệu API (Curl, Postman) -> Gen Type, Service, Hook -> (Tùy chọn) Ốp thẳng vào UI.
+- **`qk-refactor`**: Tối ưu, dọn dẹp mã nguồn sạch sẽ.
+- **`qk-bug-fix`**: Chẩn đoán lỗi sâu và sửa an toàn.
+- **`qk-project-audit`**: Quét toàn bộ dự án tìm nợ kỹ thuật.
+- **`qk-git-engineer`**: Viết Commit / PR chuẩn Conventional.
+- **`qk-migration`**: Nâng cấp version framework / thư viện.
+- **`qk-agent-orchestrator`**: Kiến trúc sư, lên plan phân rã task lớn.
+- **`qk-context-manager`**: Tóm tắt kiến trúc dự án.
+
+### 🗄️ Backend (Máy chủ)
+- **`qk-database-engineer`**: Thiết kế Schema, ORM (Prisma/Drizzle), Migration.
+- **`qk-backend-architecture`**: Setup kiến trúc Backend (Node/Nest/Python).
+- **`qk-auth-security`**: Phân quyền RBAC, JWT, OAuth.
+- **`qk-deployment`**: Viết Dockerfile, CI/CD Pipeline.
+
+---
+
+## 💡 2. Mẹo sử dụng Nâng cao (Pro-Tips)
+
+### Mẹo 1: Kết hợp Kỹ năng (Skill Chaining) 🔗
+Đừng bắt AI làm từ A-Z bằng 1 câu prompt. Hãy gọi liên hoàn:
+> *"Hãy dùng `./qk-api-integration` để bóc tách API này thành hook React Query. Sau đó dùng `./qk-table-crud-generator` vẽ cái Bảng hiển thị danh sách tích hợp hook đó."*
+
+### Mẹo 2: Chế độ "Một phát ăn ngay" (End-to-End) 🚀
+Nếu bạn đã có sẵn 1 màn hình UI (chỉ thiếu data), hãy ép `qk-api-integration` làm End-to-End:
+> *"./qk-api-integration Dưới đây là API Get Profile. Hãy khai báo Type, viết Hook và TÍCH HỢP THẲNG LUÔN vào file \`Profile.tsx\` đang mở."*
+
+### Mẹo 3: Truyền tham số ép buộc (Arguments) 🎯
+Bạn có thể ép AI dùng công nghệ bạn muốn bằng cách thêm \`--tham_số\`:
+> *"./qk-ui-builder --fw=react --css=tailwind Hãy vẽ màn hình Đăng nhập."*
+
+### Mẹo 4: Nhờ "Kiến trúc sư" phân việc 🧠
+Nếu bạn có một tính năng quá lớn (ví dụ: Làm tính năng Giỏ Hàng), đừng tự chia việc, hãy gọi:
+> *"./qk-agent-orchestrator Tôi muốn làm tính năng Giỏ hàng. Hãy phân tích và lên kế hoạch gọi các skill \`qk-\` nào cho phù hợp."*

package/skills.json

@@ -6,6 +6,30 @@
   "author": "Quang Khánh",
   "homepage": "https://github.com/phamquangkhanh2999/ai-developer-skill-os.git",
   "skills": [
+    {
+      "name": "qk-help",
+      "path": "skills/qk-help/SKILL.md",
+      "version": "1.0.0",
+      "category": "engineering",
+      "priority": "P0",
+      "trigger": [
+        "help",
+        "list skills",
+        "show tips",
+        "danh sách skill"
+      ],
+      "dependencies": [],
+      "conflicts": [],
+      "platforms": [
+        "antigravity",
+        "claude-code",
+        "kilo-code",
+        "cursor",
+        "windsurf"
+      ],
+      "status": "planned",
+      "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ả."
+    },
     {
       "name": "qk-agent-orchestrator",
       "path": "skills/qk-agent-orchestrator/SKILL.md",