ai-developer-skill-os 3.1.4 → 3.1.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-developer-skill-os",
-  "version": "3.1.4",
+  "version": "3.1.5",
   "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-access-policy/SKILL.md

@@ -1,8 +1,8 @@
 ---
 name: qk-access-policy
-version: 3.1.4
+version: 3.1.5
 updated: 2026-07-02
-description: Manage RBAC, ABAC, and security boundaries.
+description: Quản lý RBAC, ABAC và các ranh giới bảo mật.
 category: security
 behavior: static-analysis
 intent: review-code

package/skills/qk-ai-builder/SKILL.md

@@ -1,8 +1,8 @@
 ---
 name: qk-ai-builder
-version: 3.1.4
+version: 3.1.5
 updated: 2026-07-02
-description: Design AI Logic, Prompts, RAG pipelines, and Agents.
+description: Thiết kế AI Logic, Prompts, RAG pipelines, và các Agents.
 category: ai
 behavior: development
 intent: implement-feature

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

@@ -1,8 +1,8 @@
 ---
 name: qk-api-lifecycle
-version: 3.1.4
+version: 3.1.5
 updated: 2026-07-02
-description: Design, implement, and integrate API endpoints.
+description: Thiết kế, triển khai, và tích hợp các API endpoints.
 category: engineering
 behavior: development
 intent: implement-feature
@@ -31,6 +31,7 @@ pipeline: [analyze, implement, engineering-standard, validate, complete]
    - If Backend: Choose the appropriate layer (Controller -> Service -> Repository).
 3. **Execute (Implementation):**
    - Write the backend handler/controller with strict validation (e.g., Zod, Class Validator).
+   - **Security:** Integrate Auth Middleware (JWT/RBAC) before the Controller. DO NOT expose public endpoints unless explicitly requested.
    - Write the frontend API client (e.g., Axios instance wrapper).
 4. **Verify (Validation):**
    - Handle Error Status Codes (400, 401, 403, 404, 500) gracefully.
@@ -40,6 +41,7 @@ pipeline: [analyze, implement, engineering-standard, validate, complete]
 
 - **No Hardcoded URLs:** Never hardcode `http://localhost:3000` inside frontend components. Always use environment variables (`process.env.API_URL`).
 - **Separation of Concerns:** Do NOT write `fetch` or `axios.get` directly inside a React UI component. Extract it to a custom hook or an API service file.
+- **Pagination & Rate Limit:** Any `GET` API returning a list MUST include Pagination by default to prevent server OOM.
 
 ## 🌳 3. Decision Tree
 

package/skills/qk-bug-resolution/SKILL.md

@@ -1,8 +1,8 @@
 ---
 name: qk-bug-resolution
-version: 3.1.4
+version: 3.1.5
 updated: 2026-07-02
-description: Fix bugs and prevent regressions.
+description: Xử lý và sửa các lỗi (bugs), đồng thời ngăn ngừa lỗi hồi quy.
 category: engineering
 behavior: development
 intent: fix-bug
@@ -22,8 +22,9 @@ pipeline: [analyze, implement, engineering-standard, validate, complete]
 
 ## 🔄 1. Chain of Thought (SOP)
 
-1. **Analyze (Root Cause Analysis):**
+1. **Analyze (Root Cause Analysis & Reproduce):**
    - Read the provided error log or bug description.
+   - Identify how to reproduce the bug. Ask the user for more info if it is unclear.
    - Trace the error to the exact file and line of code.
    - Identify if the bug is a syntax error, logic error, state issue, or boundary case.
 2. **Plan (Fix Strategy):**
@@ -41,6 +42,7 @@ pipeline: [analyze, implement, engineering-standard, validate, complete]
 - **No Guesses:** Do not assume the shape of an API response. Print it or read the type definitions first.
 - **Minimal Fix:** Always prefer a 1-line fix over a 100-line refactor, unless the architecture is fundamentally broken.
 - **Clean Up:** Remove any `console.log()` or debugger statements introduced during the debugging process.
+- **Regression Test:** Add at least 1 Unit or Integration Test to prevent this bug from recurring.
 
 ## 🌳 3. Decision Tree
 

package/skills/qk-context-loader/SKILL.md

@@ -1,8 +1,8 @@
 ---
 name: qk-context-loader
-version: 3.1.4
+version: 3.1.5
 updated: 2026-07-02
-description: Load relevant files and map the dependency graph for a task.
+description: Tải các file liên quan và vẽ biểu đồ phụ thuộc (dependency graph) cho một tác vụ.
 category: utilities
 behavior: static-analysis
 intent: review-code

package/skills/qk-data-lifecycle/SKILL.md

@@ -1,8 +1,8 @@
 ---
 name: qk-data-lifecycle
-version: 3.1.4
+version: 3.1.5
 updated: 2026-07-02
-description: Manage Database Schema, Migrations, and Repositories.
+description: Quản lý Database Schema, Migrations, và Repositories.
 category: database
 behavior: development
 intent: implement-feature

package/skills/qk-db-optimizer/SKILL.md

@@ -0,0 +1,63 @@
+---
+name: qk-db-optimizer
+version: 1.0.0
+updated: 2026-07-02
+description: Tối ưu hóa Database (đánh Index, xử lý N+1 Queries, Slow Queries).
+category: database
+behavior: development
+intent: implement-feature
+priority: high
+tags: [database, optimize, sql, index, performance]
+platforms: [claude-code, cursor, windsurf, gemini-cli]
+trigger: User asks to optimize database, fix slow queries, add index, or resolve N+1 issues.
+inputs: [Database Schema, Slow Query Log or ORM code]
+outputs: [Optimized Query/ORM code, Migration script for Indexes]
+allowed_tools: [run_command, read_file, write_to_file, grep_search]
+pipeline: [analyze, plan, implement, validate, complete]
+---
+
+# 🛠️ qk-db-optimizer - Standard Operating Procedure
+
+> **Goal:** Tối ưu hóa hiệu suất cơ sở dữ liệu. Đóng vai trò là một Database Administrator (DBA) / Performance Engineer. Giải quyết các bài toán cổ điển như N+1 queries, thiếu Index, truy vấn chậm.
+
+## 🔄 1. Chain of Thought (SOP)
+
+1. **Analyze (Bottleneck Identification):**
+   - Read the relevant ORM code (Prisma, TypeORM, Drizzle) or raw SQL.
+   - Identify the source of the slowdown (e.g., fetching in a loop causing N+1).
+2. **Plan (Optimization Strategy):**
+   - Decide whether to optimize the query structure (e.g., using `JOIN` / `include`) or add an Index to the database schema.
+3. **Implement (Code & Schema changes):**
+   - Refactor the code to eliminate N+1 queries.
+   - Write migration scripts or update the ORM schema to add necessary Indexes.
+4. **Verify (Explain & Test):**
+   - Ensure the new query yields the same correct result.
+
+## 🛡️ 2. Constraints & Rules
+
+- **No Destructive Operations:** Never drop tables or columns unless explicitly asked by the user to do so.
+- **Explain First:** Always explain why a query is slow and how your index/refactor fixes it.
+
+## 🌳 3. Decision Tree
+
+```text
+Is it an N+1 Query problem?
+  ├── YES → Use Eager Loading (e.g., `.include()` in Prisma) or a DataLoader pattern.
+  └── NO → Is it a slow filtering/sorting issue?
+             ├── YES → Add a database Index (B-Tree, Hash, etc.) to the relevant columns.
+             └── NO → Refactor the raw SQL/ORM logic to be more efficient.
+```
+
+## 🤝 4. Handoff Pipeline
+
+1. `validate`: Run tests using `qk-validation-gate` to ensure no data regressions.
+2. `complete`: Generate the Database Optimization report.
+
+## 📝 5. Output Format
+
+Vui lòng trả kết quả bằng Tiếng Việt.
+
+- **Tóm tắt (Summary):** Vấn đề gì đã được giải quyết.
+- **Chi tiết (Changes):** Cách khắc phục (đánh index hay refactor code).
+- **Hiệu năng (Performance):** Giải thích tại sao cách mới lại nhanh hơn.
+- **Xác thực (Verification):** ...

package/skills/qk-design-to-code/SKILL.md

@@ -1,8 +1,8 @@
 ---
 name: qk-design-to-code
-version: 3.1.4
+version: 3.1.5
 updated: 2026-07-02
-description: Convert Figma/Images to semantic, pixel-perfect code components.
+description: Chuyển đổi thiết kế từ Figma/Images thành các UI component hoàn chỉnh, chuẩn pixel.
 category: frontend
 behavior: development
 intent: implement-feature

package/skills/qk-docs/SKILL.md

@@ -1,15 +1,15 @@
 ---
 name: qk-docs
-version: 3.1.4
+version: 3.1.5
 updated: 2026-07-02
-description: Write and maintain human-readable project documentation.
+description: Viết và duy trì tài liệu dự án để con người có thể dễ dàng đọc hiểu.
 category: documentation
 behavior: static-analysis
 intent: maintain
 priority: low
-tags: [docs, markdown, jsdoc, readme]
+tags: [docs, markdown, jsdoc, readme, architecture, mermaid]
 platforms: [claude-code, cursor, windsurf, gemini-cli]
-trigger: User asks to write docs, update the README, or generate JSDoc comments.
+trigger: User asks to write docs, generate architecture diagrams, update README, or write JSDoc.
 inputs: [Source code, Task context]
 outputs: [Markdown Documentation, JSDoc]
 allowed_tools: [read_file, write_to_file]
@@ -40,11 +40,13 @@ pipeline: [analyze, implement, validate, complete]
 ## 🌳 3. Decision Tree
 
 ```text
-Is this an API Documentation?
-  ├── YES → Use standard REST/GraphQL documentation layout (Endpoint, Method, Body, Response).
-  └── NO → Is it a Component Documentation?
-             ├── YES → Document the Props interface and usage examples.
-             └── NO → Write standard JSDoc.
+Is this a System Architecture or Flow?
+  ├── YES → Create Mermaid diagrams (Architecture, Sequence) and save to `/docs/`.
+  └── NO → Is this an API Documentation?
+             ├── YES → Use standard REST/GraphQL documentation layout (Endpoint, Method, Body, Response).
+             └── NO → Is it a Component Documentation?
+                        ├── YES → Document the Props interface and usage examples.
+                        └── NO → Write standard JSDoc or update README.
 ```
 
 ## 🤝 4. Handoff Pipeline

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

@@ -1,8 +1,8 @@
 ---
 name: qk-engineering-standard
-version: 3.1.4
+version: 3.1.5
 updated: 2026-07-02
-description: Enforce SOLID, DRY, Clean Code, and Naming conventions.
+description: Ép buộc áp dụng SOLID, DRY, Clean Code, và các quy tắc đặt tên.
 category: standard
 behavior: static-analysis
 intent: review-code

package/skills/qk-feature-delivery/SKILL.md

@@ -1,8 +1,8 @@
 ---
 name: qk-feature-delivery
-version: 3.1.4
+version: 3.1.5
 updated: 2026-07-02
-description: Develop new features end-to-end (Frontend & Backend).
+description: Phát triển tính năng mới hoàn chỉnh từ Frontend đến Backend.
 category: engineering
 behavior: development
 intent: implement-feature
@@ -32,12 +32,13 @@ pipeline: [analyze, implement, engineering-standard, validate, complete]
    - Build the backend/API mock first (if applicable).
    - Build the UI component and bind the data.
 4. **Verify (Validation):**
-   - Check if the UI is responsive.
-   - Ensure the API handles edge cases (empty states, loading, error).
+   - **4 UI States:** Implement all 4 UI states: `Loading` (Skeleton/Spinner), `Success` (Data), `Error` (Fallback UI/Retry), and `Empty` (No data).
+   - Check if the UI is responsive (works well on Mobile & Desktop).
 
 ## 🛡️ 3. Constraints & Rules
 
 - **Contract First:** Always define the Type/Interface contract before writing the implementation logic.
+- **State Management:** Lift state to Global (Redux/Zustand/Context) only if 2 or more components outside the same parent/child tree need to share it. Do not abuse Global State.
 - **Component Reusability:** Do not create a new Button or Input if a Shared Component already exists in `src/components/shared/`.
 - **DRY (Don't Repeat Yourself):** Extract inline styles or duplicate logic into hooks/utilities.
 

package/skills/qk-help/SKILL.md

@@ -1,8 +1,8 @@
 ---
 name: qk-help
-version: 3.1.4
+version: 3.1.5
 updated: 2026-07-02
-description: Display the list of available skills and pro-tips.
+description: Hiển thị danh sách các kỹ năng hiện có và các mẹo sử dụng.
 category: utilities
 behavior: static-analysis
 intent: review-code

package/skills/qk-orchestrator/SKILL.md

@@ -1,8 +1,8 @@
 ---
 name: qk-orchestrator
-version: 3.1.4
+version: 3.1.5
 updated: 2026-07-02
-description: Route user requests, parse intents, and delegate to the correct sub-skills.
+description: Điều hướng yêu cầu của người dùng, phân tích ý định và ủy quyền cho các sub-skills phù hợp.
 category: orchestration
 behavior: static-analysis
 intent: review-code
@@ -32,7 +32,8 @@ pipeline: [analyze, plan, delegate]
 
 ## 🛡️ 2. Constraints & Rules
 
-- **Delegation First:** Do not write source code directly while acting as the Orchestrator. Delegate to the correct specialized Skill.
+- **Cost-Awareness:** Evaluate task complexity. If the task is trivial (e.g., fix a typo, change display text), solve it directly to save tokens.
+- **Delegation First:** For complex tasks, do not write source code directly. Delegate to the correct specialized Skill.
 - **Ambiguity Check:** If the user's intent is unclear, give them 2-3 Skill suggestions to choose from.
 
 ## 🌳 3. Decision Tree

package/skills/qk-policy-engine/SKILL.md

@@ -1,8 +1,8 @@
 ---
 name: qk-policy-engine
-version: 3.1.4
+version: 3.1.5
 updated: 2026-07-02
-description: Policy evaluation engine to ensure actions are authorized and safe.
+description: Hệ thống đánh giá chính sách để đảm bảo các hành động an toàn và được ủy quyền.
 category: security
 behavior: static-analysis
 intent: review-code

package/skills/qk-production-release/SKILL.md

@@ -1,8 +1,8 @@
 ---
 name: qk-production-release
-version: 3.1.4
+version: 3.1.5
 updated: 2026-07-02
-description: Prepare the codebase for a production release (Build, CI/CD, Security).
+description: Chuẩn bị codebase để phát hành lên production (Build, CI/CD, Security).
 category: operations
 behavior: validation
 intent: validate

package/skills/qk-project-bootstrap/SKILL.md

@@ -1,8 +1,8 @@
 ---
 name: qk-project-bootstrap
-version: 3.1.4
+version: 3.1.5
 updated: 2026-07-02
-description: Initialize a new project with best practices, linters, and folder structures.
+description: Khởi tạo dự án mới với các best practices, linters, và cấu trúc thư mục chuẩn.
 category: setup
 behavior: development
 intent: implement-feature

package/skills/qk-project-health/SKILL.md

@@ -1,8 +1,8 @@
 ---
 name: qk-project-health
-version: 3.1.4
+version: 3.1.5
 updated: 2026-07-02
-description: Comprehensive audit of Code Smells, Tech Debt, and Architecture.
+description: Kiểm toán toàn diện về Code Smells, Tech Debt, và Architecture.
 category: architecture
 behavior: static-analysis
 intent: review-code

package/skills/qk-project-memory/SKILL.md

@@ -1,8 +1,8 @@
 ---
 name: qk-project-memory
-version: 3.1.4
+version: 3.1.5
 updated: 2026-07-02
-description: Store and retrieve long-term project context across sessions.
+description: Lưu trữ và truy xuất ngữ cảnh dự án dài hạn qua các phiên làm việc.
 category: utilities
 behavior: static-analysis
 intent: maintain

package/skills/qk-system-evolution/SKILL.md

@@ -1,8 +1,8 @@
 ---
 name: qk-system-evolution
-version: 3.1.4
+version: 3.1.5
 updated: 2026-07-02
-description: Safely upgrade dependencies, migrate frameworks, and manage rollbacks.
+description: Cập nhật an toàn các thư viện dependencies, di chuyển frameworks và quản lý quá trình rollback.
 category: operations
 behavior: maintenance
 intent: maintain
@@ -29,9 +29,9 @@ pipeline: [analyze, plan, implement, validate, complete]
 2. **Plan (Rollback Strategy):**
    - Document the exact Git commands or NPM commands needed to revert the system if the upgrade fails completely.
 3. **Implement (Dry-Run & Upgrade):**
-   - Apply the dependency updates in `package.json`.
-   - Run Codemods (if provided by the library).
-   - Manually fix code affected by Breaking Changes.
+   - **Mandatory Dry Run:** Create a temporary branch (e.g., `git checkout -b upgrade-dry-run`).
+   - Update dependencies and run Codemods on this branch.
+   - Fix Breaking Changes and pass the Validation Gate. Merge only if safe.
 4. **Verify (System Test):**
    - Reinstall dependencies cleanly (`npm ci` or `yarn install`).
    - Run the build process to ensure the system compiles.

package/skills/qk-ui-audit/SKILL.md

@@ -1,8 +1,8 @@
 ---
 name: qk-ui-audit
-version: 3.1.4
+version: 3.1.5
 updated: 2026-07-02
-description: Audit UI for Consistency, Accessibility, Responsive, and Performance.
+description: Kiểm toán giao diện (UI) để đảm bảo tính nhất quán, khả năng truy cập (A11y), độ phản hồi (Responsive) và hiệu suất.
 category: validation
 behavior: static-analysis
 intent: review-code

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

@@ -1,8 +1,8 @@
 ---
 name: qk-ui-system-builder
-version: 3.1.4
+version: 3.1.5
 updated: 2026-07-02
-description: Build and maintain Design Systems, Token extraction, and shared UI libraries.
+description: Xây dựng và duy trì Design Systems, Token extraction, và các thư viện UI dùng chung.
 category: frontend
 behavior: development
 intent: implement-feature

package/skills/qk-validation-gate/SKILL.md

@@ -1,8 +1,8 @@
 ---
 name: qk-validation-gate
-version: 3.1.4
+version: 3.1.5
 updated: 2026-07-02
-description: Mandatory Quality Gate (Test, Lint, Security).
+description: Cổng kiểm tra chất lượng bắt buộc (Test, Lint, Security).
 category: validation
 behavior: validation
 intent: validate

package/skills.json

@@ -21,7 +21,12 @@
       "behavior": "static-analysis",
       "intent": "review-code",
       "priority": "high",
-      "tags": ["security", "rbac", "auth", "permissions"],
+      "tags": [
+        "security",
+        "rbac",
+        "auth",
+        "permissions"
+      ],
       "trigger": [
         "add roles",
         "restrict access",
@@ -31,9 +36,14 @@
       ],
       "dependencies": [],
       "conflicts": [],
-      "platforms": ["claude-code", "cursor", "windsurf", "gemini-cli"],
+      "platforms": [
+        "claude-code",
+        "cursor",
+        "windsurf",
+        "gemini-cli"
+      ],
       "status": "ready",
-      "description": "Manage RBAC, ABAC, and security boundaries."
+      "description": "Quản lý RBAC, ABAC và các ranh giới bảo mật."
     },
     {
       "name": "qk-ai-builder",
@@ -44,7 +54,13 @@
       "behavior": "development",
       "intent": "implement-feature",
       "priority": "medium",
-      "tags": ["ai", "llm", "prompt-engineering", "rag", "agents"],
+      "tags": [
+        "ai",
+        "llm",
+        "prompt-engineering",
+        "rag",
+        "agents"
+      ],
       "trigger": [
         "build a chatbot",
         "add AI features",
@@ -53,9 +69,14 @@
       ],
       "dependencies": [],
       "conflicts": [],
-      "platforms": ["claude-code", "cursor", "windsurf", "gemini-cli"],
+      "platforms": [
+        "claude-code",
+        "cursor",
+        "windsurf",
+        "gemini-cli"
+      ],
       "status": "ready",
-      "description": "Design AI Logic, Prompts, RAG pipelines, and Agents."
+      "description": "Thiết kế AI Logic, Prompts, RAG pipelines, và các Agents."
     },
     {
       "name": "qk-api-lifecycle",
@@ -66,7 +87,12 @@
       "behavior": "development",
       "intent": "implement-feature",
       "priority": "high",
-      "tags": ["api", "backend", "frontend-integration", "endpoints"],
+      "tags": [
+        "api",
+        "backend",
+        "frontend-integration",
+        "endpoints"
+      ],
       "trigger": [
         "create a new API",
         "fix an API",
@@ -76,9 +102,14 @@
       ],
       "dependencies": [],
       "conflicts": [],
-      "platforms": ["claude-code", "cursor", "windsurf", "gemini-cli"],
+      "platforms": [
+        "claude-code",
+        "cursor",
+        "windsurf",
+        "gemini-cli"
+      ],
       "status": "ready",
-      "description": "Design, implement, and integrate API endpoints."
+      "description": "Thiết kế, triển khai, và tích hợp các API endpoints."
     },
     {
       "name": "qk-bug-resolution",
@@ -89,7 +120,12 @@
       "behavior": "development",
       "intent": "fix-bug",
       "priority": "high",
-      "tags": ["bug", "debug", "regression", "error"],
+      "tags": [
+        "bug",
+        "debug",
+        "regression",
+        "error"
+      ],
       "trigger": [
         "fix this bug",
         "it's broken",
@@ -102,9 +138,14 @@
       ],
       "dependencies": [],
       "conflicts": [],
-      "platforms": ["claude-code", "cursor", "windsurf", "gemini-cli"],
+      "platforms": [
+        "claude-code",
+        "cursor",
+        "windsurf",
+        "gemini-cli"
+      ],
       "status": "ready",
-      "description": "Fix bugs and prevent regressions."
+      "description": "Xử lý và sửa các lỗi (bugs), đồng thời ngăn ngừa lỗi hồi quy."
     },
     {
       "name": "qk-context-loader",
@@ -115,7 +156,12 @@
       "behavior": "static-analysis",
       "intent": "review-code",
       "priority": "medium",
-      "tags": ["context", "filesystem", "dependencies", "graph"],
+      "tags": [
+        "context",
+        "filesystem",
+        "dependencies",
+        "graph"
+      ],
       "trigger": [
         "understand the codebase",
         "what files should I read",
@@ -125,9 +171,14 @@
       ],
       "dependencies": [],
       "conflicts": [],
-      "platforms": ["claude-code", "cursor", "windsurf", "gemini-cli"],
+      "platforms": [
+        "claude-code",
+        "cursor",
+        "windsurf",
+        "gemini-cli"
+      ],
       "status": "ready",
-      "description": "Load relevant files and map the dependency graph for a task."
+      "description": "Tải các file liên quan và vẽ biểu đồ phụ thuộc (dependency graph) cho một tác vụ."
     },
     {
       "name": "qk-data-lifecycle",
@@ -138,7 +189,13 @@
       "behavior": "development",
       "intent": "implement-feature",
       "priority": "medium",
-      "tags": ["database", "sql", "migration", "schema", "orm"],
+      "tags": [
+        "database",
+        "sql",
+        "migration",
+        "schema",
+        "orm"
+      ],
       "trigger": [
         "create a new database table",
         "modify schema",
@@ -149,9 +206,47 @@
       ],
       "dependencies": [],
       "conflicts": [],
-      "platforms": ["claude-code", "cursor", "windsurf", "gemini-cli"],
+      "platforms": [
+        "claude-code",
+        "cursor",
+        "windsurf",
+        "gemini-cli"
+      ],
+      "status": "ready",
+      "description": "Quản lý Database Schema, Migrations, và Repositories."
+    },
+    {
+      "name": "qk-db-optimizer",
+      "path": "skills/qk-db-optimizer/SKILL.md",
+      "version": "1.0.0",
+      "category": "database",
+      "subcategory": "backend",
+      "behavior": "development",
+      "intent": "implement-feature",
+      "priority": "high",
+      "tags": [
+        "database",
+        "optimize",
+        "sql",
+        "index",
+        "performance"
+      ],
+      "trigger": [
+        "optimize database",
+        "slow queries",
+        "add index",
+        "N+1 issues"
+      ],
+      "dependencies": [],
+      "conflicts": [],
+      "platforms": [
+        "claude-code",
+        "cursor",
+        "windsurf",
+        "gemini-cli"
+      ],
       "status": "ready",
-      "description": "Manage Database Schema, Migrations, and Repositories."
+      "description": "Tối ưu hóa Database (đánh Index, xử lý N+1 Queries, Slow Queries)."
     },
     {
       "name": "qk-design-to-code",
@@ -162,7 +257,13 @@
       "behavior": "development",
       "intent": "implement-feature",
       "priority": "high",
-      "tags": ["ui", "figma", "frontend", "styling", "css"],
+      "tags": [
+        "ui",
+        "figma",
+        "frontend",
+        "styling",
+        "css"
+      ],
       "trigger": [
         "upload image mockup",
         "design requirement",
@@ -171,9 +272,14 @@
       ],
       "dependencies": [],
       "conflicts": [],
-      "platforms": ["claude-code", "cursor", "windsurf", "gemini-cli"],
+      "platforms": [
+        "claude-code",
+        "cursor",
+        "windsurf",
+        "gemini-cli"
+      ],
       "status": "ready",
-      "description": "Convert Figma/Images to semantic, pixel-perfect code components."
+      "description": "Chuyển đổi thiết kế từ Figma/Images thành các UI component hoàn chỉnh, chuẩn pixel."
     },
     {
       "name": "qk-docs",
@@ -184,7 +290,12 @@
       "behavior": "static-analysis",
       "intent": "maintain",
       "priority": "low",
-      "tags": ["docs", "markdown", "jsdoc", "readme"],
+      "tags": [
+        "docs",
+        "markdown",
+        "jsdoc",
+        "readme"
+      ],
       "trigger": [
         "write docs",
         "update the README",
@@ -193,31 +304,14 @@
       ],
       "dependencies": [],
       "conflicts": [],
-      "platforms": ["claude-code", "cursor", "windsurf", "gemini-cli"],
-      "status": "ready",
-      "description": "Write and maintain human-readable project documentation."
-    },
-    {
-      "name": "qk-documentation-system",
-      "path": "skills/qk-documentation-system/SKILL.md",
-      "version": "3.0.0",
-      "category": "documentation",
-      "subcategory": "maintenance",
-      "behavior": "static-analysis",
-      "intent": "maintain",
-      "priority": "low",
-      "tags": ["architecture", "diagrams", "mermaid", "runbooks"],
-      "trigger": [
-        "generate architecture diagrams",
-        "DevOps manuals",
-        "system docs",
-        "mermaid diagram"
+      "platforms": [
+        "claude-code",
+        "cursor",
+        "windsurf",
+        "gemini-cli"
       ],
-      "dependencies": [],
-      "conflicts": [],
-      "platforms": ["claude-code", "cursor", "windsurf", "gemini-cli"],
       "status": "ready",
-      "description": "Maintain system-level architecture docs and DevOps runbooks."
+      "description": "Viết và duy trì tài liệu dự án để con người có thể dễ dàng đọc hiểu."
     },
     {
       "name": "qk-engineering-standard",
@@ -228,7 +322,13 @@
       "behavior": "static-analysis",
       "intent": "review-code",
       "priority": "critical",
-      "tags": ["clean-code", "architecture", "refactoring", "solid", "naming"],
+      "tags": [
+        "clean-code",
+        "architecture",
+        "refactoring",
+        "solid",
+        "naming"
+      ],
       "trigger": [
         "review code",
         "refactor code",
@@ -239,9 +339,14 @@
       ],
       "dependencies": [],
       "conflicts": [],
-      "platforms": ["claude-code", "cursor", "windsurf", "gemini-cli"],
+      "platforms": [
+        "claude-code",
+        "cursor",
+        "windsurf",
+        "gemini-cli"
+      ],
       "status": "ready",
-      "description": "Enforce SOLID, DRY, Clean Code, and Naming conventions."
+      "description": "Ép buộc áp dụng SOLID, DRY, Clean Code, và các quy tắc đặt tên."
     },
     {
       "name": "qk-feature-delivery",
@@ -252,7 +357,13 @@
       "behavior": "development",
       "intent": "implement-feature",
       "priority": "high",
-      "tags": ["feature", "development", "e2e", "ui", "api"],
+      "tags": [
+        "feature",
+        "development",
+        "e2e",
+        "ui",
+        "api"
+      ],
       "trigger": [
         "create a new page",
         "build a new component",
@@ -261,9 +372,14 @@
       ],
       "dependencies": [],
       "conflicts": [],
-      "platforms": ["claude-code", "cursor", "windsurf", "gemini-cli"],
+      "platforms": [
+        "claude-code",
+        "cursor",
+        "windsurf",
+        "gemini-cli"
+      ],
       "status": "ready",
-      "description": "Develop new features end-to-end (Frontend & Backend)."
+      "description": "Phát triển tính năng mới hoàn chỉnh từ Frontend đến Backend."
     },
     {
       "name": "qk-help",
@@ -274,7 +390,12 @@
       "behavior": "static-analysis",
       "intent": "review-code",
       "priority": "low",
-      "tags": ["help", "manual", "list", "tutorial"],
+      "tags": [
+        "help",
+        "manual",
+        "list",
+        "tutorial"
+      ],
       "trigger": [
         "help",
         "list skills",
@@ -284,9 +405,14 @@
       ],
       "dependencies": [],
       "conflicts": [],
-      "platforms": ["claude-code", "cursor", "windsurf", "gemini-cli"],
+      "platforms": [
+        "claude-code",
+        "cursor",
+        "windsurf",
+        "gemini-cli"
+      ],
       "status": "ready",
-      "description": "Display the list of available skills and pro-tips."
+      "description": "Hiển thị danh sách các kỹ năng hiện có và các mẹo sử dụng."
     },
     {
       "name": "qk-orchestrator",
@@ -297,7 +423,12 @@
       "behavior": "static-analysis",
       "intent": "review-code",
       "priority": "critical",
-      "tags": ["router", "orchestrator", "delegation", "ai-manager"],
+      "tags": [
+        "router",
+        "orchestrator",
+        "delegation",
+        "ai-manager"
+      ],
       "trigger": [
         "plan this task",
         "how should I approach",
@@ -308,9 +439,14 @@
       ],
       "dependencies": [],
       "conflicts": [],
-      "platforms": ["claude-code", "cursor", "windsurf", "gemini-cli"],
+      "platforms": [
+        "claude-code",
+        "cursor",
+        "windsurf",
+        "gemini-cli"
+      ],
       "status": "ready",
-      "description": "Route user requests, parse intents, and delegate to the correct sub-skills."
+      "description": "Điều hướng yêu cầu của người dùng, phân tích ý định và ủy quyền cho các sub-skills phù hợp."
     },
     {
       "name": "qk-policy-engine",
@@ -321,7 +457,12 @@
       "behavior": "static-analysis",
       "intent": "review-code",
       "priority": "high",
-      "tags": ["security", "policy", "guardrails", "authorization"],
+      "tags": [
+        "security",
+        "policy",
+        "guardrails",
+        "authorization"
+      ],
       "trigger": [
         "high-risk destructive action",
         "DROP table",
@@ -330,9 +471,14 @@
       ],
       "dependencies": [],
       "conflicts": [],
-      "platforms": ["claude-code", "cursor", "windsurf", "gemini-cli"],
+      "platforms": [
+        "claude-code",
+        "cursor",
+        "windsurf",
+        "gemini-cli"
+      ],
       "status": "ready",
-      "description": "Policy evaluation engine to ensure actions are authorized and safe."
+      "description": "Hệ thống đánh giá chính sách để đảm bảo các hành động an toàn và được ủy quyền."
     },
     {
       "name": "qk-production-release",
@@ -343,7 +489,12 @@
       "behavior": "validation",
       "intent": "validate",
       "priority": "high",
-      "tags": ["deploy", "release", "build", "production"],
+      "tags": [
+        "deploy",
+        "release",
+        "build",
+        "production"
+      ],
       "trigger": [
         "deploy the app",
         "build for production",
@@ -352,9 +503,14 @@
       ],
       "dependencies": [],
       "conflicts": [],
-      "platforms": ["claude-code", "cursor", "windsurf", "gemini-cli"],
+      "platforms": [
+        "claude-code",
+        "cursor",
+        "windsurf",
+        "gemini-cli"
+      ],
       "status": "ready",
-      "description": "Prepare the codebase for a production release (Build, CI/CD, Security)."
+      "description": "Chuẩn bị codebase để phát hành lên production (Build, CI/CD, Security)."
     },
     {
       "name": "qk-project-bootstrap",
@@ -365,7 +521,12 @@
       "behavior": "development",
       "intent": "implement-feature",
       "priority": "high",
-      "tags": ["bootstrap", "scaffolding", "setup", "init"],
+      "tags": [
+        "bootstrap",
+        "scaffolding",
+        "setup",
+        "init"
+      ],
       "trigger": [
         "start a new project",
         "create a new repo",
@@ -374,9 +535,14 @@
       ],
       "dependencies": [],
       "conflicts": [],
-      "platforms": ["claude-code", "cursor", "windsurf", "gemini-cli"],
+      "platforms": [
+        "claude-code",
+        "cursor",
+        "windsurf",
+        "gemini-cli"
+      ],
       "status": "ready",
-      "description": "Initialize a new project with best practices, linters, and folder structures."
+      "description": "Khởi tạo dự án mới với các best practices, linters, và cấu trúc thư mục chuẩn."
     },
     {
       "name": "qk-project-health",
@@ -387,7 +553,12 @@
       "behavior": "static-analysis",
       "intent": "review-code",
       "priority": "medium",
-      "tags": ["audit", "architecture", "tech-debt", "code-smell"],
+      "tags": [
+        "audit",
+        "architecture",
+        "tech-debt",
+        "code-smell"
+      ],
       "trigger": [
         "project review",
         "architecture audit",
@@ -397,9 +568,14 @@
       ],
       "dependencies": [],
       "conflicts": [],
-      "platforms": ["claude-code", "cursor", "windsurf", "gemini-cli"],
+      "platforms": [
+        "claude-code",
+        "cursor",
+        "windsurf",
+        "gemini-cli"
+      ],
       "status": "ready",
-      "description": "Comprehensive audit of Code Smells, Tech Debt, and Architecture."
+      "description": "Kiểm toán toàn diện về Code Smells, Tech Debt, và Architecture."
     },
     {
       "name": "qk-project-memory",
@@ -410,7 +586,11 @@
       "behavior": "static-analysis",
       "intent": "maintain",
       "priority": "low",
-      "tags": ["memory", "context", "storage"],
+      "tags": [
+        "memory",
+        "context",
+        "storage"
+      ],
       "trigger": [
         "remember a specific configuration",
         "architectural decision",
@@ -419,9 +599,14 @@
       ],
       "dependencies": [],
       "conflicts": [],
-      "platforms": ["claude-code", "cursor", "windsurf", "gemini-cli"],
+      "platforms": [
+        "claude-code",
+        "cursor",
+        "windsurf",
+        "gemini-cli"
+      ],
       "status": "ready",
-      "description": "Store and retrieve long-term project context across sessions."
+      "description": "Lưu trữ và truy xuất ngữ cảnh dự án dài hạn qua các phiên làm việc."
     },
     {
       "name": "qk-system-evolution",
@@ -432,7 +617,12 @@
       "behavior": "maintenance",
       "intent": "maintain",
       "priority": "high",
-      "tags": ["upgrade", "migration", "devops", "dependencies"],
+      "tags": [
+        "upgrade",
+        "migration",
+        "devops",
+        "dependencies"
+      ],
       "trigger": [
         "update a library",
         "upgrade a framework",
@@ -441,9 +631,14 @@
       ],
       "dependencies": [],
       "conflicts": [],
-      "platforms": ["claude-code", "cursor", "windsurf", "gemini-cli"],
+      "platforms": [
+        "claude-code",
+        "cursor",
+        "windsurf",
+        "gemini-cli"
+      ],
       "status": "ready",
-      "description": "Safely upgrade dependencies, migrate frameworks, and manage rollbacks."
+      "description": "Cập nhật an toàn các thư viện dependencies, di chuyển frameworks và quản lý quá trình rollback."
     },
     {
       "name": "qk-ui-audit",
@@ -454,7 +649,13 @@
       "behavior": "static-analysis",
       "intent": "review-code",
       "priority": "medium",
-      "tags": ["ui", "audit", "frontend", "a11y", "responsive"],
+      "tags": [
+        "ui",
+        "audit",
+        "frontend",
+        "a11y",
+        "responsive"
+      ],
       "trigger": [
         "check the UI",
         "review styling",
@@ -464,9 +665,14 @@
       ],
       "dependencies": [],
       "conflicts": [],
-      "platforms": ["claude-code", "cursor", "windsurf", "gemini-cli"],
+      "platforms": [
+        "claude-code",
+        "cursor",
+        "windsurf",
+        "gemini-cli"
+      ],
       "status": "ready",
-      "description": "Audit UI for Consistency, Accessibility, Responsive, and Performance."
+      "description": "Kiểm toán giao diện (UI) để đảm bảo tính nhất quán, khả năng truy cập (A11y), độ phản hồi (Responsive) và hiệu suất."
     },
     {
       "name": "qk-ui-system-builder",
@@ -477,7 +683,12 @@
       "behavior": "development",
       "intent": "implement-feature",
       "priority": "medium",
-      "tags": ["design-system", "tokens", "shared-components", "storybook"],
+      "tags": [
+        "design-system",
+        "tokens",
+        "shared-components",
+        "storybook"
+      ],
       "trigger": [
         "create a shared component",
         "extract color palette",
@@ -486,9 +697,14 @@
       ],
       "dependencies": [],
       "conflicts": [],
-      "platforms": ["claude-code", "cursor", "windsurf", "gemini-cli"],
+      "platforms": [
+        "claude-code",
+        "cursor",
+        "windsurf",
+        "gemini-cli"
+      ],
       "status": "ready",
-      "description": "Build and maintain Design Systems, Token extraction, and shared UI libraries."
+      "description": "Xây dựng và duy trì Design Systems, Token extraction, và các thư viện UI dùng chung."
     },
     {
       "name": "qk-validation-gate",
@@ -499,7 +715,13 @@
       "behavior": "validation",
       "intent": "validate",
       "priority": "critical",
-      "tags": ["ci", "testing", "linting", "security", "gatekeeper"],
+      "tags": [
+        "ci",
+        "testing",
+        "linting",
+        "security",
+        "gatekeeper"
+      ],
       "trigger": [
         "check the code",
         "run validation",
@@ -510,9 +732,14 @@
       ],
       "dependencies": [],
       "conflicts": [],
-      "platforms": ["claude-code", "cursor", "windsurf", "gemini-cli"],
+      "platforms": [
+        "claude-code",
+        "cursor",
+        "windsurf",
+        "gemini-cli"
+      ],
       "status": "ready",
-      "description": "Mandatory Quality Gate (Test, Lint, Security)."
+      "description": "Cổng kiểm tra chất lượng bắt buộc (Test, Lint, Security)."
     }
   ],
   "categories": {
@@ -520,7 +747,6 @@
       "qk-access-policy",
       "qk-context-loader",
       "qk-docs",
-      "qk-documentation-system",
       "qk-engineering-standard",
       "qk-help",
       "qk-orchestrator",
@@ -533,6 +759,7 @@
       "qk-ai-builder",
       "qk-api-lifecycle",
       "qk-data-lifecycle",
+      "qk-db-optimizer",
       "qk-design-to-code",
       "qk-feature-delivery",
       "qk-project-bootstrap",
@@ -565,4 +792,4 @@
     "readySkills": 22,
     "archivedSkills": 22
   }
-}
+}

package/skills/qk-documentation-system/SKILL.md

@@ -1,45 +0,0 @@
----
-name: qk-documentation-system
-version: 3.1.4
-updated: 2026-07-02
-description: Maintain system-level architecture docs and DevOps runbooks.
-category: documentation
-behavior: static-analysis
-intent: maintain
-priority: low
-tags: [architecture, diagrams, mermaid, runbooks]
-platforms: [claude-code, cursor, windsurf, gemini-cli]
-trigger: User asks to generate architecture diagrams or DevOps manuals.
-inputs: [Architecture changes]
-outputs: [System Docs, Mermaid Diagrams]
-allowed_tools: [write_to_file, read_file]
-pipeline: [analyze, design, implement, complete]
----
-
-# 🛠️ qk-documentation-system - Standard Operating Procedure
-
-> **Goal:** Quản lý tài liệu cấp hệ thống (System Architecture, Sequence Diagrams, Runbooks).
-
-## 🔄 1. Chain of Thought (SOP)
-
-1. **Analyze (System Flow):**
-   - Understand the flow of data across microservices or complex components.
-2. **Design (Diagramming):**
-   - Draft the sequence or architecture diagram using Mermaid syntax.
-3. **Implement (Drafting):**
-   - Save the documentation into the `/docs/` folder.
-
-## 🛡️ 2. Constraints & Rules
-
-- **Syntax Check:** Ensure Mermaid diagrams are syntactically valid before saving.
-
-## 🤝 3. Handoff Pipeline
-
-1. `complete`: Output the System Documentation Report.
-
-## 📝 4. Output Format
-
-Vui lòng trả kết quả bằng Tiếng Việt.
-
-- **Tóm tắt (Summary):** Tài liệu kiến trúc nào đã được tạo.
-- **Chi tiết (Changes):** Đường dẫn file.