opencode-skills-collection 3.1.6 → 3.1.8

package/bundled-skills/docs/users/usage.md

@@ -14,7 +14,7 @@ If you came in through a **Claude Code** or **Codex** plugin instead of a full l
 
 When you ran `npx antigravity-awesome-skills` or cloned the repository, you:
 
-✅ **Downloaded 1,681+ skill files** to your computer (default: `~/.agents/skills/`; or a custom path like `~/.agent/skills/` if you used `--path`)
+✅ **Downloaded 1,689+ skill files** to your computer (default: `~/.agents/skills/`; or a custom path like `~/.agent/skills/` if you used `--path`)
 ✅ **Made them available** to your AI assistant  
 ❌ **Did NOT enable them all automatically** (they're just sitting there, waiting)
 
@@ -34,7 +34,7 @@ Bundles are **curated groups** of skills organized by role. They help you decide
 
 **Analogy:**
 
-- You installed a toolbox with 1,681+ tools (✅ done)
+- You installed a toolbox with 1,689+ tools (✅ done)
 - Bundles are like **labeled organizer trays** saying: "If you're a carpenter, start with these 10 tools"
 - You can either **pick skills from the tray** or install that tray as a focused marketplace bundle plugin
 
@@ -212,7 +212,7 @@ Let's actually use a skill right now. Follow these steps:
 
 ## Step 5: Picking Your First Skills (Practical Advice)
 
-Don't try to use all 1,681+ skills at once. Here's a sensible approach:
+Don't try to use all 1,689+ skills at once. Here's a sensible approach:
 
 If you want a tool-specific starting point before choosing skills, use:
 
@@ -343,7 +343,7 @@ Usually no, but if your AI doesn't recognize a skill:
 
 ### "Can I load all skills into the model at once?"
 
-No. Even though you have 1,681+ skills installed locally, you should **not** concatenate every `SKILL.md` into a single system prompt or context block.
+No. Even though you have 1,689+ skills installed locally, you should **not** concatenate every `SKILL.md` into a single system prompt or context block.
 
 The intended pattern is:
 

package/bundled-skills/docs/users/visual-guide.md

@@ -34,7 +34,7 @@ antigravity-awesome-skills/
 ├── 📄 CONTRIBUTING.md                  ← Contributor workflow
 ├── 📄 CATALOG.md                       ← Full generated catalog
 │
-├── 📁 skills/                          ← 1,681+ skills live here
+├── 📁 skills/                          ← 1,689+ skills live here
 │   │
 │   ├── 📁 brainstorming/
 │   │   └── 📄 SKILL.md                 ← Skill definition
@@ -47,7 +47,7 @@ antigravity-awesome-skills/
 │   │   └── 📁 2d-games/
 │   │       └── 📄 SKILL.md             ← Nested skills also supported
 │   │
-│   └── ... (1,681+ total)
+│   └── ... (1,689+ total)
 │
 ├── 📁 apps/
 │   └── 📁 web-app/                     ← Interactive browser
@@ -100,7 +100,7 @@ antigravity-awesome-skills/
 
 ```
                     ┌─────────────────────────┐
-                    │  1,681+ SKILLS          │
+                    │  1,689+ SKILLS          │
                     └────────────┬────────────┘
                                  │
         ┌────────────────────────┼────────────────────────┐
@@ -201,7 +201,7 @@ If you want a workspace-style manual install instead, cloning into `.agent/skill
 │   ├── 📁 brainstorming/                 │
 │   ├── 📁 stripe-integration/            │
 │   ├── 📁 react-best-practices/          │
-│   └── ... (1,681+ total)                │
+│   └── ... (1,689+ total)                │
 └─────────────────────────────────────────┘
 ```
 

package/bundled-skills/docs/vietnamese/BUNDLES.vi.md

@@ -121,4 +121,4 @@ _Để tạo ra những trải nghiệm hoàn hảo đến từng pixel._
 
 ---
 
-_Để sử dụng một gói kỹ năng, chỉ cần copy tên các skill vào thư mục `.agent/skills` của bạn hoặc yêu cầu trợ lý AI sử dụng chúng._
+_Để sử dụng một gói kỹ năng, hãy cài repository một lần bằng `npx antigravity-awesome-skills`, rồi yêu cầu trợ lý AI sử dụng các skill được liệt kê trong gói._

package/bundled-skills/docs/vietnamese/CONTRIBUTING.vi.md

@@ -1,15 +1,15 @@
-# 🤝 Hướng dẫn Đóng góp - Phiên bản V3 Enterprise
+# 🤝 Hướng dẫn Đóng góp
 
 **Cảm ơn bạn đã muốn làm cho repository này trở nên tốt hơn!** Hướng dẫn này sẽ chỉ cho bạn chính xác cách thức đóng góp, ngay cả khi bạn là người mới đối với mã nguồn mở.  
-Với phiên bản V3, chúng tôi đã nâng cao các tiêu chuẩn về chất lượng. Vui lòng đọc kỹ **Tiêu chuẩn Chất lượng mới** bên dưới.
+Chúng tôi duy trì tiêu chuẩn chất lượng tự động cho skill và tài liệu. Vui lòng đọc kỹ **Quality Bar** bên dưới.
 
 ---
 
-## 🧐 "Quy chuẩn Chất lượng" (Quality Bar - Tiêu chuẩn V3)
+## 🧐 "Quy chuẩn Chất lượng" (Quality Bar)
 
-**Quan trọng đối với các skill mới:** Mỗi skill được gửi đi phải vượt qua **5 bước Kiểm tra Chất lượng** (xem `docs/vietnamese/QUALITY_BAR.md` để biết chi tiết):
+**Quan trọng đối với các skill mới:** Mỗi skill được gửi đi phải vượt qua **5 bước Kiểm tra Chất lượng** (xem `docs/vietnamese/QUALITY_BAR.vi.md` để biết chi tiết):
 
-1.  **Siêu dữ liệu (Metadata)**: Phần Frontmatter chính xác (`name`, `description`).
+1.  **Siêu dữ liệu (Metadata)**: Phần frontmatter chính xác (`name`, `description`, `category`, `risk`, `source`, `date_added`; thêm `source_repo` và `source_type` cho skill bắt nguồn từ GitHub bên ngoài).
 2.  **An toàn (Safety)**: Không chứa các lệnh gây hại mà không có nhãn rủi ro ("Risk").
 3.  **Rõ ràng (Clarity)**: Có phần "Khi nào nên dùng" (When to use) rõ ràng.
 4.  **Ví dụ (Examples)**: Ít nhất một ví dụ sử dụng có thể sao chép và dùng được ngay.
@@ -81,6 +81,9 @@ Mỗi kỹ năng đều cần cấu trúc cơ bản này. **Hãy sao chép mẫu
 ---
 name: my-awesome-skill
 description: "Mô tả ngắn gọn về chức năng của skill này"
+risk: safe
+source: community
+date_added: 2026-06-25
 ---
 
 # Tiêu đề Skill
@@ -112,16 +115,16 @@ code ví dụ ở đây
 - ❌ Không nên làm điều này
 ```
 
-#### Bước 4: Xác thực (BƯỚC V3 QUAN TRỌNG)
+#### Bước 4: Xác thực
 
 Chạy script xác thực (validation) tại máy của bạn. **Chúng tôi sẽ không chấp nhận các Pull Request (PR) thất bại ở bước kiểm tra này.**
 
 ```bash
-# Chế độ nhẹ (chỉ cảnh báo)
-python3 scripts/validate_skills.py
+# Chế độ thông thường
+npm run validate
 
 # Chế độ nghiêm ngặt (chế độ mà hệ thống CI sẽ chạy)
-python3 scripts/validate_skills.py --strict
+npm run validate:strict
 ```
 
 Bước này sẽ kiểm tra:
@@ -149,6 +152,9 @@ Tiết kiệm thời gian! Hãy sao chép bản mẫu này:
 ---
 name: your-skill-name
 description: "Mô tả trong một câu về chức năng của skill và khi nào cần dùng"
+risk: safe
+source: community
+date_added: 2026-06-25
 ---
 
 # Tên Kỹ năng của bạn

package/bundled-skills/docs/vietnamese/FAQ.vi.md

@@ -11,9 +11,9 @@
 Skills là các tệp hướng dẫn chuyên biệt dạy cho các trợ lý AI cách xử lý những tác vụ cụ thể. Hãy coi chúng như những mô-đun kiến thức chuyên gia mà AI của bạn có thể tải khi cần.  
 **Một so sánh đơn giản:** Giống như việc bạn tham khảo ý kiến của các chuyên gia khác nhau (luật sư, bác sĩ, thợ máy), những kỹ năng này giúp AI của bạn trở thành chuyên gia trong các lĩnh vực khác nhau khi bạn cần.
 
-### Tôi có cần phải cài đặt tất cả hơn 560 skills không?
+### Tôi có cần phải cài đặt tất cả hơn 1,684 skills không?
 
-**Không!** Khi bạn clone (tải bản sao) repository này, tất cả các kỹ năng đều có sẵn, nhưng AI của bạn chỉ tải chúng khi bạn yêu cầu rõ ràng bằng lệnh `@ten-skill`.  
+**Không!** Khi bạn cài đặt repository này, tất cả các kỹ năng đều có sẵn, nhưng AI của bạn chỉ tải chúng khi bạn yêu cầu rõ ràng bằng lệnh `@ten-skill`.
 Nó giống như việc sở hữu một thư viện - tất cả sách đều ở đó, nhưng bạn chỉ đọc những cuốn bạn cần thôi.  
 **Mẹo:** Sử dụng [Bản mẫu Khởi đầu (Starter Packs)](BUNDLES.vi.md) để chỉ cài đặt những gì phù hợp với vai trò của bạn.
 
@@ -41,15 +41,17 @@ Bản thân các file skill được lưu trữ cục bộ trên máy tính củ
 
 ---
 
-## 🔒 Bảo mật & Tin cậy (Cập nhật V4)
+## 🔒 Bảo mật & Tin cậy
 
 ### Các Nhãn rủi ro (Risk Labels) có ý nghĩa gì?
 
-Chúng tôi phân loại các kỹ năng để bạn biết mình đang chạy cái gì:
+Chúng tôi phân loại các kỹ năng để bạn biết mình đang chạy cái gì. Các giá trị này khớp trực tiếp với trường `risk:` trong frontmatter của mỗi `SKILL.md`:
 
-- ⚪ **Safe (Trắng/Xanh)**: Các kỹ năng chỉ đọc, lập kế hoạch hoặc vô hại.
-- 🔴 **Risk (Đỏ)**: Các kỹ năng sửa đổi file (xóa), sử dụng công cụ quét mạng, hoặc thực hiện các hành động có tính phá hủy. **Hãy sử dụng thận trọng.**
-- 🟣 **Official (Tím)**: Được duy trì bởi các nhà cung cấp tin cậy (Anthropic, DeepMind, v.v.).
+- ⚪ **`unknown`**: Nội dung cũ hoặc chưa được phân loại. Hãy xem xét skill thủ công trước khi dùng.
+- 🟢 **`none`**: Nội dung tham khảo hoặc lập kế hoạch thuần túy; không có lệnh shell, thay đổi trạng thái hoặc truy cập mạng.
+- 🔵 **`safe`**: Hướng dẫn không phá hủy như lệnh chỉ đọc, lập kế hoạch, review code hoặc phân tích.
+- 🟠 **`critical`**: Skill sửa đổi file, xóa dữ liệu, dùng công cụ quét mạng hoặc thực hiện hành động có thể phá hủy. **Hãy sử dụng thận trọng.**
+- 🔴 **`offensive`**: Kỹ thuật tấn công bảo mật như pentesting hoặc khai thác. **Chỉ dùng khi được cấp phép** và luôn xác nhận mục tiêu nằm trong phạm vi cho phép.
 
 ### Những kỹ năng này có thể hack máy tính của tôi không?
 
@@ -62,35 +64,43 @@ _Luôn kiểm tra nhãn rủi ro và xem xét mã nguồn trước khi dùng._
 
 ### Tôi nên cài đặt các kỹ năng này ở đâu?
 
-Đường dẫn phổ biến nhất hoạt động với mạng lưới các công cụ AI là `.agent/skills/`:
+Đường dẫn mặc định của installer là `~/.agents/skills/` cho Antigravity global:
 
 ```bash
-git clone https://github.com/sickn33/antigravity-awesome-skills.git .agent/skills
+npx antigravity-awesome-skills
 ```
 
 **Các đường dẫn cụ thể cho từng công cụ:**
 
 - Claude Code: `.claude/skills/`
 - Gemini CLI: `.gemini/skills/`
-- Cursor: `.cursor/skills/` hoặc gốc của dự án.
+- Codex CLI: `.codex/skills/`
+- Kiro CLI / IDE: `~/.kiro/skills/` hoặc `.kiro/skills/`
+- Antigravity: `~/.agents/skills/` hoặc `.agent/skills/`
+- Antigravity CLI (`agy`): `~/.gemini/antigravity-cli/skills/`
+- Cursor: `.cursor/skills/`
+- OpenCode: `.agents/skills/`
+- AdaL CLI: `.adal/skills/`
 
 ### Repo này có hoạt động trên Windows không?
 
-**Có**, nhưng một số kỹ năng "Official" (chính thức) sử dụng **symlinks** (liên kết tượng trưng) mà Windows xử lý không tốt theo mặc định.  
-Hãy chạy git clone với lệnh sau:
+**Có.** Hãy dùng lệnh cài đặt chuẩn:
 
 ```bash
-git clone -c core.symlinks=true https://github.com/sickn33/antigravity-awesome-skills.git .agent/skills
+npx antigravity-awesome-skills
 ```
 
-Hoặc bật "Chế độ Nhà phát triển" (Developer Mode) trong phần Cài đặt của Windows.
+Không còn cần workaround cũ `core.symlinks=true` hoặc bật Developer Mode chỉ để cài repository này.
 
 ### Làm thế nào để cập nhật các kỹ năng?
 
-Chuyển hướng đến thư mục chứa kỹ năng của bạn và kéo (pull) những thay đổi mới nhất:
+Chạy lại installer để lấy phiên bản mới nhất, hoặc nếu bạn cài bằng git clone thì pull trong thư mục đã clone:
 
 ```bash
-cd .agent/skills
+npx antigravity-awesome-skills
+
+# hoặc, nếu bạn tự clone repository:
+cd ~/.agents/skills
 git pull origin main
 ```
 
@@ -128,7 +138,7 @@ Sử dụng biểu tượng `@` theo sau là tên skill:
 
 **Các nguyên nhân có thể xảy ra:**
 
-1. **Sai đường dẫn cài đặt**: Kiểm tra tài liệu hướng dẫn của công cụ bạn dùng. Hãy thử `.agent/skills/`.
+1. **Sai đường dẫn cài đặt**: Kiểm tra tài liệu hướng dẫn của công cụ bạn dùng. Hãy thử installer mặc định `~/.agents/skills/` hoặc cờ theo công cụ phù hợp.
 2. **Cần khởi động lại**: Khởi động lại AI/IDE sau khi cài đặt.
 3. **Lỗi đánh máy**: Bạn có gõ lầm `@brain-storming` thay vì `@brainstorming` không?
 
@@ -156,15 +166,15 @@ Hãy xem [CONTRIBUTING.md](../../CONTRIBUTING.md) để biết hướng dẫn ch
 
 ### Pull Request (PR) của tôi thất bại khi kiểm tra "Quality Bar". Tại sao?
 
-Phiên bản V3 áp dụng kiểm soát chất lượng tự động. Skill của bạn có thể đang thiếu:
+Quality Bar áp dụng kiểm soát chất lượng tự động. Skill của bạn có thể đang thiếu:
 
 1. Một `description` (mô tả) hợp lệ.
 2. Các ví dụ sử dụng.  
-Hãy chạy `python3 scripts/validate_skills.py` cục bộ để kiểm tra trước khi đẩy code lên.
+Hãy chạy `npm run validate` cục bộ để kiểm tra trước khi đẩy code lên.
 
 ### Tôi có thể cập nhật các kỹ năng "Official" không?
 
-**Không.** Các kỹ năng chính thức (trong thư mục `skills/official/`) được đồng bộ từ các nhà cung cấp. Thay vào đó, hãy mở một issue để báo lỗi.
+**Không trực tiếp.** Các skill nhập từ nguồn bên ngoài được phân biệt bằng frontmatter như `source`, `source_repo` và `source_type`. Nếu một skill bắt nguồn từ nhà cung cấp hoặc repository khác, hãy mở issue hoặc PR nhỏ kèm nguồn rõ ràng thay vì sửa tùy tiện.
 
 ---
 

package/bundled-skills/docs/vietnamese/GETTING_STARTED.vi.md

@@ -1,4 +1,4 @@
-# Hướng dẫn Bắt đầu với Antigravity Awesome Skills (V4)
+# Hướng dẫn Bắt đầu với Antigravity Awesome Skills (V13.2.0)
 
 **Bạn mới đến đây? Hướng dẫn này sẽ giúp bạn tăng cường sức mạnh cho trợ lý trợ lý AI của mình chỉ trong 5 phút.**
 
@@ -6,7 +6,7 @@
 
 ## 🤔 "Skills" (Kỹ năng) là gì?
 
-Các trợ lý AI (như **Claude Code**, **Gemini**, **Cursor**) rất thông minh, nhưng chúng thiếu kiến thức cụ thể về các công cụ và quy trình làm việc của bạn.  
+Các trợ lý AI (như **Claude Code**, **Codex CLI**, **Gemini CLI**, **Cursor**, **Antigravity**, **Kiro** và **OpenCode**) rất thông minh, nhưng chúng thiếu kiến thức cụ thể về các công cụ và quy trình làm việc của bạn.
 **Skills** là các hướng dẫn sử dụng chuyên biệt (dưới dạng file markdown) dạy cho AI của bạn cách thực hiện các tác vụ cụ thể một cách hoàn hảo trong mọi lần thực hiện.
 
 **Một phép so sánh:** AI của bạn là một thực tập sinh xuất sắc. **Skills** là các SOP (Quy trình vận hành tiêu chuẩn) biến họ thành một Kỹ sư cao cấp.
@@ -15,18 +15,19 @@ Các trợ lý AI (như **Claude Code**, **Gemini**, **Cursor**) rất thông mi
 
 ## ⚡️ Khởi động nhanh: Các "Gói khởi đầu" (Starter Packs)
 
-Đừng lo lắng về con số hơn 560 kỹ năng. Bạn không cần dùng tất cả chúng cùng một lúc.  
+Đừng lo lắng về con số hơn 1,684 kỹ năng. Bạn không cần dùng tất cả chúng cùng một lúc.
 Chúng tôi đã tuyển chọn các **Gói khởi đầu** để bạn có thể bắt đầu sử dụng ngay lập tức.
 
 ### 1. Cài đặt Repository
 
-Sao chép các kỹ năng vào thư mục agent của bạn:
+Khuyến nghị dùng installer CLI. Mặc định, lệnh này cài vào `~/.agents/skills` cho Antigravity global:
 
 ```bash
-# Cài đặt phổ thông (hoạt động với hầu hết các agent)
-git clone https://github.com/sickn33/antigravity-awesome-skills.git .agent/skills
+npx antigravity-awesome-skills
 ```
 
+Bạn cũng có thể dùng cờ theo công cụ, ví dụ `--claude`, `--gemini`, `--codex`, `--cursor`, `--kiro`, `--antigravity`, `--agy`, hoặc `--path <dir>` để chọn thư mục đích.
+
 ### 2. Chọn vai trò của bạn
 
 Tìm gói kỹ năng phù hợp với vị trí của bạn (xem [BUNDLES.md](BUNDLES.vi.md)):
@@ -68,21 +69,28 @@ Sau khi cài đặt, bạn chỉ cần trò chuyện với AI một cách tự n
 
 | Công cụ          | Trạng thái      | Đường dẫn         |
 | :--------------- | :-------------- | :---------------- |
-| **Claude Code**  | ✅ Hỗ trợ đầy đủ | `.claude/skills/` |
+| **Claude Code**  | ✅ Hỗ trợ đầy đủ | `.claude/skills/` hoặc Claude plugin marketplace |
 | **Gemini CLI**   | ✅ Hỗ trợ đầy đủ | `.gemini/skills/` |
-| **Antigravity**  | ✅ Hỗ trợ gốc   | `.agent/skills/`  |
+| **Codex CLI**    | ✅ Hỗ trợ đầy đủ | `.codex/skills/` |
+| **Kiro CLI / IDE** | ✅ Hỗ trợ đầy đủ | `~/.kiro/skills/` hoặc `.kiro/skills/` |
+| **Antigravity**  | ✅ Hỗ trợ gốc   | `~/.agents/skills/` hoặc `.agent/skills/` |
+| **Antigravity CLI (`agy`)** | ✅ Hỗ trợ đầy đủ | `~/.gemini/antigravity-cli/skills/` |
 | **Cursor**       | ✅ Hỗ trợ gốc   | `.cursor/skills/` |
+| **OpenCode**     | ✅ Hỗ trợ đầy đủ | `.agents/skills/` |
+| **AdaL CLI**     | ✅ Hỗ trợ đầy đủ | `.adal/skills/` |
 | **Copilot**      | ⚠️ Chỉ văn bản  | Copy-paste thủ công |
 
 ---
 
-## 🛡️ Sự tin cậy & An toàn (Mới trong bản V4)
+## 🛡️ Sự tin cậy & An toàn
 
-Chúng tôi phân loại các kỹ năng để bạn biết mình đang chạy những gì:
+Chúng tôi phân loại các kỹ năng để bạn biết mình đang chạy những gì. Các giá trị này khớp trực tiếp với trường `risk:` trong frontmatter của mỗi `SKILL.md`:
 
-- 🟣 **Official (Chính thức)**: Được duy trì bởi Anthropic/Google/Nhà cung cấp (Độ tin cậy cao).
-- 🔵 **Safe (An toàn)**: Các kỹ năng cộng đồng không gây hại (Chỉ đọc/Lập kế hoạch).
-- 🔴 **Risk (Rủi ro)**: Các kỹ năng sửa đổi hệ thống hoặc thực hiện kiểm thử bảo mật (Sử dụng khi được cấp phép).
+- ⚪ **`unknown`**: Nội dung cũ hoặc chưa được phân loại, vẫn cần maintainer phân loại.
+- 🟢 **`none`**: Hướng dẫn thuần văn bản hoặc lập luận.
+- 🔵 **`safe`**: Hướng dẫn chỉ đọc hoặc vận hành rủi ro thấp.
+- 🟠 **`critical`**: Hướng dẫn thay đổi trạng thái hoặc có thể ảnh hưởng đến triển khai.
+- 🔴 **`offensive`**: Hướng dẫn pentesting/red-team với cảnh báo Authorized Use Only rõ ràng.
 
 _Kiểm tra [Danh mục Skill (Skill Catalog)](../../CATALOG.md) để xem danh sách đầy đủ._
 
@@ -90,7 +98,7 @@ _Kiểm tra [Danh mục Skill (Skill Catalog)](../../CATALOG.md) để xem danh
 
 ## ❓ FAQ
 
-**H: Tôi có cần cài đặt tất cả 560 kỹ năng không?**  
+**H: Tôi có cần cài đặt tất cả 1,684+ kỹ năng không?**
 Đ: Bạn tải toàn bộ repo về, nhưng AI của bạn chỉ _đọc_ những kỹ năng bạn yêu cầu (hoặc những kỹ năng có liên quan). Nó rất nhẹ!
 
 **H: Tôi có thể tự tạo kỹ năng cho riêng mình không?**  

package/bundled-skills/docs/vietnamese/QUALITY_BAR.vi.md

@@ -12,8 +12,11 @@ Phần frontmatter trong `SKILL.md` phải là mã YAML hợp lệ và chứa:
 
 - `name`: Định dạng Kebab-case, khớp với tên thư mục.
 - `description`: Dưới 200 ký tự, nêu rõ giá trị mang lại.
-- `risk`: Thuộc một trong các loại `[none, safe, critical, offensive]`.
-- `source`: URL dẫn đến nguồn gốc (hoặc "self" nếu là nội dung gốc).
+- `category`: Danh mục chính của skill.
+- `risk`: Thuộc một trong các loại `[none, safe, critical, offensive, unknown]`. Chỉ dùng `unknown` cho nội dung cũ hoặc chưa được phân loại; skill mới nên dùng mức cụ thể.
+- `source`: Nguồn gốc của skill.
+- `date_added`: Ngày thêm skill theo định dạng `YYYY-MM-DD`.
+- `source_repo` và `source_type`: Bắt buộc khi skill bắt nguồn từ repository GitHub bên ngoài.
 
 ### 2. Điều kiện kích hoạt rõ ràng ("Khi nào nên dùng")
 
@@ -26,6 +29,7 @@ Skill BẮT BUỘC phải có một phần nêu rõ thời điểm nên kích ho
 
 Mỗi skill phải khai báo mức độ rủi ro của nó:
 
+- ⚪ **unknown**: Nội dung cũ hoặc chưa được phân loại. Tránh dùng cho skill mới trừ khi thật sự cần maintainer phân loại.
 - 🟢 **none**: Chỉ là văn bản/tư duy thuần túy (ví dụ: Brainstorming).
 - 🔵 **safe**: Đọc file, chạy các lệnh an toàn (ví dụ: Linter).
 - 🟠 **critical**: Sửa đổi trạng thái, xóa file, push lên môi trường production (ví dụ: Git Push).
@@ -57,8 +61,9 @@ Chúng tôi cũng phân loại skill dựa trên người duy trì chúng:
 
 ## Cách Xác thực Skill của bạn
 
-Chạy script xác thực trước khi gửi Pull Request (PR):
+Chạy validator trước khi gửi Pull Request (PR):
 
 ```bash
-python3 scripts/validate_skills.py --strict
+npm run validate
+npm run validate:strict
 ```

package/bundled-skills/docs/vietnamese/README.vi.md

@@ -1,6 +1,6 @@
-# 🌌 Antigravity Awesome Skills: 560+ Kỹ năng (Skills) cho Claude Code, Gemini CLI, Cursor, Copilot và nhiều hơn nữa
+# 🌌 Antigravity Awesome Skills: 1,684+ Kỹ năng (Skills) cho Claude Code, Gemini CLI, Cursor, Copilot và nhiều hơn nữa
 
-> **Bộ sưu tập tối ưu gồm hơn 560 Kỹ năng Phổ quát cho các Trợ lý Lập trình AI — Claude Code, Gemini CLI, Codex CLI, Antigravity IDE, GitHub Copilot, Cursor, OpenCode**
+> **Thư viện GitHub có thể cài đặt gồm hơn 1,684 kỹ năng agentic cho Claude Code, Cursor, Codex CLI, Gemini CLI, Antigravity và các trợ lý lập trình AI khác.**
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![Claude Code](https://img.shields.io/badge/Claude%20Code-Anthropic-purple)](https://claude.ai)
@@ -11,21 +11,22 @@
 [![OpenCode](https://img.shields.io/badge/OpenCode-CLI-gray)](https://github.com/opencode-ai/opencode)
 [![Antigravity](https://img.shields.io/badge/Antigravity-DeepMind-red)](https://github.com/sickn33/antigravity-awesome-skills)
 
-**Antigravity Awesome Skills** là một thư viện được tuyển chọn và kiểm chứng kỹ lưỡng với **560 kỹ năng hiệu suất cao** được thiết kế để hoạt động mượt mà trên tất cả các trợ lý lập trình AI lớn:
+**Antigravity Awesome Skills** là một thư viện kỹ năng có thể cài đặt với **1,684+ kỹ năng `SKILL.md`** được thiết kế để hoạt động mượt mà trên các trợ lý lập trình AI lớn:
 
 - 🟣 **Claude Code** (Anthropic CLI)
 - 🔵 **Gemini CLI** (Google DeepMind)
 - 🟢 **Codex CLI** (OpenAI)
-- 🔴 **Antigravity IDE** (Google DeepMind)
+- 🔴 **Antigravity IDE** và **Antigravity CLI (`agy`)**
 - 🩵 **GitHub Copilot** (VSCode Extension)
 - 🟠 **Cursor** (AI-native IDE)
 - ⚪ **OpenCode** (Mã nguồn mở CLI)
+- 🟡 **Kiro CLI / IDE** và **AdaL CLI**
 
-**Chào mừng bạn đến với Phiên bản V4.0.0 Enterprise.** Đây không chỉ là một danh sách các tập lệnh (scripts); nó là một hệ điều hành hoàn chỉnh cho Trợ lý AI của bạn.
+**Phiên bản hiện tại: V13.2.0.** Đây không chỉ là một danh sách prompt; repository này cung cấp kỹ năng, bundles, workflows, catalog sinh tự động và installer CLI để dùng lại các playbook đã được kiểm chứng.
 
 ### 1. 🐣 Bối cảnh: Đây là gì?
 
-**Antigravity Awesome Skills** (Phiên bản 4.0.0) là một bản nâng cấp khổng lồ cho khả năng của AI.
+**Antigravity Awesome Skills** (Phiên bản 13.2.0) là một thư viện kỹ năng lớn cho AI coding assistants.
 
 Các trợ lý AI (như Claude Code, Cursor, hoặc Gemini) rất thông minh, nhưng chúng thiếu các **công cụ chuyên biệt**. Chúng không biết "Quy trình Triển khai" của công ty bạn hoặc cú pháp cụ thể cho "AWS CloudFormation".  
 **Skills** là các tệp markdown nhỏ dạy cho chúng cách thực hiện những tác vụ cụ thể này một cách chính xác trong mọi lần thực thi.
@@ -42,21 +43,21 @@ Repository được tổ chức thành các lĩnh vực chuyên biệt để bi
 
 | Danh mục          | Trọng tâm                                                      | Ví dụ kỹ năng                                                                   |
 | :---------------- | :------------------------------------------------------------- | :------------------------------------------------------------------------------ |
-| Kiến trúc (52)    | Thiết kế hệ thống, ADRs, C4 và các mẫu có thể mở rộng          | `architecture`, `c4-context`, `senior-architect`                                |
-| Kinh doanh (35)   | Tăng trưởng, định giá, CRO, SEO và thâm nhập thị trường        | `copywriting`, `pricing-strategy`, `seo-audit`                                  |
-| Dữ liệu & AI (81) | Ứng dụng LLM, RAG, agents, khả năng quan sát, phân tích        | `rag-engineer`, `prompt-engineer`, `langgraph`                                  |
-| Phát triển (72)   | Làm chủ ngôn ngữ, mẫu thiết kế framework, chất lượng code      | `typescript-expert`, `python-patterns`, `react-patterns`                        |
-| Tổng quát (95)    | Lập kế hoạch, tài liệu, vận hành sản phẩm, viết bài, hướng dẫn | `brainstorming`, `doc-coauthoring`, `writing-plans`                             |
-| Hạ tầng (72)      | DevOps, cloud, serverless, triển khai, CI/CD                   | `docker-expert`, `aws-serverless`, `vercel-deployment`                          |
-| Bảo mật (107)     | AppSec, pentesting, phân tích lỗ hổng, tuân thủ                | `api-security-best-practices`, `sql-injection-testing`, `vulnerability-scanner` |
-| Kiểm thử (21)     | TDD, thiết kế kiểm thử, sửa lỗi, quy trình QA                  | `test-driven-development`, `testing-patterns`, `test-fixing`                    |
-| Quy trình (17)    | Tự động hóa, điều phối, công việc, agents                      | `workflow-automation`, `inngest`, `trigger-dev`                                 |
+| Kiến trúc         | Thiết kế hệ thống, ADRs, C4 và các mẫu có thể mở rộng          | `architecture`, `c4-context`, `senior-architect`                                |
+| Kinh doanh        | Tăng trưởng, định giá, CRO, SEO và thâm nhập thị trường        | `copywriting`, `pricing-strategy`, `seo-audit`                                  |
+| Dữ liệu & AI      | Ứng dụng LLM, RAG, agents, khả năng quan sát, phân tích        | `rag-engineer`, `prompt-engineer`, `langgraph`                                  |
+| Phát triển        | Làm chủ ngôn ngữ, mẫu thiết kế framework, chất lượng code      | `typescript-expert`, `python-patterns`, `react-patterns`                        |
+| Tổng quát         | Lập kế hoạch, tài liệu, vận hành sản phẩm, viết bài, hướng dẫn | `brainstorming`, `doc-coauthoring`, `writing-plans`                             |
+| Hạ tầng           | DevOps, cloud, serverless, triển khai, CI/CD                   | `docker-expert`, `aws-serverless`, `vercel-deployment`                          |
+| Bảo mật           | AppSec, pentesting, phân tích lỗ hổng, tuân thủ                | `api-security-best-practices`, `sql-injection-testing`, `vulnerability-scanner` |
+| Kiểm thử          | TDD, thiết kế kiểm thử, sửa lỗi, quy trình QA                  | `test-driven-development`, `testing-patterns`, `test-fixing`                    |
+| Quy trình         | Tự động hóa, điều phối, công việc, agents                      | `workflow-automation`, `inngest`, `trigger-dev`                                 |
 
 ## Bộ sưu tập Tuyển chọn
 
 [Xem các Gói khởi đầu tại docs/vietnamese/BUNDLES.md](BUNDLES.vi.md) để tìm bộ công cụ hoàn hảo cho vai trò của bạn.
 
-## Duyệt hơn 560 Kỹ năng
+## Duyệt hơn 1,684 Kỹ năng
 
 Chúng tôi đã chuyển danh sách đầy đủ các kỹ năng sang một danh mục riêng biệt để giữ cho file README này gọn gàng.
 
@@ -64,20 +65,18 @@ Chúng tôi đã chuyển danh sách đầy đủ các kỹ năng sang một dan
 
 ## Cài đặt
 
-Để sử dụng các kỹ năng này với **Claude Code**, **Gemini CLI**, **Codex CLI**, **Cursor**, **Antigravity**, hoặc **OpenCode**, hãy clone repository này vào thư mục kỹ năng của assistant của bạn:
+Để sử dụng các kỹ năng này với **Claude Code**, **Gemini CLI**, **Codex CLI**, **Cursor**, **Antigravity**, **Kiro**, **OpenCode** hoặc **AdaL**, hãy dùng installer CLI:
 
 ```bash
-# Cài đặt phổ thông (hoạt động với hầu hết các công cụ)
-git clone https://github.com/sickn33/antigravity-awesome-skills.git .agent/skills
-
-# Dành riêng cho Claude Code
-git clone https://github.com/sickn33/antigravity-awesome-skills.git .claude/skills
-
-# Dành riêng cho Gemini CLI
-git clone https://github.com/sickn33/antigravity-awesome-skills.git .gemini/skills
-
-# Dành riêng cho Cursor
-git clone https://github.com/sickn33/antigravity-awesome-skills.git .cursor/skills
+npx antigravity-awesome-skills
+
+# Ví dụ theo công cụ:
+npx antigravity-awesome-skills --claude
+npx antigravity-awesome-skills --gemini
+npx antigravity-awesome-skills --codex
+npx antigravity-awesome-skills --cursor
+npx antigravity-awesome-skills --kiro
+npx antigravity-awesome-skills --agy
 ```
 
 ---
@@ -88,8 +87,8 @@ Chúng tôi chào đón mọi sự đóng góp từ cộng đồng! Để thêm
 
 1. **Fork** repository.
 2. **Tạo một thư mục mới** bên trong `skills/` cho kỹ năng của bạn.
-3. **Thêm file `SKILL.md`** với phần frontmatter bắt buộc (tên và mô tả).
-4. **Chạy kiểm tra xác thực**: `python3 scripts/validate_skills.py`.
+3. **Thêm file `SKILL.md`** theo mẫu `docs/contributors/skill-template.md`.
+4. **Chạy kiểm tra xác thực**: `npm run validate`.
 5. **Gửi một Pull Request**.
 
 Vui lòng đảm bảo kỹ năng của bạn tuân thủ các thực hành tốt nhất của Antigravity/Claude Code.

package/bundled-skills/docs/vietnamese/SKILLS_README.vi.md

@@ -1,6 +1,6 @@
 # Thư mục Kỹ năng (Skills Directory)
 
-**Chào mừng đến với thư mục Kỹ năng!** Đây là nơi tập hợp tất cả 179+ kỹ năng AI chuyên biệt.
+**Chào mừng đến với thư mục Kỹ năng!** Đây là nơi tập hợp tất cả 1,684+ kỹ năng AI chuyên biệt.
 
 ## 🤔 Kỹ năng là gì?
 
@@ -30,7 +30,7 @@ skills/
 ## Cách sử dụng Kỹ năng
 
 ### Bước 1: Đảm bảo kỹ năng đã được thiết lập
-Các file kỹ năng nên nằm trong thư mục `.agent/skills/` của bạn (hoặc `.claude/skills/`, `.gemini/skills/`, v.v.)
+Theo mặc định, installer đặt kỹ năng vào `~/.agents/skills/`. Bạn cũng có thể dùng cờ theo công cụ như `--claude`, `--gemini`, `--codex`, `--cursor`, `--kiro`, `--antigravity`, `--agy`, hoặc `--path <dir>`.
 
 ### Bước 2: Kích hoạt kỹ năng trong cuộc trò chuyện với AI
 Sử dụng biểu tượng `@` theo sau bởi tên kỹ năng:
@@ -63,7 +63,7 @@ ls skills/ | grep "từ khóa"
 ```
 
 ### Cách 3: Kiểm tra README chính
-Xem [README chính](README.vi.md) để biết danh sách đầy đủ tất cả 179+ kỹ năng được tổ chức theo danh mục.
+Xem [README chính](README.vi.md) và [CATALOG.md](../../CATALOG.md) để biết danh sách đầy đủ tất cả 1,684+ kỹ năng được tổ chức theo danh mục.
 
 ---
 

package/bundled-skills/docs/vietnamese/SKILL_ANATOMY.vi.md

@@ -46,6 +46,10 @@ Frontmatter nằm ở ngay đầu file, được bao bọc bởi cặp `---`:
 ---
 name: my-skill-name
 description: "Mô tả ngắn gọn về chức năng của skill này"
+category: development
+risk: safe
+source: community
+date_added: 2026-06-25
 ---
 ```
 
@@ -65,6 +69,26 @@ description: "Mô tả ngắn gọn về chức năng của skill này"
 - **Độ dài:** Nên dưới 150 ký tự.
 - **Ví dụ:** `"Các mẫu tích hợp thanh toán Stripe bao gồm checkout, đăng ký gói (subscriptions) và webhooks"`
 
+#### `category`
+
+- **Định nghĩa:** Danh mục chính của skill.
+- **Ví dụ:** `development`, `security`, `testing`, `infrastructure`.
+
+#### `risk`
+
+- **Định nghĩa:** Mức rủi ro của hướng dẫn trong skill.
+- **Giá trị:** `none`, `safe`, `critical`, `offensive`, hoặc `unknown`.
+
+#### `source`
+
+- **Định nghĩa:** Nguồn gốc của skill.
+- **Ví dụ:** `community`, `self`, hoặc URL nguồn.
+
+#### `date_added`
+
+- **Định nghĩa:** Ngày skill được thêm vào registry.
+- **Định dạng:** `YYYY-MM-DD`.
+
 ### Các trường Tùy chọn
 
 Một số skill bao gồm thêm siêu dữ liệu bổ sung:
@@ -73,8 +97,12 @@ Một số skill bao gồm thêm siêu dữ liệu bổ sung:
 ---
 name: my-skill-name
 description: "Mô tả ngắn"
-risk: "safe" # none | safe | critical | offensive (xem QUALITY_BAR.md)
-source: "community"
+category: development
+risk: safe
+source: community
+source_repo: "https://github.com/example/example-skills"
+source_type: "github"
+date_added: 2026-06-25
 tags: ["react", "typescript"]
 ---
 ```
@@ -304,19 +332,19 @@ references/
 
 ### Skill Tối giản (Minimum Viable Skill)
 
-- **Frontmatter:** name + description
+- **Frontmatter:** `name`, `description`, `category`, `risk`, `source`, `date_added`; thêm `source_repo` và `source_type` khi skill bắt nguồn từ GitHub bên ngoài
 - **Nội dung:** 100-200 từ
 - **Các mục:** Tổng quan + Hướng dẫn
 
 ### Skill Tiêu chuẩn (Standard Skill)
 
-- **Frontmatter:** name + description
+- **Frontmatter:** `name`, `description`, `category`, `risk`, `source`, `date_added`; thêm `source_repo` và `source_type` khi skill bắt nguồn từ GitHub bên ngoài
 - **Nội dung:** 300-800 từ
 - **Các mục:** Tổng quan + Khi nào sử dụng + Hướng dẫn + Ví dụ
 
 ### Skill Toàn diện (Comprehensive Skill)
 
-- **Frontmatter:** name + description + các trường tùy chọn
+- **Frontmatter:** các trường chuẩn ở trên, cộng `source_repo`/`source_type` khi skill bắt nguồn từ GitHub bên ngoài và các trường tùy chọn khi hữu ích
 - **Nội dung:** 800-2000 từ
 - **Các mục:** Đầy đủ tất cả các mục đề xuất
 - **Bổ sung:** Scripts, ví dụ, templates

package/bundled-skills/docs/vietnamese/TRANSLATION_PLAN.vi.md

@@ -2,7 +2,7 @@
 
 Tài liệu này dùng để theo dõi tiến độ dịch thuật toàn bộ repository `antigravity-awesome-skills` sang tiếng Việt.
 
-**Mục tiêu:** Dịch toàn bộ 560+ kỹ năng và tài liệu hướng dẫn.
+**Mục tiêu:** Dịch toàn bộ 1,684+ kỹ năng và tài liệu hướng dẫn.
 **Quy tắc:**
 1. Giữ nguyên cấu trúc thư mục gốc.
 2. File dịch được lưu tại `docs/vietnamese/skills/<category>/<skill-name>.vi.md`.