opencode-skills-collection 3.1.7 → 3.1.9

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`.

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

@@ -33,7 +33,7 @@ antigravity-awesome-skills/
 ├── 📄 README.md                    ← Tổng quan & danh sách skill
 ├── 📄 CONTRIBUTING.md              ← Cách thức đóng góp
 │
-├── 📁 skills/                      ← Nơi chứa tất cả hơn 250 skills
+├── 📁 skills/                      ← Nguồn canonical cho 1,684+ skills
 │   │
 │   ├── 📁 brainstorming/
 │   │   └── 📄 SKILL.md             ← Định nghĩa skill
@@ -42,11 +42,12 @@ antigravity-awesome-skills/
 │   │   ├── 📄 SKILL.md
 │   │   └── 📁 examples/            ← Các phần bổ sung tùy chọn
 │   │
-│   └── ... (Hơn 250 skills khác)
+│   └── ... (1,684+ skills khác)
 │
-├── 📁 scripts/                     ← Quản lý & Xác thực
-│   ├── validate_skills.py          ← Công cụ kiểm soát chất lượng
-│   └── generate_index.py           ← Công cụ tạo danh mục (registry)
+├── 📁 tools/
+│   ├── 📁 scripts/                 ← Quản lý, xác thực và tạo catalog
+│   ├── 📁 lib/                     ← Logic installer dùng chung
+│   └── 📁 bin/                     ← CLI entrypoint
 │
 ├── 📁 .github/
 │   └── 📄 MAINTENANCE.md           ← Hướng dẫn cho người duy trì
@@ -66,7 +67,7 @@ antigravity-awesome-skills/
 
 ```
 ┌──────────────┐
-│ 1. CÀI ĐẶT   │  Sao chép skills vào .agent/skills/
+│ 1. CÀI ĐẶT   │  npx antigravity-awesome-skills
 1 └──────┬───────┘
        │
        ↓
@@ -96,7 +97,7 @@ antigravity-awesome-skills/
 
 ```
                     ┌─────────────────────────┐
-                    │   250+ AWESOME SKILLS   │
+                    │  1,684+ AWESOME SKILLS  │
                     └────────────┬────────────┘
                                  │
         ┌────────────────────────┼────────────────────────┐
@@ -174,17 +175,15 @@ antigravity-awesome-skills/
 
 ## Cài đặt (Các bước Trực quan)
 
-### Bước 1: Sao chép Repository
+### Bước 1: Cài đặt bằng installer
 
 ```
 ┌─────────────────────────────────────────┐
 │ Terminal                                │
 ├─────────────────────────────────────────┤
-│ $ git clone https://github.com/        │
-│   sickn33/antigravity-awesome-skills    │
-│   .agent/skills                         │
+│ $ npx antigravity-awesome-skills        │
 │                                         │
-│ ✓ Đang sao chép vào '.agent/skills'... │
+│ ✓ Cài vào '~/.agents/skills'...         │
 │ ✓ Hoàn tất!                             │
 └─────────────────────────────────────────┘
 ```
@@ -195,12 +194,12 @@ antigravity-awesome-skills/
 ┌─────────────────────────────────────────┐
 │ File Explorer                           │
 ├─────────────────────────────────────────┤
-│ 📁 .agent/                              │
+│ 📁 ~/.agents/                           │
 │   └── 📁 skills/                        │
 │       ├── 📁 brainstorming/             │
 │       ├── 📁 stripe-integration/        │
 │       ├── 📁 react-best-practices/      │
-│       └── ... (Thêm 176 mục nữa)        │
+│       └── ... (1,684+ skills)           │
 └─────────────────────────────────────────┘
 ```
 
@@ -313,12 +312,12 @@ Mở file skills_index.json → Tìm từ khóa → Tìm đường dẫn đến
        │
        ↓
 ┌──────────────┐
-│ 4. KIỂM THỬ  │  Sao chép vào .agent/skills/
+│ 4. KIỂM THỬ  │  Cài bằng npx hoặc --path thử nghiệm
 └──────┬───────┘  Thử: @docker-mastery
        │
        ↓
 ┌──────────────┐
-│ 5. XÁC THỰC  │  python3 scripts/validate_skills.py
+│ 5. XÁC THỰC  │  npm run validate
 └──────┬───────┘
        │
        ↓
@@ -437,7 +436,7 @@ BẮT ĐẦU TẠI ĐÂY
 ├─────────────────────────────────────────────────────────────┤
 │                                                             │
 │  📥 CÀI ĐẶT                                                 │
-│  git clone [repo] .agent/skills                             │
+│  npx antigravity-awesome-skills                             │
 │                                                             │
 │  🎯 SỬ DỤNG                                                 │
 │  @ten-skill [yêu cầu của bạn]                               │
@@ -446,7 +445,7 @@ BẮT ĐẦU TẠI ĐÂY
 │  ls skills/ | grep "từ-khóa"                                │
 │                                                             │
 │  ✅ XÁC THỰC                                                │
-│  python3 scripts/validate_skills.py                         │
+│  npm run validate                                           │
 │                                                             │
 │  📝 TẠO SKILL                                               │
 │  1. mkdir skills/ten-skill-cua-ban                          │