ai-developer-skill-os 1.2.0 → 1.3.2

package/README.md

@@ -1,18 +1,23 @@
 # 🚀 AI Developer Skill OS
 
 [![npm version](https://badge.fury.io/js/ai-developer-skill-os.svg)](https://badge.fury.io/js/ai-developer-skill-os)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Author](https://img.shields.io/badge/Author-Quang%20Kh%C3%A1nh-blue.svg)](https://github.com/phamquangkhanh2999)
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
 
-**A multi-agent skill package for AI coding assistants (Claude Code, Cursor, Windsurf, Antigravity/Gemini).**  
-Hệ điều hành kỹ năng (Skill OS) giúp biến AI của bạn từ một "cỗ máy sinh code" thành một Senior Software Engineer thực thụ với quy trình làm việc chuẩn mực.
-
-> Tác giả: **Quang Khánh**
+> **"Biến mọi AI Code Editor (Cursor, Windsurf, Cline) thành một Senior Engineer thực thụ với 23 kỹ năng được lập trình sẵn."**
 
 ---
 
-## 🌟 Tính năng nổi bật (Features)
+## 🌟 Tại sao bạn cần Skill OS?
+
+Các AI Editor hiện tại rất thông minh, nhưng nếu không có quy trình rõ ràng, chúng thường **lan man, tự ý sửa code lung tung, hoặc viết code không theo chuẩn kiến trúc**. 
+
+**AI Developer Skill OS (by Quang Khánh)** giải quyết triệt để vấn đề này bằng cách:
+- 🧠 **Ép AI tư duy theo Workflow (Chain-of-Thought):** Phân tích trước, code sau.
+- 🛡️ **Scope & Non-goals rõ ràng:** Khoá chặt giới hạn, tuyệt đối không cho AI sửa hỏng các file không liên quan.
+- 🎨 **Output chuyên nghiệp:** Mọi câu trả lời của AI đều được định dạng thành bảng biểu, báo cáo y hệt một hệ thống thật.
 
-Bộ Skill OS cung cấp **23 kỹ năng chuyên biệt**, chia làm 3 nhóm chính:
+### Hệ thống 23 Kỹ năng (Skillset)
 - 🛠️ **Engineering Core (8 skills):** Agent Orchestrator (Lên kế hoạch), Context Manager, Project Audit, Bug Fix, Refactor, API Integration, Migration, Git Engineer.
 - 🎨 **Frontend (11 skills):** Frontend Architecture, Design System, UI Builder, Component Generator, State Management, Form Builder, Table CRUD, Debug, Testing, Performance, A11Y Audit.
 - ⚙️ **Backend (4 skills):** Backend Architecture, Database Engineer, Auth & Security, Deployment (DevOps).
@@ -84,23 +89,62 @@ Tạo file `.github/copilot-instructions.md` và dán đoạn prompt tương t
 
 ## 🚀 Cách gọi lệnh Skill chuyên nghiệp (Usage)
 
-AI sẽ tự động nhận diện skill qua ngữ cảnh, nhưng để chắc chắn 100% và tiết kiệm thời gian gõ prompt, bạn hãy dùng cú pháp lệnh độc quyền: **`./qk [tên-skill]`**
+AI sẽ tự động nhận diện skill qua ngữ cảnh, nhưng để chắc chắn 100% và tiết kiệm thời gian gõ prompt, bạn hãy dùng cú pháp lệnh độc quyền: **`./qk-[tên-skill]`**
 
 Dưới đây là các ví dụ cụ thể để bạn copy - paste và trải nghiệm ngay:
 
-### 1. Khi bắt đầu dự án / Nhờ AI lên kế hoạch (Planning)
-> **`./qk agent-orchestrator`** Hãy lên kế hoạch làm tính năng Giỏ Hàng cho tôi. Nhớ gọi thêm **`./qk context-manager`** để kiểm tra thư mục hiện tại có những file gì trước nhé.
+### 1. Nhờ AI lên kế hoạch (Planning) & Kiến trúc
+> **`./qk-agent-orchestrator`** Hãy lên kế hoạch làm tính năng Giỏ Hàng cho tôi. Nhớ gọi thêm **`./qk-context-manager`** để đọc cấu trúc dự án trước nhé.
+
+### 2. Xây dựng Giao diện (Frontend/UI)
+> **`./qk-ui-builder`** & **`./qk-design-system`** Hãy tạo cho tôi một màn hình Đăng Nhập (Login) xịn xò. Đảm bảo Responsive và dùng đúng chuẩn Component.
+
+### 3. Thiết kế Database (Backend)
+> **`./qk-database-engineer`** Hãy viết cho tôi schema Prisma cho bảng Product và User có quan hệ 1-N. Tối ưu index cho truy vấn nhanh.
+
+### 4. Tìm và Diệt Bug (Debugging)
+> **`./qk-frontend-debug`** & **`./qk-bug-fix`** Code đang bị crash với lỗi `Hydration error`. Hãy tìm nguyên nhân gốc rễ và sửa dứt điểm giúp tôi.
+
+---
+
+## 💡 Mẹo & Workflow Thực Chiến (Best Practices)
 
-### 2. Khi muốn tạo Giao diện (UI)
-> **`./qk ui-builder`** & **`./qk design-system`** Hãy tạo cho tôi một màn hình Đăng Nhập (Login) sử dụng Tailwind CSS. 
+Để khai thác tối đa sức mạnh của 23 kỹ năng, bí quyết là **kết hợp (chaining) nhiều skill** lại với nhau trong cùng một luồng công việc. Dưới đây là các Workflow kinh điển:
 
-### 3. Khi muốn làm việc với Database (Backend)
-> **`./qk database-engineer`** Hãy viết cho tôi schema Prisma cho bảng Product và User có quan hệ 1-N. 
+### 🌟 1. Workflow Bắt đầu một New Chat (Bắt buộc)
+Khi mở một New Chat, AI hoàn toàn chưa biết gì về dự án. Đừng bắt nó code ngay!
+* **Bước 1:** `> Dùng ./qk-context-manager để đọc cấu trúc toàn bộ dự án này.`
+* **Bước 2:** `> Dùng ./qk-agent-orchestrator để phân tích yêu cầu sau đây và lên kế hoạch: [Yêu cầu của bạn]`
 
-### 4. Khi gặp Bug cứng đầu
-> **`./qk frontend-debug`** & **`./qk bug-fix`** Code đang bị crash với lỗi `Hydration error`. Hãy tìm hiểu nguyên nhân gốc rễ và sửa nó giúp tôi.
+### 🌟 2. Workflow Làm tính năng mới (VD: Tích hợp API)
+Muốn tạo một màn hình hiển thị danh sách từ API trả về? Hãy gõ:
+* `> Hãy dùng ./qk-api-integration để tạo file gọi API fetch danh sách Users.`
+* `> Tiếp theo dùng ./qk-state-management để lưu data này vào Zustand/Redux.`
+* `> Cuối cùng dùng ./qk-ui-builder để vẽ màn hình Table hiển thị data đó.`
+
+### 🌟 3. Workflow Chống "Phá Code" (Safe Refactor)
+Trước khi đổi một cấu trúc lớn, hãy bắt AI dò mìn:
+* `> Hãy chạy ./qk-project-audit để dò xem việc đổi tên biến X có ảnh hưởng đến các component khác không.`
+* `> OK, giờ hãy dùng ./qk-refactor để sửa lại một cách an toàn.`
+
+---
+
+## 💎 Danh sách 23+ Kỹ Năng Độc Quyền
+
+| Phân hệ | Kỹ năng tiêu biểu | Chức năng chính |
+|---------|-------------------|-----------------|
+| 🏗️ **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. |
+
+👉 [Xem danh sách toàn bộ Kỹ năng tại đây](docs/CHI_TIET_SKILLS.md)
+
+---
 
-👉 [Đọc Hướng Dẫn Sử Dụng chi tiết tại đây](docs/HUONG_DAN_SU_DUNG.md)
+<div align="center">
+  <b>Được thiết kế và phát triển bởi Quang Khánh (QK)</b><br>
+  <i>Empowering Vietnamese Developers with World-Class AI Workflows.</i>
+</div>
 
 ---
 

package/bin/install.js

@@ -2,18 +2,11 @@
 
 const fs = require('fs');
 const path = require('path');
+const readline = require('readline');
 
 const sourceDir = path.join(__dirname, '..');
 let targetDir = path.join(process.cwd(), '.qk-ai-skill-os');
 
-// Check arguments for IDE-specific paths
-const args = process.argv.slice(2);
-const isGemini = args.includes('--gemini') || args.includes('--antigravity');
-
-if (isGemini) {
-  targetDir = path.join(process.cwd(), '.agents', 'skills');
-}
-
 function copyRecursiveSync(src, dest) {
   const exists = fs.existsSync(src);
   const stats = exists && fs.statSync(src);
@@ -31,41 +24,112 @@ function copyRecursiveSync(src, dest) {
   }
 }
 
-console.log('🚀 Đang cài đặt AI Developer Skill OS...');
-if (isGemini) {
-  console.log('⚙️ Chế độ: Gemini / Antigravity IDE (Cài vào thư mục .agents/skills/)');
-} else {
-  console.log('⚙️ Chế độ: Mặc định (Cài vào thư mục .qk-ai-skill-os/)');
-}
+const systemPrompt = `[Role]
+You are an elite AI Software Engineer. You must strictly follow the rules in this project.
+Vui lòng tìm đọc danh sách kỹ năng tại file \`./.qk-ai-skill-os/skills.json\`.
+
+[Trigger Mechanism]
+Bất cứ khi nào người dùng gõ lệnh bắt đầu bằng \`./qk-[tên-skill]\`, bạn BẮT BUỘC phải đọc file \`SKILL.md\` tương ứng trong thư mục \`./.qk-ai-skill-os/skills/...\` trước khi làm bất cứ việc gì. Đừng bao giờ đoán mò.
+
+[Command Arguments]
+Người dùng có thể truyền thêm tham số vào lệnh (ví dụ: \`./qk-ui-builder --fw=react --css=tailwind\`). 
+Nếu người dùng sử dụng tham số (argument), bạn BẮT BUỘC phải tuân thủ tuyệt đối các công nghệ/yêu cầu được chỉ định trong tham số đó thay vì dùng mặc định.`;
+
+const rl = readline.createInterface({
+  input: process.stdin,
+  output: process.stdout
+});
+
+console.log('🚀 Đang chuẩn bị cài đặt AI Developer Skill OS...\n');
+
+const questionText = `Vui lòng chọn IDE/AI Assistant bạn đang sử dụng để tự động cấu hình (Auto-Generate Config):
+(1) Cursor
+(2) Windsurf
+(3) Cline / Roo Code
+(4) Antigravity / Gemini
+(5) Codex
+(6) Kilo Code
+(0) Bỏ qua (Không tạo file config)
+
+Nhập số (0-6): `;
+
+rl.question(questionText, (answer) => {
+  let isGemini = false;
+  let ruleFile = null;
 
-const filesAndFolders = [
-  'skills', 
-  '_template', 
-  'docs', 
-  'skills.json', 
-  'README.md', 
-  'CHANGELOG.md', 
-  'LICENSE'
-];
-
-try {
-  if (!fs.existsSync(targetDir)) {
-    fs.mkdirSync(targetDir, { recursive: true });
+  switch(answer.trim()) {
+    case '1': ruleFile = '.cursorrules'; break;
+    case '2': ruleFile = '.windsurfrules'; break;
+    case '3': ruleFile = '.clinerules'; break;
+    case '4': 
+      isGemini = true; 
+      targetDir = path.join(process.cwd(), '.agents', 'skills');
+      ruleFile = path.join('.agents', 'AGENTS.md');
+      break;
+    case '5': ruleFile = '.codexrules'; break;
+    case '6': ruleFile = '.kilorules'; break;
+    case '0': 
+    default:
+      console.log('👉 Bỏ qua bước tạo file cấu hình tự động.');
+      break;
   }
 
-  filesAndFolders.forEach(item => {
-    const src = path.join(sourceDir, item);
-    let dest = path.join(targetDir, item);
-    
-    // For Gemini, we dump the contents directly into .agents/skills/
-    if (fs.existsSync(src)) {
-      copyRecursiveSync(src, dest);
+  if (isGemini) {
+    console.log('\n⚙️ Chế độ: Gemini / Antigravity IDE (Cài vào thư mục .agents/)');
+  } else {
+    console.log('\n⚙️ Chế độ: Mặc định (Cài vào thư mục .qk-ai-skill-os/)');
+  }
+
+  try {
+    if (!fs.existsSync(targetDir)) {
+      fs.mkdirSync(targetDir, { recursive: true });
     }
-  });
 
-  console.log(`✅ Đã cài đặt thành công vào thư mục: ${targetDir.replace(process.cwd(), '.')}`);
-  console.log('\n💡 Tiếp theo, hãy tham khảo tài liệu trong mục .qk-ai-skill-os/docs/HUONG_DAN_SU_DUNG.md để biết cách tương tác với AI nhé!');
-} catch (error) {
-  console.error('❌ Có lỗi xảy ra trong quá trình cài đặt:', error.message);
-  process.exit(1);
-}
+    const filesAndFolders = [
+      'skills', 
+      '_template', 
+      'docs', 
+      'skills.json', 
+      'README.md', 
+      'CHANGELOG.md', 
+      'LICENSE'
+    ];
+
+    filesAndFolders.forEach(item => {
+      const src = path.join(sourceDir, item);
+      let dest = path.join(targetDir, item);
+      
+      if (fs.existsSync(src)) {
+        copyRecursiveSync(src, dest);
+      }
+    });
+
+    if (ruleFile) {
+        const fullRulePath = path.join(process.cwd(), ruleFile);
+        const ruleDir = path.dirname(fullRulePath);
+        if (ruleDir !== process.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`;
+        }
+
+        if (fs.existsSync(fullRulePath)) {
+            fs.appendFileSync(fullRulePath, "\n\n" + writeContent);
+            console.log(`✅ Đã GHI THÊM cấu hình tự động vào file: ${ruleFile}`);
+        } else {
+            fs.writeFileSync(fullRulePath, writeContent);
+            console.log(`✅ Đã TẠO MỚI file cấu hình: ${ruleFile}`);
+        }
+    }
+
+    console.log(`✅ Đã cài đặt thư viện thành công vào thư mục: ${targetDir.replace(process.cwd(), '.')}`);
+    console.log('\n💡 Hãy tận hưởng trải nghiệm Auto-Config và Command Arguments (VD: ./qk-ui-builder --fw=react)!');
+  } catch (error) {
+    console.error('❌ Có lỗi xảy ra trong quá trình cài đặt:', error.message);
+  } finally {
+    rl.close();
+  }
+});

package/docs/HUONG_DAN_SU_DUNG.md

@@ -87,33 +87,57 @@ Tạo file `.github/copilot-instructions.md` và dán đoạn prompt tương t
 ## 4. Cách kiểm tra cài đặt thành công
 
 Để biết AI của bạn đã thực sự "nhập môn" bộ Skill OS này chưa, hãy mở khung chat AI trong dự án và gõ cú pháp lệnh chuyên nghiệp sau:
-> **`./qk project-audit`** Hãy cho tôi biết bạn sẽ làm những gì.
+> **`./qk-project-audit`** Hãy cho tôi biết bạn sẽ làm những gì.
 
-✅ **Thành công:** Nếu AI trả lời bằng tiếng Việt, liệt kê đúng các bước khám bệnh (Phase 1, Phase 2, Phase 3...) theo đúng như trong file `SKILL.md` của `project-audit`.  
+✅ **Thành công:** Nếu AI trả lời bằng tiếng Việt, liệt kê đúng các bước khám bệnh (Phase 1, Phase 2, Phase 3...) theo đúng như trong file `SKILL.md` của `qk-project-audit`.  
 ❌ **Thất bại:** Nếu AI trả lời chung chung hoặc bảo không biết skill này là gì, bạn cần kiểm tra lại đường dẫn file cấu hình ở bước trên.
 
 ---
 
 ## 5. Cách gọi lệnh Skill chuyên nghiệp (Usage)
 
-AI sẽ tự động nhận diện skill qua ngữ cảnh, nhưng cách chuyên nghiệp và tiết kiệm thời gian gõ prompt nhất là bạn sử dụng cú pháp lệnh độc quyền: **`./qk [tên-skill]`**
+AI sẽ tự động nhận diện skill qua ngữ cảnh, nhưng cách chuyên nghiệp và tiết kiệm thời gian gõ prompt nhất là bạn sử dụng cú pháp lệnh độc quyền: **`./qk-[tên-skill]`**
 
 Dưới đây là các câu lệnh (prompt) mẫu cực kỳ hiệu quả mà bạn nên dùng:
 
 ### 🎯 Ví dụ 1: Nhờ AI lên kế hoạch (Planning)
-> **`./qk agent-orchestrator`** Hãy lên kế hoạch làm tính năng Đăng nhập này cho tôi. Nhớ gọi thêm **`./qk context-manager`** để kiểm tra thư mục hiện tại có những file gì trước nhé.
+> **`./qk-agent-orchestrator`** Hãy lên kế hoạch làm tính năng Đăng nhập này cho tôi. Nhớ gọi thêm **`./qk-context-manager`** để kiểm tra thư mục hiện tại có những file gì trước nhé.
 
 ### 🎯 Ví dụ 2: Fix lỗi cứng đầu (Bug Fix)
-> **`./qk frontend-debug`** & **`./qk bug-fix`** Code đang bị crash với lỗi `Hydration error`. Hãy tìm hiểu nguyên nhân gốc rễ và sửa nó giúp tôi.
+> **`./qk-frontend-debug`** & **`./qk-bug-fix`** Code đang bị crash với lỗi `Hydration error`. Hãy tìm hiểu nguyên nhân gốc rễ và sửa nó giúp tôi.
 
 ### 🎯 Ví dụ 3: Review Codebase (Audit)
-> **`./qk project-audit`** Hãy kiểm tra nhanh cho tôi thư mục `src/components/` xem có bị vấn đề về hiệu năng hay code smell không.
+> **`./qk-project-audit`** Hãy kiểm tra nhanh cho tôi thư mục `src/components/` xem có bị vấn đề về hiệu năng hay code smell không.
 
 ### 🎯 Ví dụ 4: Xây dựng Giao diện Frontend (UI)
-> **`./qk ui-builder`** & **`./qk design-system`** Hãy tạo cho tôi một màn hình Danh sách User. Chú ý dùng chuẩn components của thư mục `src/components/ui/` nhé.
+> **`./qk-ui-builder`** & **`./qk-design-system`** Hãy tạo cho tôi một màn hình Danh sách User. Chú ý dùng chuẩn components của thư mục `src/components/ui/` nhé.
 
 ### 🎯 Ví dụ 5: Làm việc với API (Backend & Integration)
-> **`./qk api-integration`** Tích hợp cái swagger login này vào frontend giúp. Nhớ dùng React Query như chuẩn của project.
+> **`./qk-api-integration`** Tích hợp cái swagger login này vào frontend giúp. Nhớ dùng React Query như chuẩn của project.
 
 ### 🎯 Ví dụ 6: Database & Backend
-> **`./qk database-engineer`** Hãy viết cho tôi schema Prisma cho bảng Product và User có quan hệ 1-N. Làm theo đúng chuẩn kiến trúc trong skill.
+> **`./qk-database-engineer`** Hãy viết cho tôi schema Prisma cho bảng Product và User có quan hệ 1-N. Làm theo đúng chuẩn kiến trúc trong skill.
+
+---
+
+## 6. 💡 Mẹo & Workflow Thực Chiến (Best Practices)
+
+Để khai thác tối đa sức mạnh của 23 kỹ năng, bí quyết là **kết hợp (chaining) nhiều skill** lại với nhau trong cùng một luồng công việc.
+
+### 🌟 Workflow Bắt đầu một New Chat (Bắt buộc)
+Khi mở một New Chat, AI hoàn toàn chưa biết gì về dự án. Đừng bắt nó code ngay!
+* **Bước 1:** `> Dùng ./qk-context-manager để đọc cấu trúc toàn bộ dự án này.`
+* **Bước 2:** `> Dùng ./qk-agent-orchestrator để phân tích yêu cầu sau đây và lên kế hoạch: [Yêu cầu của bạn]`
+
+### 🌟 Workflow Làm tính năng mới (VD: Tích hợp API)
+Muốn tạo một màn hình hiển thị danh sách từ API trả về? Hãy gõ 1 lượt các lệnh:
+* `> Hãy dùng ./qk-api-integration để tạo file gọi API fetch danh sách Users.`
+* `> Tiếp theo dùng ./qk-state-management để lưu data này vào Zustand/Redux.`
+* `> Cuối cùng dùng ./qk-ui-builder để vẽ màn hình Table hiển thị data đó.`
+
+### 🌟 Workflow Chống "Phá Code" (Safe Refactor)
+Trước khi đổi một cấu trúc lớn, hãy bắt AI dò mìn:
+* `> Hãy chạy ./qk-project-audit để dò xem việc đổi tên biến X có ảnh hưởng đến các component khác không.`
+* `> OK, giờ hãy dùng ./qk-refactor để sửa lại một cách an toàn.`
+
+👉 Chúc bạn tận hưởng cảm giác code như một Tech Lead thực thụ!

package/package.json

@@ -1,34 +1,34 @@
-{
-  "name": "ai-developer-skill-os",
-  "version": "1.2.0",
-  "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": {
-    "ai-developer-skill-os": "bin/install.js",
-    "ai-skill": "bin/install.js"
-  },
-  "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/phamquangkhanh2999/ai-developer-skill-os.git"
-  },
-  "keywords": [
-    "ai",
-    "claude",
-    "cursor",
-    "windsurf",
-    "skills",
-    "developer",
-    "agent",
-    "prompts",
-    "framework"
-  ],
-  "author": "Quang Khánh",
-  "license": "MIT",
-  "bugs": {
-    "url": "https://github.com/phamquangkhanh2999/ai-developer-skill-os/issues"
-  },
-  "homepage": "https://github.com/phamquangkhanh2999/ai-developer-skill-os#readme"
-}
+{
+  "name": "ai-developer-skill-os",
+  "version": "1.3.2",
+  "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": {
+    "ai-developer-skill-os": "bin/install.js",
+    "ai-skill": "bin/install.js"
+  },
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/phamquangkhanh2999/ai-developer-skill-os.git"
+  },
+  "keywords": [
+    "ai",
+    "claude",
+    "cursor",
+    "windsurf",
+    "skills",
+    "developer",
+    "agent",
+    "prompts",
+    "framework"
+  ],
+  "author": "Quang Khánh",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/phamquangkhanh2999/ai-developer-skill-os/issues"
+  },
+  "homepage": "https://github.com/phamquangkhanh2999/ai-developer-skill-os#readme"
+}

package/rename.js

@@ -0,0 +1,64 @@
+const fs = require('fs');
+const path = require('path');
+const { execSync } = require('child_process');
+
+const skillsDir = 'skills';
+const categories = fs.readdirSync(skillsDir).filter(f => fs.statSync(path.join(skillsDir, f)).isDirectory());
+
+categories.forEach(category => {
+  const catPath = path.join(skillsDir, category);
+  const skills = fs.readdirSync(catPath).filter(f => fs.statSync(path.join(catPath, f)).isDirectory());
+  skills.forEach(skill => {
+    if (!skill.startsWith('qk-')) {
+      const oldPath = path.join(catPath, skill).replace(/\\/g, '/');
+      const newPath = path.join(catPath, 'qk-' + skill).replace(/\\/g, '/');
+      try {
+        console.log(`Đang đổi tên: ${oldPath} -> ${newPath}`);
+        execSync(`git mv "${oldPath}" "${newPath}"`);
+      } catch(e) {
+        console.error('LỖI (Hãy chắc chắn bạn đã tắt hoàn toàn IDE/Cursor đang mở folder này):', e.message);
+      }
+    }
+  });
+});
+
+// Update skills.json
+const skillsJsonPath = 'skills.json';
+let skillsData = JSON.parse(fs.readFileSync(skillsJsonPath, 'utf8'));
+
+// Fix entries and modify their paths
+if(skillsData.skills) {
+    skillsData.skills = skillsData.skills.map(s => {
+        if(!s.name.startsWith('qk-')) {
+            s.name = 'qk-' + s.name;
+            const parts = s.path.split('/');
+            const skillFolder = parts[2];
+            if(!skillFolder.startsWith('qk-')) {
+                parts[2] = 'qk-' + skillFolder;
+            }
+            s.path = parts.join('/');
+        }
+        return s;
+    });
+}
+fs.writeFileSync(skillsJsonPath, JSON.stringify(skillsData, null, 2));
+
+// Update SKILL.md names
+categories.forEach(category => {
+  const catPath = path.join(skillsDir, category);
+  const skills = fs.readdirSync(catPath).filter(f => fs.statSync(path.join(catPath, f)).isDirectory());
+  skills.forEach(skill => {
+    if (skill.startsWith('qk-')) {
+      const skillMdPath = path.join(catPath, skill, 'SKILL.md');
+      if (fs.existsSync(skillMdPath)) {
+        let content = fs.readFileSync(skillMdPath, 'utf8');
+        content = content.replace(/^name:\s*([a-zA-Z0-9-]+)\s*$/m, (match, p1) => {
+          if (!p1.startsWith('qk-')) return 'name: qk-' + p1;
+          return match;
+        });
+        fs.writeFileSync(skillMdPath, content);
+      }
+    }
+  });
+});
+console.log('✅ Đã đổi tên thành công toàn bộ sang hệ qk-* !');

package/skills/backend/qk-auth-security/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: qk-
+name: qk-
 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.
 version: 1.0.0

package/skills/backend/qk-backend-architecture/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: qk-
+name: qk-
 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.
 version: 1.0.0

package/skills/backend/{database-engineer → qk-database-engineer}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: database-engineer
+name: qk-database-engineer
 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...).
 version: 1.0.0

package/skills/backend/qk-deployment/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: qk-deployment
+name: qk-deployment
 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.
 version: 1.0.0

package/skills/engineering/{agent-orchestrator → qk-agent-orchestrator}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: agent-orchestrator
+name: qk-agent-orchestrator
 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.
 version: 1.0.0

package/skills/engineering/{api-integration → qk-api-integration}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: 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

package/skills/engineering/{bug-fix → qk-bug-fix}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: bug-fix
+name: qk-bug-fix
 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.
 version: 2.0.0

package/skills/engineering/qk-context-manager/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: qk-context-manager
+name: qk-context-manager
 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ớ.
 version: 1.0.0

package/skills/engineering/{git-engineer → qk-git-engineer}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: git-engineer
+name: qk-git-engineer
 description: >-
   Viết commit message chuẩn Conventional Commits, mô tả Pull Request, Changelog và Release Notes chuyên nghiệp.
 version: 1.0.0

package/skills/engineering/qk-migration/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: qk-migration
+name: qk-migration
 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.
 version: 1.0.0

package/skills/engineering/qk-project-audit/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: qk-project-audit
+name: qk-project-audit
 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.
 version: 1.0.0

package/skills/engineering/qk-refactor/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: qk-refactor
+name: qk-refactor
 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.
 version: 1.0.0

package/skills/frontend/{accessibility-audit → qk-accessibility-audit}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: accessibility-audit
+name: qk-accessibility-audit
 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.
 version: 1.0.0

package/skills/frontend/{component-generator → qk-component-generator}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: component-generator
+name: qk-component-generator
 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.
 version: 1.0.0

package/skills/frontend/{design-system → qk-design-system}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: design-system
+name: qk-design-system
 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.
 version: 1.0.0

package/skills/frontend/{form-builder → qk-form-builder}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: form-builder
+name: qk-form-builder
 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.
 version: 1.0.0

package/skills/frontend/{frontend-architecture → qk-frontend-architecture}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: frontend-architecture
+name: qk-frontend-architecture
 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.
 version: 1.0.0

package/skills/frontend/{frontend-debug → qk-frontend-debug}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: frontend-debug
+name: qk-frontend-debug
 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.
 version: 1.0.0

package/skills/frontend/{frontend-performance → qk-frontend-performance}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: frontend-performance
+name: qk-frontend-performance
 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.
 version: 1.0.0

package/skills/frontend/qk-frontend-testing/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: qk-frontend-testing
+name: qk-frontend-testing
 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.
 version: 1.0.0

package/skills/frontend/{state-management → qk-state-management}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: state-management
+name: qk-state-management
 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).
 version: 1.0.0

package/skills/frontend/{table-crud-generator → qk-table-crud-generator}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: table-crud-generator
+name: qk-table-crud-generator
 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).
 version: 1.0.0

package/skills/frontend/qk-ui-builder/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: qk-ui-builder
+name: qk-ui-builder
 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.
 version: 1.0.0

package/skills.json

@@ -7,8 +7,8 @@
   "homepage": "https://github.com/phamquangkhanh2999/ai-developer-skill-os.git",
   "skills": [
     {
-      "name": "agent-orchestrator",
-      "path": "skills/engineering/agent-orchestrator/SKILL.md",
+      "name": "qk-agent-orchestrator",
+      "path": "skills/engineering/qk-agent-orchestrator/SKILL.md",
       "version": "1.0.0",
       "category": "engineering",
       "priority": "P0",
@@ -33,8 +33,8 @@
       "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."
     },
     {
-      "name": "context-manager",
-      "path": "skills/engineering/context-manager/SKILL.md",
+      "name": "qk-context-manager",
+      "path": "skills/engineering/qk-context-manager/SKILL.md",
       "version": "1.0.0",
       "category": "engineering",
       "priority": "P0",
@@ -58,8 +58,8 @@
       "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ớ."
     },
     {
-      "name": "project-audit",
-      "path": "skills/engineering/project-audit/SKILL.md",
+      "name": "qk-project-audit",
+      "path": "skills/engineering/qk-project-audit/SKILL.md",
       "version": "1.0.0",
       "category": "engineering",
       "priority": "P0",
@@ -88,8 +88,8 @@
       "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."
     },
     {
-      "name": "bug-fix",
-      "path": "skills/engineering/bug-fix/SKILL.md",
+      "name": "qk-bug-fix",
+      "path": "skills/engineering/qk-bug-fix/SKILL.md",
       "version": "2.0.0",
       "category": "engineering",
       "priority": "P0",
@@ -116,8 +116,8 @@
       "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."
     },
     {
-      "name": "refactor",
-      "path": "skills/engineering/refactor/SKILL.md",
+      "name": "qk-refactor",
+      "path": "skills/engineering/qk-refactor/SKILL.md",
       "version": "1.0.0",
       "category": "engineering",
       "priority": "P2",
@@ -144,8 +144,8 @@
       "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."
     },
     {
-      "name": "api-integration",
-      "path": "skills/engineering/api-integration/SKILL.md",
+      "name": "qk-api-integration",
+      "path": "skills/engineering/qk-api-integration/SKILL.md",
       "version": "2.0.0",
       "category": "engineering",
       "priority": "P1",
@@ -172,8 +172,8 @@
       "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."
     },
     {
-      "name": "migration",
-      "path": "skills/engineering/migration/SKILL.md",
+      "name": "qk-migration",
+      "path": "skills/engineering/qk-migration/SKILL.md",
       "version": "1.0.0",
       "category": "engineering",
       "priority": "P2",
@@ -201,8 +201,8 @@
       "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."
     },
     {
-      "name": "git-engineer",
-      "path": "skills/engineering/git-engineer/SKILL.md",
+      "name": "qk-git-engineer",
+      "path": "skills/engineering/qk-git-engineer/SKILL.md",
       "version": "1.0.0",
       "category": "engineering",
       "priority": "P2",
@@ -227,8 +227,8 @@
       "description": "Viết commit message chuẩn Conventional Commits, mô tả Pull Request, Changelog và Release Notes chuyên nghiệp."
     },
     {
-      "name": "frontend-architecture",
-      "path": "skills/frontend/frontend-architecture/SKILL.md",
+      "name": "qk-frontend-architecture",
+      "path": "skills/frontend/qk-frontend-architecture/SKILL.md",
       "version": "1.0.0",
       "category": "frontend",
       "priority": "P1",
@@ -254,8 +254,8 @@
       "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."
     },
     {
-      "name": "design-system",
-      "path": "skills/frontend/design-system/SKILL.md",
+      "name": "qk-design-system",
+      "path": "skills/frontend/qk-design-system/SKILL.md",
       "version": "1.0.0",
       "category": "frontend",
       "priority": "P1",
@@ -282,8 +282,8 @@
       "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."
     },
     {
-      "name": "ui-builder",
-      "path": "skills/frontend/ui-builder/SKILL.md",
+      "name": "qk-ui-builder",
+      "path": "skills/frontend/qk-ui-builder/SKILL.md",
       "version": "1.0.0",
       "category": "frontend",
       "priority": "P1",
@@ -312,8 +312,8 @@
       "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."
     },
     {
-      "name": "component-generator",
-      "path": "skills/frontend/component-generator/SKILL.md",
+      "name": "qk-component-generator",
+      "path": "skills/frontend/qk-component-generator/SKILL.md",
       "version": "1.0.0",
       "category": "frontend",
       "priority": "P1",
@@ -339,8 +339,8 @@
       "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."
     },
     {
-      "name": "state-management",
-      "path": "skills/frontend/state-management/SKILL.md",
+      "name": "qk-state-management",
+      "path": "skills/frontend/qk-state-management/SKILL.md",
       "version": "1.0.0",
       "category": "frontend",
       "priority": "P2",
@@ -368,8 +368,8 @@
       "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)."
     },
     {
-      "name": "form-builder",
-      "path": "skills/frontend/form-builder/SKILL.md",
+      "name": "qk-form-builder",
+      "path": "skills/frontend/qk-form-builder/SKILL.md",
       "version": "1.0.0",
       "category": "frontend",
       "priority": "P2",
@@ -398,8 +398,8 @@
       "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."
     },
     {
-      "name": "table-crud-generator",
-      "path": "skills/frontend/table-crud-generator/SKILL.md",
+      "name": "qk-table-crud-generator",
+      "path": "skills/frontend/qk-table-crud-generator/SKILL.md",
       "version": "1.0.0",
       "category": "frontend",
       "priority": "P2",
@@ -428,8 +428,8 @@
       "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)."
     },
     {
-      "name": "frontend-debug",
-      "path": "skills/frontend/frontend-debug/SKILL.md",
+      "name": "qk-frontend-debug",
+      "path": "skills/frontend/qk-frontend-debug/SKILL.md",
       "version": "1.0.0",
       "category": "frontend",
       "priority": "P2",
@@ -455,8 +455,8 @@
       "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."
     },
     {
-      "name": "frontend-testing",
-      "path": "skills/frontend/frontend-testing/SKILL.md",
+      "name": "qk-frontend-testing",
+      "path": "skills/frontend/qk-frontend-testing/SKILL.md",
       "version": "1.0.0",
       "category": "frontend",
       "priority": "P2",
@@ -484,8 +484,8 @@
       "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."
     },
     {
-      "name": "frontend-performance",
-      "path": "skills/frontend/frontend-performance/SKILL.md",
+      "name": "qk-frontend-performance",
+      "path": "skills/frontend/qk-frontend-performance/SKILL.md",
       "version": "1.0.0",
       "category": "frontend",
       "priority": "P2",
@@ -512,8 +512,8 @@
       "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."
     },
     {
-      "name": "accessibility-audit",
-      "path": "skills/frontend/accessibility-audit/SKILL.md",
+      "name": "qk-accessibility-audit",
+      "path": "skills/frontend/qk-accessibility-audit/SKILL.md",
       "version": "1.0.0",
       "category": "frontend",
       "priority": "P2",
@@ -540,8 +540,8 @@
       "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."
     },
     {
-      "name": "backend-architecture",
-      "path": "skills/backend/backend-architecture/SKILL.md",
+      "name": "qk-backend-architecture",
+      "path": "skills/backend/qk-backend-architecture/SKILL.md",
       "version": "1.0.0",
       "category": "backend",
       "priority": "P3",
@@ -567,8 +567,8 @@
       "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."
     },
     {
-      "name": "database-engineer",
-      "path": "skills/backend/database-engineer/SKILL.md",
+      "name": "qk-database-engineer",
+      "path": "skills/backend/qk-database-engineer/SKILL.md",
       "version": "1.0.0",
       "category": "backend",
       "priority": "P3",
@@ -597,8 +597,8 @@
       "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...)."
     },
     {
-      "name": "auth-security",
-      "path": "skills/backend/auth-security/SKILL.md",
+      "name": "qk-auth-security",
+      "path": "skills/backend/qk-auth-security/SKILL.md",
       "version": "1.0.0",
       "category": "backend",
       "priority": "P3",
@@ -626,8 +626,8 @@
       "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."
     },
     {
-      "name": "deployment",
-      "path": "skills/backend/deployment/SKILL.md",
+      "name": "qk-deployment",
+      "path": "skills/backend/qk-deployment/SKILL.md",
       "version": "1.0.0",
       "category": "backend",
       "priority": "P3",