ai-developer-skill-os 1.0.4 → 1.0.7

package/CHANGELOG.md

@@ -5,6 +5,11 @@ All notable changes to the **AI Developer Skill OS** project will be documented
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.0.1] - 2026-07-01
+### Fixed
+- Standardized Language rule across all 23 SKILL.md files for consistency.
+- Updated registry version to match package.json.
+
 ## [1.0.0] - 2026-07-01
 
 ### Added

package/README.md

@@ -30,12 +30,12 @@ Mở terminal tại thư mục gốc dự án của bạn và chạy:
 ```bash
 npx ai-developer-skill-os init
 ```
-*Lệnh này sẽ tự động tải và khởi tạo thư mục `rules-skill/` chứa toàn bộ kỹ năng vào dự án của bạn.*
+*Lệnh này sẽ tự động tải và khởi tạo thư mục ẩn `.qk-ai-skill-os/` chứa toàn bộ kỹ năng vào dự án của bạn.*
 
 ### Cách 2: Sử dụng Git Submodule
 Nếu bạn không dùng Node.js, bạn có thể nhúng trực tiếp qua Git:
 ```bash
-git submodule add https://github.com/phamquangkhanh2999/ai-developer-skill-os.git rules-skill
+git submodule add https://github.com/phamquangkhanh2999/ai-developer-skill-os.git .qk-ai-skill-os
 ```
 
 ---
@@ -52,8 +52,8 @@ Tạo file `.cursorrules` (nếu dùng Cursor) hoặc `.windsurfrules` (nếu d
 ```md
 # 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 `./rules-skill/skills.json`.
-Always read the relevant `SKILL.md` from `./rules-skill/skills/` before providing a solution.
+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.
 ```
 
@@ -61,7 +61,7 @@ Speak to me in Vietnamese, but write all code in English.
 Tạo file `.clinerules`, `.roorules` hoặc `KILO.md` ở 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 `./rules-skill/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 `./rules-skill/skills/`.
+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/`.
 Luôn giao tiếp bằng tiếng Việt nhưng viết code bằng tiếng Anh.
 ```
 
@@ -80,13 +80,23 @@ Tạo file `.github/copilot-instructions.md` và dán đoạn prompt tương t
 
 ---
 
-## 🚀 Cách sử dụng (Usage)
+## 🚀 Cách sử dụng & Gọi Skill (Usage)
 
-Giờ đây bạn chỉ cần chat với AI như giao việc cho một kỹ sư thật sự. Không cần viết prompt dài dòng!
+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.
 
-- **Nhờ AI lên kế hoạch:** *"Dự án này đang cần thêm tính năng Đăng nhập. Cậu lên kế hoạch giúp mình nhé."* (Kích hoạt `agent-orchestrator`)
-- **Fix lỗi:** *"Bị lỗi Hydration error trên Next.js rồi. Fix giúp mình."* (Kích hoạt `bug-fix` / `frontend-debug`)
-- **Audit Code:** *"Audit nhanh cho tôi thư mục src/components/ xem có vấn đề gì không."* (Kích hoạt `project-audit`)
+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é."*
+
+### 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. 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. 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."*
 
 👉 [Đọc Hướng Dẫn Sử Dụng chi tiết tại đây](docs/HUONG_DAN_SU_DUNG.md)
 

package/bin/install.js

@@ -4,7 +4,7 @@ const fs = require('fs');
 const path = require('path');
 
 const sourceDir = path.join(__dirname, '..');
-let targetDir = path.join(process.cwd(), 'rules-skill');
+let targetDir = path.join(process.cwd(), '.qk-ai-skill-os');
 
 // Check arguments for IDE-specific paths
 const args = process.argv.slice(2);
@@ -35,7 +35,7 @@ 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 rules-skill/)');
+  console.log('⚙️ Chế độ: Mặc định (Cài vào thư mục .qk-ai-skill-os/)');
 }
 
 const filesAndFolders = [
@@ -64,7 +64,7 @@ try {
   });
 
   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 docs/HUONG_DAN_SU_DUNG.md để biết cách tương tác với AI nhé!');
+  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);

package/docs/CHI_TIET_SKILLS.md

@@ -1,7 +1,7 @@
 # Chi Tiết 23 Skills — AI Developer Skill OS
 
 **Tác giả:** Quang Khánh  
-**Phiên bản:** v1.0.0
+**Phiên bản:** v1.0.1
 
 Tài liệu này giải thích chi tiết chức năng của từng Skill trong bộ Skill OS.
 AI sẽ đọc mô tả (description) bằng tiếng Anh để nhận diện, nhưng bạn có thể đọc tài liệu tiếng Việt này để hiểu AI có thể làm được gì.

package/docs/HUONG_DAN_SU_DUNG.md

@@ -38,7 +38,7 @@ Các công cụ này linh hoạt hơn, bạn cài đặt mặc định:
 ```bash
 npx ai-developer-skill-os init
 ```
-*Lệnh này sẽ tạo thư mục `rules-skill/` ở gốc dự án.*
+*Lệnh này sẽ tạo thư mục `.qk-ai-skill-os/` ở gốc dự án.*
 
 ---
 
@@ -54,8 +54,8 @@ Tạo file `.cursorrules` (nếu dùng Cursor) hoặc `.windsurfrules` (nếu d
 ```md
 # 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 `./rules-skill/skills.json`.
-Always read the relevant `SKILL.md` from `./rules-skill/skills/` before providing a solution.
+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.
 Speak to me in Vietnamese, but write all code in English.
 ```
 
@@ -63,7 +63,7 @@ Speak to me in Vietnamese, but write all code in English.
 Tạo file `.clinerules`, `.roorules` hoặc `KILO.md` ở 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 `./rules-skill/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 `./rules-skill/skills/`.
+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/`.
 Luôn giao tiếp bằng tiếng Việt nhưng viết code bằng tiếng Anh.
 ```
 
@@ -82,21 +82,26 @@ Tạo file `.github/copilot-instructions.md` và dán đoạn prompt tương t
 
 ---
 
-## 5. Cách tương tác với AI
+## 5. Cách tương tác & Gọi Skill cụ thể
 
-Giờ đây bạn chỉ cần chat với AI như giao việc cho một kỹ sư thật sự. Không cần viết prompt dài dòng!
+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.
 
-**Ví dụ 1: Nhờ AI tự lên kế hoạch (Kích hoạt `agent-orchestrator`)**
-> "Quang Khánh ơi, dự án này đang cần thêm tính năng Đăng nhập. Cậu lên kế hoạch giúp mình nên làm gì trước nhé."
+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ụ 2: Sửa lỗi (Kích hoạt `bug-fix`)**
-> "Bị lỗi Hydration error trên Next.js rồi. Fix giúp mình."
+### 🎯 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é."*
 
-**Ví dụ 3: Review Codebase (Kích hoạt `project-audit`)**
-> "Audit nhanh cho tôi thư mục `src/components/`, tìm xem có bị vấn đề về hiệu năng hay code smell không."
+### 🎯 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."*
 
-**Ví dụ 4: Frontend UI (Kích hoạt `ui-builder` + `design-system`)**
-> "Làm cho tôi cái giao diện 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ụ 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."*
 
-**Ví dụ 5: Tích hợp API (Kích hoạt `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ụ 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é."*
+
+### 🎯 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."*
+
+### 🎯 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."*

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-developer-skill-os",
-  "version": "1.0.4",
+  "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": {

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

@@ -11,8 +11,9 @@ platforms: [antigravity, claude-code, kilo-code, cursor, windsurf]
 # Auth & Security Engineer
 
 > **Language rule:**
-> Use **English** for: security protocols, tokens, headers, algorithms, code.
-> Use **the user's language** for: explanations, summaries, and questions.
+> Use English for: code, identifiers, file names, architecture terms, technical decisions.
+> Use the user's language for: explanations, questions, summaries, and feedback.
+> The user may write in any language — detect and match it automatically.
 
 ---
 

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

@@ -11,8 +11,9 @@ platforms: [antigravity, claude-code, kilo-code, cursor, windsurf]
 # Backend Architecture
 
 > **Language rule:**
-> Use **English** for: code, folder names, pattern names, technical rules.
-> Use **the user's language** for: explanations, summaries, and questions.
+> Use English for: code, identifiers, file names, architecture terms, technical decisions.
+> Use the user's language for: explanations, questions, summaries, and feedback.
+> The user may write in any language — detect and match it automatically.
 
 ---
 

package/skills/backend/database-engineer/SKILL.md

@@ -11,8 +11,9 @@ platforms: [antigravity, claude-code, kilo-code, cursor, windsurf]
 # Database Engineer
 
 > **Language rule:**
-> Use **English** for: table names, columns, queries, ORM code, technical terms.
-> Use **the user's language** for: explanations, summaries, and questions.
+> Use English for: code, identifiers, file names, architecture terms, technical decisions.
+> Use the user's language for: explanations, questions, summaries, and feedback.
+> The user may write in any language — detect and match it automatically.
 
 ---
 

package/skills/backend/deployment/SKILL.md

@@ -11,8 +11,9 @@ platforms: [antigravity, claude-code, kilo-code, cursor, windsurf]
 # Deployment & DevOps
 
 > **Language rule:**
-> Use **English** for: configuration files, Docker commands, YAML syntax, technical concepts.
-> Use **the user's language** for: explanations, summaries, and questions.
+> Use English for: code, identifiers, file names, architecture terms, technical decisions.
+> Use the user's language for: explanations, questions, summaries, and feedback.
+> The user may write in any language — detect and match it automatically.
 
 ---
 

package/skills/engineering/bug-fix/SKILL.md

@@ -11,8 +11,9 @@ platforms: [antigravity, claude-code, kilo-code, cursor, windsurf]
 # Bug Fix — Diagnose & Repair
 
 > **Language rule:**
-> Use **English** for: code, identifiers, error messages, file paths, technical labels.
-> Use **the user's language** for: explanations, questions, and fix summaries.
+> Use English for: code, identifiers, file names, architecture terms, technical decisions.
+> Use the user's language for: explanations, questions, summaries, and feedback.
+> The user may write in any language — detect and match it automatically.
 
 ---
 

package/skills/frontend/accessibility-audit/SKILL.md

@@ -11,8 +11,9 @@ platforms: [antigravity, claude-code, kilo-code, cursor, windsurf]
 # Accessibility (A11y) Audit
 
 > **Language rule:**
-> Use **English** for: ARIA attributes, HTML tags, WCAG guidelines, technical terms.
-> Use **the user's language** for: explanations, summaries, and questions.
+> Use English for: code, identifiers, file names, architecture terms, technical decisions.
+> Use the user's language for: explanations, questions, summaries, and feedback.
+> The user may write in any language — detect and match it automatically.
 
 ---
 

package/skills/frontend/component-generator/SKILL.md

@@ -11,8 +11,9 @@ platforms: [antigravity, claude-code, kilo-code, cursor, windsurf]
 # Component Generator
 
 > **Language rule:**
-> Use **English** for: code, component names, prop types, technical terminology.
-> Use **the user's language** for: explanations, summaries, and questions.
+> Use English for: code, identifiers, file names, architecture terms, technical decisions.
+> Use the user's language for: explanations, questions, summaries, and feedback.
+> The user may write in any language — detect and match it automatically.
 
 ---
 

package/skills/frontend/design-system/SKILL.md

@@ -11,8 +11,9 @@ platforms: [antigravity, claude-code, kilo-code, cursor, windsurf]
 # Design System Enforcer
 
 > **Language rule:**
-> Use **English** for: component names, CSS classes, design tokens, technical terms.
-> Use **the user's language** for: explanations, summaries, and questions.
+> Use English for: code, identifiers, file names, architecture terms, technical decisions.
+> Use the user's language for: explanations, questions, summaries, and feedback.
+> The user may write in any language — detect and match it automatically.
 
 ---
 

package/skills/frontend/form-builder/SKILL.md

@@ -11,8 +11,9 @@ platforms: [antigravity, claude-code, kilo-code, cursor, windsurf]
 # Form Builder
 
 > **Language rule:**
-> Use **English** for: field names, validation rules, code, technical concepts.
-> Use **the user's language** for: explanations, error message text (unless specified otherwise), and summaries.
+> Use English for: code, identifiers, file names, architecture terms, technical decisions.
+> Use the user's language for: explanations, questions, summaries, and feedback.
+> The user may write in any language — detect and match it automatically.
 
 ---
 

package/skills/frontend/frontend-architecture/SKILL.md

@@ -11,8 +11,9 @@ platforms: [antigravity, claude-code, kilo-code, cursor, windsurf]
 # Frontend Architecture
 
 > **Language rule:**
-> Use **English** for: code, folder names, architecture terms, technical rules.
-> Use **the user's language** for: explanations, questions, and summaries.
+> Use English for: code, identifiers, file names, architecture terms, technical decisions.
+> Use the user's language for: explanations, questions, summaries, and feedback.
+> The user may write in any language — detect and match it automatically.
 
 ---
 

package/skills/frontend/frontend-debug/SKILL.md

@@ -11,8 +11,9 @@ platforms: [antigravity, claude-code, kilo-code, cursor, windsurf]
 # Frontend Debugger
 
 > **Language rule:**
-> Use **English** for: code, error messages, stack traces, technical patterns.
-> Use **the user's language** for: explanations, root cause summaries, and questions.
+> Use English for: code, identifiers, file names, architecture terms, technical decisions.
+> Use the user's language for: explanations, questions, summaries, and feedback.
+> The user may write in any language — detect and match it automatically.
 
 ---
 

package/skills/frontend/frontend-performance/SKILL.md

@@ -11,8 +11,9 @@ platforms: [antigravity, claude-code, kilo-code, cursor, windsurf]
 # Frontend Performance Optimizer
 
 > **Language rule:**
-> Use **English** for: code, metrics (LCP, CLS, FID), technical terms (memoization, lazy loading).
-> Use **the user's language** for: explanations, summaries, and questions.
+> Use English for: code, identifiers, file names, architecture terms, technical decisions.
+> Use the user's language for: explanations, questions, summaries, and feedback.
+> The user may write in any language — detect and match it automatically.
 
 ---
 

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

@@ -11,8 +11,9 @@ platforms: [antigravity, claude-code, kilo-code, cursor, windsurf]
 # Frontend Testing
 
 > **Language rule:**
-> Use **English** for: code, test descriptions (`it('should...')`), mock data, technical terms.
-> Use **the user's language** for: explanations, summaries, and questions.
+> Use English for: code, identifiers, file names, architecture terms, technical decisions.
+> Use the user's language for: explanations, questions, summaries, and feedback.
+> The user may write in any language — detect and match it automatically.
 
 ---
 

package/skills/frontend/state-management/SKILL.md

@@ -11,8 +11,9 @@ platforms: [antigravity, claude-code, kilo-code, cursor, windsurf]
 # State Management
 
 > **Language rule:**
-> Use **English** for: code, store names, action types, library names.
-> Use **the user's language** for: explanations, summaries, and questions.
+> Use English for: code, identifiers, file names, architecture terms, technical decisions.
+> Use the user's language for: explanations, questions, summaries, and feedback.
+> The user may write in any language — detect and match it automatically.
 
 ---
 

package/skills/frontend/table-crud-generator/SKILL.md

@@ -11,8 +11,9 @@ platforms: [antigravity, claude-code, kilo-code, cursor, windsurf]
 # Table & CRUD Generator
 
 > **Language rule:**
-> Use **English** for: code, column names, API endpoints, technical features.
-> Use **the user's language** for: explanations, summaries, and table headers/UI text (if requested).
+> Use English for: code, identifiers, file names, architecture terms, technical decisions.
+> Use the user's language for: explanations, questions, summaries, and feedback.
+> The user may write in any language — detect and match it automatically.
 
 ---
 

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

@@ -11,8 +11,9 @@ platforms: [antigravity, claude-code, kilo-code, cursor, windsurf]
 # UI Builder
 
 > **Language rule:**
-> Use **English** for: code, component names, CSS classes, technical patterns.
-> Use **the user's language** for: explanations, questions, and summaries.
+> Use English for: code, identifiers, file names, architecture terms, technical decisions.
+> Use the user's language for: explanations, questions, summaries, and feedback.
+> The user may write in any language — detect and match it automatically.
 
 ---
 

package/skills.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.0.0",
+  "version": "1.0.1",
   "name": "AI Developer Skill OS",
   "description": "Multi-agent skill package for AI coding agents — Engineering + Frontend + Backend",
   "language": "en",