---
name: auto-skill-builder
description: "Meta-skill tổng: Tự động phân tích yêu cầu → quét skill local → tìm trên skills.sh → đánh giá chất lượng → cài đặt hoặc tự build skill mới hoàn chỉnh. Hỗ trợ Skill Composition: kết hợp nhiều skill để tạo app/website hoàn chỉnh từ 1 yêu cầu duy nhất."
---

# 🧠 Auto Skill Builder — Hệ thống Quản lý Skill Tổng

Meta-skill trung tâm: quản lý toàn bộ vòng đời của skill — từ phát hiện yêu cầu, tìm kiếm, đánh giá, cài đặt, đến tự xây dựng skill mới khi chưa tồn tại. Hỗ trợ **Skill Composition**: kết hợp nhiều skill với nhau để tạo ứng dụng/website hoàn chỉnh từ 1 yêu cầu.

---

## Khi nào kích hoạt

**LUÔN LUÔN** kích hoạt skill này khi gặp **bất kỳ** tình huống nào sau:

1. User yêu cầu thực hiện công việc thuộc lĩnh vực chuyên biệt (WordPress, React, DevOps, AI...)
2. User nói "tìm skill", "có skill nào", "cần skill", "tạo skill"
3. User yêu cầu "làm sao để X" — nơi X cần kiến thức chuyên sâu
4. User muốn mở rộng khả năng của agent
5. Agent nhận ra mình thiếu kiến thức chuyên môn để hoàn thành tốt yêu cầu
6. User yêu cầu liệt kê, quản lý, hoặc xóa skill
7. **Dự án phức tạp** đòi hỏi kết hợp nhiều lĩnh vực (VD: "Tạo web khóa học WordPress có chatbot AI và thanh toán")

---

## Pipeline tổng — 7 Bước

```
┌──────────────────────────────────────────────────────────────┐
│  YÊU CẦU USER                                               │
│  "Tạo trang web WordPress khóa học"                          │
└──────────┬───────────────────────────────────────────────────┘
           │
           ▼
┌──────────────────────────────────────────────────────────────┐
│  BƯỚC 1: PHÂN TÍCH YÊU CẦU                                  │
│  → Domain: WordPress, LMS, Education                         │
│  → Task: Tạo website khóa học                                │
│  → Keywords: wordpress, lms, course                          │
└──────────┬───────────────────────────────────────────────────┘
           │
           ▼
┌──────────────────────────────────────────────────────────────┐
│  BƯỚC 2: QUÉT SKILL LOCAL (Có sẵn chưa?)                    │
│  → Scan ~/.gemini/antigravity/skills/                        │
│  → Tìm thấy wp-course-builder? → SỬ DỤNG NGAY (Bước 7)     │
│  → Không tìm thấy? → Tiếp Bước 3                            │
└──────────┬───────────────────────────────────────────────────┘
           │
           ▼
┌──────────────────────────────────────────────────────────────┐
│  BƯỚC 3: TÌM TRÊN SKILLS.SH                                 │
│  → Web: https://skills.sh/?q=wordpress                       │
│  → CLI: npx skills find wordpress lms                        │
│  → Kiểm tra nguồn uy tín (vercel-labs, anthropics...)        │
└──────────┬───────────────────────────────────────────────────┘
           │
           ▼
┌──────────────────────────────────────────────────────────────┐
│  BƯỚC 4: QUALITY GATE                                        │
│  → Installs > 100? Stars > 100? Source uy tín?               │
│  → ĐẠT → Bước 5 (Cài đặt)                                   │
│  → KHÔNG ĐẠT → Bước 6 (Tự Build)                            │
└──────────┬─────────────────────┬─────────────────────────────┘
           │                     │
    ĐẠT    ▼              KHÔNG ▼
┌──────────────────┐  ┌───────────────────────────────────────┐
│  BƯỚC 5: CÀI ĐẶT │  │  BƯỚC 6: TỰ BUILD SKILL MỚI          │
│  npx skills add   │  │  → Nghiên cứu best practices          │
│  -g -a antigravity│  │  → Tạo SKILL.md chuyên sâu            │
│  -y               │  │  → Tạo scripts/ resources/ nếu cần    │
└──────────┬────────┘  └──────────┬────────────────────────────┘
           │                      │
           ▼                      ▼
┌──────────────────────────────────────────────────────────────┐
│  BƯỚC 7: SỬ DỤNG SKILL                                      │
│  → Đọc SKILL.md bằng view_file (IsSkillFile: true)          │
│  → Follow hướng dẫn chính xác                                │
│  → Thực hiện yêu cầu ban đầu của user                       │
└──────────────────────────────────────────────────────────────┘
```

---

## Bước 1: Phân tích yêu cầu

Khi nhận yêu cầu, phân tích **3 yếu tố**:

| Yếu tố | Cách xác định | Ví dụ |
|---|---|---|
| **Domain** | Lĩnh vực kỹ thuật chính | WordPress, React, Python, DevOps, AI |
| **Task** | Hành động cụ thể cần làm | Tạo website, viết test, deploy app |
| **Keywords** | 2-3 từ khóa tiếng Anh để search | `wordpress lms`, `react testing` |

### Bảng mapping yêu cầu → keywords

| Yêu cầu user (tiếng Việt) | Keywords search |
|---|---|
| Tạo trang web WordPress | `wordpress theme` |
| Tạo web khóa học | `wordpress lms course` |
| Tối ưu React app | `react performance optimization` |
| Review code | `code review best-practices` |
| Viết test tự động | `testing automation playwright` |
| Deploy ứng dụng | `deployment ci-cd docker` |
| Thiết kế UI đẹp | `ui design system` |
| Tạo tài liệu API | `api documentation openapi` |
| Xây dựng chatbot AI | `ai chatbot langchain` |
| Tạo app mobile | `react-native mobile` |
| Tối ưu SEO | `seo optimization` |
| Bảo mật website | `security hardening` |

---

## Bước 2: Quét Skill Local ⚡ (Ưu tiên cao nhất)

**TRƯỚC KHI tìm online**, kiểm tra skill đã có sẵn trong hệ thống chưa.

### 2a. Scan thư mục skills

```
Đường dẫn: C:\Users\Admin\.gemini\antigravity\skills\
```

Dùng `list_dir` để liệt kê tất cả thư mục con. Mỗi thư mục là 1 skill.

### 2b. Matching logic

So sánh **tên thư mục** và **description trong SKILL.md** với keywords đã phân tích:

| Skill local | Keywords match |
|---|---|
| `wp-course-builder` | wordpress, course, lms, education |
| `auto-skill-builder` | skill, find, build (chính skill này) |

### 2c. Quyết định

- **Match chính xác** (tên skill chứa keyword) → Đọc SKILL.md, chuyển Bước 7
- **Match mờ** (liên quan nhưng không chắc) → Đọc SKILL.md để xác nhận, nếu phù hợp → Bước 7
- **Không match** → Tiếp Bước 3

### 2d. Cách đọc skill local

```
1. view_file trên SKILL.md (IsSkillFile: true)
2. Kiểm tra phần "Khi nào sử dụng" hoặc "Mục đích"
3. Nếu skill phù hợp yêu cầu → Follow hướng dẫn trong đó
```

---

## Bước 3: Tìm trên skills.sh

### 3a. Tìm bằng Web Scraping (read_url_content)

```
URL 1: https://skills.sh/                      # Leaderboard
URL 2: https://skills.sh/?q={keyword}           # Search
URL 3: https://skills.sh/{owner}/{repo}/{skill} # Chi tiết skill
```

### 3b. Nguồn uy tín — Kiểm tra trước

| Source | Lĩnh vực | Installs |
|---|---|---|
| `vercel-labs/agent-skills` | React, Next.js, web design, testing | 100K+ |
| `anthropics/skills` | Frontend, document processing | 100K+ |
| `ComposioHQ/awesome-claude-skills` | Đa dạng | Varies |
| `microsoft/*` | Enterprise, Azure, .NET | Varies |

### 3c. Tìm bằng CLI

```bash
npx -y skills find {keyword1} {keyword2}
```

**Chiến thuật tìm kiếm escalation:**
1. Từ khóa chính xác: `npx skills find wordpress lms`
2. Từ đồng nghĩa: `npx skills find education course`
3. Rộng hơn: `npx skills find wordpress`
4. Cụ thể hơn: `npx skills find wordpress theme development`

### 3d. Kết quả tìm kiếm

- **Tìm thấy skill** → Ghi lại: tên, source, installs, stars → Chuyển Bước 4
- **Không tìm thấy** → Thông báo user, chuyển Bước 6 (Tự Build)

---

## Bước 4: Quality Gate — Đánh giá chất lượng

**KHÔNG BAO GIỜ cài skill mà không kiểm tra trước.**

### Bảng đánh giá

| Tiêu chí | ✅ Đạt | ⚠️ Cảnh báo | ❌ Từ chối |
|---|---|---|---|
| Lượt cài đặt | > 1,000 | 100 - 1,000 | < 100 |
| Nguồn | vercel-labs, anthropics, microsoft | Org có uy tín | Cá nhân không rõ |
| GitHub Stars | > 500 | 100 - 500 | < 100 |
| Cập nhật gần nhất | < 3 tháng | 3-12 tháng | > 1 năm |
| SKILL.md quality | Chi tiết, có code mẫu | OK nhưng thiếu | Quá sơ sài |

### Quy tắc quyết định

- **≥ 3 tiêu chí ✅** → Tự động cài đặt, thông báo user
- **Mix ✅ và ⚠️** → Đề xuất cho user, hỏi ý kiến
- **Bất kỳ ❌ nào** → Bỏ qua, chuyển Bước 6 (Tự Build)
- **Không tìm thấy skill nào** → Bỏ qua, chuyển Bước 6

---

## Bước 5: Cài đặt Skill

### 5a. Lệnh cài đặt

```bash
npx -y skills add {owner/repo} --skill {skill-name} -g -a antigravity -y
```

**Flags:**
- `-g` : Global (user-level, dùng ở mọi project)
- `-a antigravity` : Cài cho Antigravity agent
- `-y` : Auto-confirm

### 5b. Xác nhận sau cài

```bash
npx -y skills list -g
```

Kiểm tra SKILL.md tồn tại tại:
```
C:\Users\Admin\.gemini\antigravity\skills\{skill-name}\SKILL.md
```

### 5c. Thông báo user

```
✅ Đã cài đặt skill "{skill-name}" từ {source}
📊 {installs} lượt cài | ⭐ {stars} stars
📖 https://skills.sh/{owner}/{repo}/{skill-name}

Skill đã sẵn sàng! Tiến hành thực hiện yêu cầu của bạn...
```

→ Chuyển Bước 7

---

## Bước 6: Tự Build Skill Mới 🔨

Khi **không tìm thấy skill phù hợp** hoặc **đều bị Quality Gate từ chối**.

### 6a. Quy trình build

```
1. Nghiên cứu     → search_web cho best practices của domain
2. Thiết kế       → Xác định cấu trúc skill (bước nào, template nào)
3. Viết SKILL.md  → Tạo file hoàn chỉnh
4. Tạo phụ trợ    → scripts/, resources/ nếu cần
5. Thông báo      → Báo user skill đã sẵn sàng
```

### 6b. Đường dẫn tạo skill

```
C:\Users\Admin\.gemini\antigravity\skills\{skill-name}\SKILL.md
```

Naming convention:
- Toàn chữ thường, dùng dấu `-` ngăn cách
- Mô tả rõ lĩnh vực: `wp-course-builder`, `react-optimizer`, `api-doc-generator`
- KHÔNG dùng: underscore, camelCase, chữ hoa

### 6c. Template SKILL.md chuẩn

```markdown
---
name: {skill-name}
description: "{Mô tả 1-2 câu: skill này giúp gì, dùng khi nào}"
---

# {Tên Skill — Tiêu đề rõ ràng}

{1 đoạn mô tả tổng quan}

## Khi nào sử dụng Skill này

- {Tình huống 1}
- {Tình huống 2}
- {Tình huống 3}

---

## Bước 1: {Tên bước}

### 1.1 {Chi tiết}
{Hướng dẫn cụ thể, actionable}

### 1.2 {Chi tiết}
{Code mẫu, lệnh cụ thể, template}

---

## Bước 2: {Tên bước}
...

---

## Bước N: {Tên bước cuối}
...

---

## Lưu ý quan trọng

1. {Best practice 1}
2. {Best practice 2}
3. {Edge case cần chú ý}
```

### 6d. Yêu cầu chất lượng cho skill tự build

| Tiêu chí | Bắt buộc |
|---|---|
| **Chuyên sâu** | Kiến thức chuyên môn thực sự, KHÔNG chung chung |
| **Actionable** | Mỗi bước là hành động agent có thể thực hiện ngay |
| **Có code/template** | Bao gồm code mẫu, config mẫu, lệnh cụ thể |
| **Có context VN** | Nếu liên quan (thanh toán, hosting VN...) |
| **Có edge cases** | Xử lý lỗi, cảnh báo, best practices |
| **≥ 5 bước** | Đủ chi tiết, không quá ít |
| **Research-backed** | Dựa trên search_web, không phải tự bịa |

### 6e. Tùy chọn: Thêm scripts/ và resources/

```
skills/{skill-name}/
├── SKILL.md                 # Hướng dẫn chính (BẮT BUỘC)
├── scripts/                 # Helper scripts (TÙY CHỌN)
│   ├── setup.sh
│   └── validate.py
└── resources/               # Templates, configs (TÙY CHỌN)
    ├── template.php
    └── config-sample.json
```

### 6f. Thông báo sau khi build

```
🔨 Đã tự build skill mới: "{skill-name}"
📁 Vị trí: C:\Users\Admin\.gemini\antigravity\skills\{skill-name}\SKILL.md
📋 Nội dung: {tóm tắt các bước chính}
📊 Kích thước: {X}KB

Skill đã sẵn sàng! Tiến hành thực hiện yêu cầu của bạn...
```

→ Chuyển Bước 7

---

## Bước 7: Sử dụng Skill

Sau khi có skill (tìm thấy local, cài từ skills.sh, hoặc tự build):

### 7a. Đọc SKILL.md

```
view_file(AbsolutePath: "C:\Users\Admin\.gemini\antigravity\skills\{skill-name}\SKILL.md", IsSkillFile: true)
```

### 7b. Follow hướng dẫn

- Đọc từ đầu đến cuối
- Thực hiện từng bước theo thứ tự
- Áp dụng cho yêu cầu cụ thể của user

### 7c. Báo cáo kết quả

Khi hoàn thành, tạo artifact tổng kết nếu task lớn.

---

## Quản lý Skill — Các lệnh hữu ích

### Liệt kê skill đã cài

```bash
# Local skills
ls C:\Users\Admin\.gemini\antigravity\skills\

# CLI list
npx -y skills list -g
```

### Xóa skill

```bash
# Xóa thủ công
rm -rf C:\Users\Admin\.gemini\antigravity\skills\{skill-name}

# CLI remove
npx -y skills remove {skill-name} -g -a antigravity
```

### Cập nhật skill

```bash
npx -y skills add {owner/repo} --skill {skill-name} -g -a antigravity -y --force
```

---

## 🔗 Skill Composition — Kết hợp nhiều Skill

Khi user yêu cầu tạo **dự án hoàn chỉnh** đòi hỏi nhiều lĩnh vực (VD: web + AI + thanh toán), thay vì dùng 1 skill, hệ thống sẽ kết hợp nhiều skill lại với nhau.

### Khi nào kích hoạt Composition

Phát hiện dự án **multi-domain** khi yêu cầu user chứa:
- **≥ 2 domain khác nhau** (VD: WordPress + AI, React + Payment + Auth)
- **Từ khóa tổ hợp**: "tạo app", "xây dựng hệ thống", "tạo nền tảng", "tạo trang web có..."
- **Liệt kê nhiều tính năng**: "...có chatbot, thanh toán, quản lý user"

### Quy trình Composition

```
┌──────────────────────────────────────────────────────────────────┐
│  YÊU CẦU: "Tạo web khóa học WP có chatbot AI và thanh toán"    │
└──────────┬───────────────────────────────────────────────────────┘
           │
           ▼
┌──────────────────────────────────────────────────────────────────┐
│  C1: PHÂN RÃ YÊU CẦU (Decompose)                               │
│  ┌─────────────┐  ┌─────────────┐  ┌──────────────────┐         │
│  │ Sub-task 1   │  │ Sub-task 2   │  │ Sub-task 3        │       │
│  │ WP Course    │  │ AI Chatbot   │  │ Payment Gateway   │       │
│  │ Site         │  │              │  │                   │       │
│  └──────┬──────┘  └──────┬──────┘  └────────┬──────────┘        │
│         │                │                   │                   │
└─────────┼────────────────┼───────────────────┼───────────────────┘
          │                │                   │
          ▼                ▼                   ▼
┌──────────────────────────────────────────────────────────────────┐
│  C2: RESOLVE SKILLS (Tìm skill cho từng sub-task)               │
│  ┌─────────────┐  ┌─────────────┐  ┌──────────────────┐         │
│  │ ✅ Local:    │  │ ❌ Không có  │  │ ❌ Không có       │       │
│  │ wp-course-  │  │ → Build mới  │  │ → Build mới       │       │
│  │ builder     │  │ ai-chatbot   │  │ payment-gateway   │       │
│  └──────┬──────┘  └──────┬──────┘  └────────┬──────────┘        │
│         │                │                   │                   │
└─────────┼────────────────┼───────────────────┼───────────────────┘
          │                │                   │
          ▼                ▼                   ▼
┌──────────────────────────────────────────────────────────────────┐
│  C3: EXECUTION PLAN (Lên kế hoạch thực thi)                     │
│                                                                  │
│  Phase 1: [wp-course-builder] → Tạo theme + cấu trúc base       │
│  Phase 2: [payment-gateway]   → Tích hợp thanh toán vào theme   │
│  Phase 3: [ai-chatbot]        → Thêm chatbot widget              │
│  Phase 4: Integration Test    → Kiểm tra tổng thể               │
│                                                                  │
└──────────┬───────────────────────────────────────────────────────┘
           │
           ▼
┌──────────────────────────────────────────────────────────────────┐
│  C4: THỰC THI TUẦN TỰ                                           │
│  → Đọc từng skill → Follow hướng dẫn → Tích hợp vào dự án      │
│  → Đảm bảo các phần không conflict với nhau                     │
└──────────────────────────────────────────────────────────────────┘
```

### C1: Phân rã yêu cầu (Decompose)

Khi phát hiện yêu cầu multi-domain:

1. **Liệt kê tất cả thành phần** cần thiết
2. **Nhóm theo domain** — mỗi nhóm = 1 sub-task
3. **Xác định dependencies** — thứ tự thực hiện

**Bảng phân rã mẫu:**

| Yêu cầu user | Sub-tasks | Skills cần |
|---|---|---|
| "Web khóa học WP có chatbot" | WP Theme, LMS, Chatbot | `wp-course-builder` + `ai-chatbot` |
| "App quản lý có auth + dashboard" | Auth, Dashboard UI, API | `auth-system` + `dashboard-builder` + `api-builder` |
| "Ecommerce React có thanh toán VN" | React app, Payment, SEO | `react-app` + `vn-payment` + `seo-optimizer` |
| "Tool tạo video AI có license" | Video gen, License system, UI | `ai-video-tool` + `license-system` + `desktop-app` |

### C2: Resolve Skills

Với mỗi sub-task, chạy pipeline chuẩn (Bước 2→3→4→5/6):

```
FOR EACH sub_task IN sub_tasks:
    1. Scan local skills → match?
       YES → Đánh dấu ✅ "resolved"
       NO  → Continue
    2. Tìm skills.sh → Quality Gate → pass?
       YES → Cài đặt → Đánh dấu ✅ "resolved"
       NO  → Continue
    3. Tự build skill mới → Đánh dấu ✅ "resolved"
END FOR
```

**Kết quả**: Tất cả sub-tasks đều có skill tương ứng.

### C3: Execution Plan

Sau khi resolve tất cả skills, tạo kế hoạch thực thi:

#### Quy tắc sắp xếp thứ tự

| Ưu tiên | Loại task | Lý do |
|---|---|---|
| **Phase 1** | Foundation (theme, project setup, DB) | Mọi thứ khác build trên này |
| **Phase 2** | Core features (auth, CRUD, business logic) | Tính năng chính |
| **Phase 3** | Integrations (payment, 3rd party API) | Cần core hoạt động trước |
| **Phase 4** | Enhancements (chatbot, analytics, SEO) | Bổ sung, không blocking |
| **Phase 5** | Polish (UI tuning, testing, deploy) | Hoàn thiện cuối |

#### Dependency Matrix

Xác định skill nào phụ thuộc skill nào:

```
Skill A [foundation] ─── không phụ thuộc gì
Skill B [auth]       ─── phụ thuộc A (cần project base)
Skill C [payment]    ─── phụ thuộc A + B (cần auth)
Skill D [chatbot]    ─── phụ thuộc A (chỉ cần base)
```

→ Thứ tự: A → B → (C, D song song nếu có thể) → Polish

#### Output: Execution Plan artifact

Tạo artifact `.md` trình bày kế hoạch:

```markdown
# 📋 Execution Plan: {Tên dự án}

## Skills sử dụng
| # | Skill | Nguồn | Vai trò |
|---|---|---|---|
| 1 | wp-course-builder | Local | Foundation + LMS |
| 2 | payment-gateway | Build mới | Thanh toán VN |
| 3 | ai-chatbot | Build mới | Hỗ trợ học viên |

## Kế hoạch thực thi
- Phase 1: [wp-course-builder] — Tạo theme, cấu trúc, LMS
- Phase 2: [payment-gateway] — Tích hợp VNPay, MoMo
- Phase 3: [ai-chatbot] — Widget chatbot hỗ trợ
- Phase 4: Tích hợp + kiểm tra tổng thể
```

**Trình bày plan cho user** → Hỏi xác nhận trước khi thực thi.

### C4: Thực thi tuần tự

Sau khi user xác nhận plan:

```
FOR EACH phase IN execution_plan:
    1. Đọc SKILL.md (view_file, IsSkillFile: true)
    2. Follow hướng dẫn trong skill
    3. Áp dụng vào DỰ ÁN CHUNG (cùng thư mục, cùng codebase)
    4. Kiểm tra không conflict với phases trước
    5. Báo cáo tiến trình cho user
END FOR
```

#### Quy tắc tích hợp giữa các skill

| Tình huống | Cách xử lý |
|---|---|
| 2 skill cùng sửa `functions.php` | Merge code, không ghi đè |
| 2 skill cùng thêm CSS | Tạo file CSS riêng cho mỗi module |
| Skill mới cần hook vào skill cũ | Dùng WordPress hooks/filters hoặc event system |
| Conflict tên function/class | Thêm prefix theo skill (`goveoai_chat_`, `goveoai_pay_`) |
| Shared dependencies | Cài 1 lần, dùng chung (VD: jQuery, React) |

### C5: Integration Checklist

Sau khi tất cả phases hoàn thành:

- [ ] Tất cả skills đã thực thi thành công
- [ ] Không có lỗi PHP/JS trên trang
- [ ] Các module tương tác đúng (VD: auth → course access)
- [ ] Responsive trên mobile
- [ ] Tạo artifact tổng kết dự án

### Ví dụ Composition thực tế

#### Ví dụ 1: "Tạo nền tảng khóa học có AI assistant"

```
Phân rã:
├── Sub-task 1: WordPress Course Site → wp-course-builder ✅ (local)
├── Sub-task 2: AI Chatbot Widget     → ai-chatbot (build mới)
└── Sub-task 3: Analytics Dashboard   → analytics-dashboard (build mới)

Execution:
  Phase 1: wp-course-builder → Theme + LMS + Auth + Video
  Phase 2: ai-chatbot        → Thêm widget vào footer.php
  Phase 3: analytics-dashboard → Admin page tracking
  Phase 4: Integration test
```

#### Ví dụ 2: "Tạo tool desktop bán hàng có license"

```
Phân rã:
├── Sub-task 1: Desktop App (Electron/PyQt) → desktop-app-builder (build)
├── Sub-task 2: License System              → license-system (build)
└── Sub-task 3: Auto-update                 → auto-updater (build)

Execution:
  Phase 1: desktop-app-builder → UI + core logic
  Phase 2: license-system      → Activation + Supabase
  Phase 3: auto-updater        → Update mechanism
  Phase 4: Build installer + test
```

#### Ví dụ 3: "Tạo SaaS web app React + API + thanh toán"

```
Phân rã:
├── Sub-task 1: React Frontend  → react-saas-frontend (build)
├── Sub-task 2: REST API        → api-builder (build)
├── Sub-task 3: Auth System     → auth-jwt (build)
└── Sub-task 4: Payment         → vn-payment (build)

Execution:
  Phase 1: api-builder         → Express/Fastify + DB schema
  Phase 2: auth-jwt            → JWT + Google OAuth
  Phase 3: react-saas-frontend → UI + connect API
  Phase 4: vn-payment          → Stripe/VNPay integration
  Phase 5: Deploy + test
```

---

## Registry — Skill đã có trong hệ thống

> **Cập nhật tự động**: Mỗi khi build hoặc cài skill mới, thêm vào bảng dưới.

| Skill | Mô tả | Nguồn | Ngày tạo |
|---|---|---|---|
| `auto-skill-builder` | Meta-skill: Tìm, build, compose skill tự động | Self-built | 2026-04-05 |
| `wp-course-builder` | WordPress course website builder | Self-built | 2026-04-05 |

---

## Xử lý lỗi & Edge Cases

### CLI không hoạt động
1. Kiểm tra Node.js: `node --version` (cần ≥ 18)
2. Kiểm tra npm: `npm --version`
3. Thử: `npx -y skills find {query}`
4. Fallback: Tìm trực tiếp trên https://skills.sh bằng `read_url_content`

### Skill cài nhưng không nhận
1. Xác nhận file tồn tại: `C:\Users\Admin\.gemini\antigravity\skills\{name}\SKILL.md`
2. Kiểm tra YAML frontmatter hợp lệ (phải có `name` và `description`)
3. Nếu thiếu, copy thủ công vào đúng vị trí

### Yêu cầu quá mơ hồ
Nếu user nói quá chung (VD: "giúp tôi code tốt hơn"):
1. Hỏi: "Bạn muốn cải thiện về mặt nào? (performance, testing, design...)"
2. Đề xuất 2-3 skill phổ biến liên quan
3. Để user chọn → Tiếp pipeline

### Skill trùng lặp
Nếu tìm thấy nhiều skill cùng domain:
1. So sánh chất lượng (installs, stars, detail level)
2. Chọn tốt nhất, bỏ phần còn lại
3. KHÔNG cài 2 skill cùng mục đích

---

## Quy tắc vàng

1. **Scan local trước, tìm online sau** — Skill đã có thì dùng ngay, đừng tìm lại
2. **Một yêu cầu = Một kết quả** — User chỉ cần nói 1 câu, pipeline lo tất cả
3. **Ưu tiên skill có sẵn > Tự build** — Tránh phát minh lại bánh xe
4. **Chất lượng trên hết** — Skill kém còn tệ hơn không có
5. **Tự động nhưng minh bạch** — Luôn thông báo đang làm gì, kết quả ra sao
6. **Skill tự build phải PRO** — Research trước, viết chi tiết, có code mẫu
7. **Luôn sử dụng skill ngay** — Sau khi tìm/build xong → thực hiện yêu cầu user ngay (Bước 7)
8. **Composition trước khi code** — Dự án lớn → Phân rã → Resolve skills → Plan → Xác nhận user → Thực thi
9. **Merge không ghi đè** — Khi nhiều skill cùng chỉnh 1 file, MERGE code chứ đừng overwrite
10. **Plan trước, code sau** — Dự án multi-skill phải có artifact Execution Plan được user approve