ai-developer-skill-os 1.0.7 → 1.3.1

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).
@@ -47,21 +52,23 @@ Sau khi thư mục kỹ năng đã xuất hiện trong dự án của bạn, hã
 ### Cho Antigravity / Gemini IDE
 **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 Cursor / Windsurf (AI Code Editors)
-Tạo file `.cursorrules` (nếu dùng Cursor) hoặc `.windsurfrules` (nếu dùng Windsurf) ở gốc dự án và dán đoạn sau vào:
+### Cho Claude Code / Kilo Code (CLI Agents)
+Tạo file `CLAUDE.md` (hoặc `KILO.md`) ở gốc dự án và dán đoạn sau vào:
 ```md
-# AI Developer Skill OS by Quang Khánh
+# System Instructions
+Bạn đang chạy bằng **AI Developer Skill OS** (Tác giả: Quang Khánh).
 
-When answering or generating code, you MUST act as an expert engineer using the skills defined in `./.rules-skill/skills.json`.
-Always read the relevant `SKILL.md` from `./.rules-skill/skills/` before providing a solution.
-Speak to me in Vietnamese, but write all code in English.
+Vui lòng tìm đọc danh sách kỹ năng tại file `./.qk-ai-skill-os/skills.json`.
+ĐẶC BIỆT LƯU Ý: 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 gọi và đọc nội dung file `SKILL.md` tương ứng trong thư mục `./.qk-ai-skill-os/skills/` trước khi phân tích hoặc viết code.
+Luôn giao tiếp bằng tiếng Việt nhưng viết code, đặt tên biến, comment trong code bằng tiếng Anh.
 ```
 
-### Cho Cline / Roo Code / Kilo Code (VS Code Extensions)
-Tạo file `.clinerules`, `.roorules` hoặc `KILO.md` ở gốc dự án và dán nội dung:
+### Cho Cline / Roo Code (VS Code Extensions)
+Tạo file `.clinerules` hoặc `.roorules` ở gốc dự án và dán nội dung:
 ```md
 Bạn đang chạy bằng **AI Developer Skill OS** (Tác giả: Quang Khánh).
-Vui lòng tìm đọc danh sách kỹ năng tại file `./.qk-ai-skill-os/skills.json`. Trước khi thực hiện bất kỳ yêu cầu nào, hãy gọi file `SKILL.md` tương ứng trong thư mục `./.qk-ai-skill-os/skills/`.
+Vui lòng tìm đọc danh sách kỹ năng tại file `./.qk-ai-skill-os/skills.json`.
+Bất cứ khi nào người dùng gõ lệnh `./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/`.
 Luôn giao tiếp bằng tiếng Việt nhưng viết code bằng tiếng Anh.
 ```
 
@@ -72,33 +79,50 @@ Tạo file `.github/copilot-instructions.md` và dán đoạn prompt tương t
 
 ## 🎯 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õ chính xác câu sau:
-> *"Hãy kích hoạt skill project-audit và cho tôi biết bạn sẽ làm những gì."*
+Để 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ì.
 
 ✅ **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ấ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.
 
 ---
 
-## 🚀 Cách sử dụng & Gọi Skill (Usage)
+## 🚀 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%, bạn **nên gọi thẳng tên skill** trong câu lệnh (prompt) của mình.
+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)
-> *"Hãy dùng skill **`agent-orchestrator`** để lên kế hoạch làm tính năng Giỏ Hàng cho tôi. Nhớ gọi thêm **`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.
 
-### 2. Khi muốn tạo Giao diện (UI)
-> *"Kích hoạt skill **`ui-builder`** và **`design-system`**. Hãy tạo cho tôi một màn hình Đăng Nhập (Login) sử dụng Tailwind CSS. Hãy đọc các rule trong skill để code cho chuẩn."*
+### 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.
 
-### 3. Khi muốn làm việc với Database (Backend)
-> *"Sử dụng skill **`database-engineer`**. Hãy viết cho tôi schema Prisma cho bảng Product (Sản phẩm) và User (Người dùng) có quan hệ 1-N. Làm theo đúng chuẩn kiến trúc trong skill."*
+### 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.
 
-### 4. Khi gặp Bug cứng đầu
-> *"Code đang bị crash với lỗi `Hydration error`. Hãy dùng skill **`frontend-debug`** và **`bug-fix`** để tìm hiểu nguyên nhân gốc rễ và sửa nó giúp tôi."*
+---
+
+## 💎 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

@@ -55,15 +55,27 @@ Tạo file `.cursorrules` (nếu dùng Cursor) hoặc `.windsurfrules` (nếu d
 # AI Developer Skill OS by Quang Khánh
 
 When answering or generating code, you MUST act as an expert engineer using the skills defined in `./.qk-ai-skill-os/skills.json`.
-Always read the relevant `SKILL.md` from `./.qk-ai-skill-os/skills/` before providing a solution.
+Bất cứ khi nào người dùng gõ lệnh `./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 thực hiện.
 Speak to me in Vietnamese, but write all code in English.
 ```
 
-### Cho Cline / Roo Code / Kilo Code (VS Code Extensions)
-Tạo file `.clinerules`, `.roorules` hoặc `KILO.md` ở gốc dự án và dán nội dung:
+### Cho Claude Code / Kilo Code (CLI Agents)
+Tạo file `CLAUDE.md` (hoặc `KILO.md`) ở gốc dự án và dán đoạn sau vào:
 ```md
+# System Instructions
 Bạn đang chạy bằng **AI Developer Skill OS** (Tác giả: Quang Khánh).
-Vui lòng tìm đọc danh sách kỹ năng tại file `./.qk-ai-skill-os/skills.json`. Trước khi thực hiện bất kỳ yêu cầu nào, hãy gọi file `SKILL.md` tương ứng trong thư mục `./.qk-ai-skill-os/skills/`.
+
+Vui lòng tìm đọc danh sách kỹ năng tại file `./.qk-ai-skill-os/skills.json`.
+ĐẶC BIỆT LƯU Ý: 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 gọi và đọc nội dung file `SKILL.md` tương ứng trong thư mục `./.qk-ai-skill-os/skills/` trước khi phân tích hoặc viết code.
+Luôn giao tiếp bằng tiếng Việt nhưng viết code, đặt tên biến, comment trong code bằng tiếng Anh.
+```
+
+### Cho Cline / Roo Code (VS Code Extensions)
+Tạo file `.clinerules` hoặc `.roorules` ở gốc dự án và dán nội dung:
+```md
+Bạn đang chạy bằng **AI Developer Skill OS** (Tác giả: Quang Khánh).
+Vui lòng tìm đọc danh sách kỹ năng tại file `./.qk-ai-skill-os/skills.json`.
+Bất cứ khi nào người dùng gõ lệnh `./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/`.
 Luôn giao tiếp bằng tiếng Việt nhưng viết code bằng tiếng Anh.
 ```
 
@@ -74,34 +86,34 @@ 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õ chính xác câu sau:
-> *"Hãy kích hoạt skill project-audit và cho tôi biết bạn sẽ làm những gì."*
+Để 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ì.
 
-✅ **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 tương tác & Gọi Skill cụ thể
+## 5. Cách gọi lệnh Skill chuyên nghiệp (Usage)
 
-Dù AI có thể tự đoán ngữ cảnh, cách chuyên nghiệp nhất là bạn **gọi thẳng tên skill** trong câu lệnh của mình để ép AI phải tuân thủ đúng quy trình.
+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)
-> *"Quang Khánh ơi, dự án này đang cần thêm tính năng Đăng nhập. Hãy dùng skill **`agent-orchestrator`** để lên kế hoạch làm tính năng này cho tôi. Nhớ gọi thêm **`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)
-> *"Code đang bị crash với lỗi `Hydration error`. Hãy dùng skill **`frontend-debug`** và **`bug-fix`** để 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)
-> *"Kích hoạt skill **`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)
-> *"Kích hoạt skill **`ui-builder`** và **`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)
-> *"Sử dụng skill **`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
-> *"Sử dụng skill **`database-engineer`**. Hãy viết cho tôi schema Prisma cho bảng Product (Sản phẩm) và User (Người dùng) 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.

package/package.json

@@ -1,34 +1,34 @@
-{
-  "name": "ai-developer-skill-os",
-  "version": "1.0.7",
-  "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.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": {
+    "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/{auth-security → qk-auth-security}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: auth-security
+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/{backend-architecture → qk-backend-architecture}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: backend-architecture
+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/{deployment → qk-deployment}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: 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/{context-manager → qk-context-manager}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: 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/{migration → qk-migration}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: 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/{project-audit → qk-project-audit}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: 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/{refactor → qk-refactor}/SKILL.md

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