📦 deps(thirdparty): update snapshots

2026-06-25 16:06:49 +00:00
parent 1da991f912
commit a225b70c17
376 changed files with 27320 additions and 4607 deletions
@@ -27,6 +27,7 @@ Accepted headings: `## When to Use`, `## Use this skill when`, `## When to Use T

 Every skill must declare its risk level:

+- ⚪ **unknown**: Legacy or unclassified content. Avoid this for new skills unless maintainer triage is genuinely needed.
 - 🟢 **none**: Pure text/reasoning (e.g., Brainstorming).
 - 🔵 **safe**: Reads files, runs safe commands (e.g., Linter).
 - 🟠 **critical**: Modifies state, deletes files, pushes to prod (e.g., Git Push).
@@ -45,10 +45,12 @@ The frontmatter is at the very top, wrapped in `---`:
 ---
 name: my-skill-name
 description: "Brief description of what this skill does"
+category: development
 risk: safe
 source: community
 source_repo: owner/repo
 source_type: community
+date_added: "YYYY-MM-DD"
 ---
 ```

@@ -66,6 +68,12 @@ source_type: community
 - **Length:** Keep it under 200 characters
 - **Example:** `"Stripe payment integration patterns including checkout, subscriptions, and webhooks"`

+#### `category`
+- **What it is:** Primary grouping used by generated indexes and catalog surfaces
+- **Format:** Lowercase category label
+- **Example:** `category: development`
+- **Note:** Tooling can infer a category for legacy skills, but new skills should declare one explicitly.
+
 #### `risk`
 - **What it is:** The safety classification of the skill
 - **Values:** `none` | `safe` | `critical` | `offensive` | `unknown`
@@ -95,6 +103,12 @@ source_type: community
 - **Examples:** `source_type: official`, `source_type: community`
 - **Rule:** `self` means no external README repo credit is required

+#### `date_added`
+- **What it is:** Date the skill entered this repository
+- **Format:** `YYYY-MM-DD`
+- **Example:** `date_added: "2026-03-06"`
+- **Note:** Validation treats this as advisory for legacy content, but new contributions should include it.
+
 ### Optional Fields

 Some skills include additional metadata:
@@ -103,10 +117,12 @@ Some skills include additional metadata:
 ---
 name: my-skill-name
 description: "Brief description"
+category: development
 risk: safe
 source: community
 source_repo: owner/repo
 source_type: community
+date_added: "YYYY-MM-DD"
 author: "your-name-or-handle"
 tags: ["react", "typescript", "testing"]
 tools: [claude, cursor, gemini]
@@ -355,17 +371,17 @@ references/
 ## Skill Size Guidelines

 ### Minimum Viable Skill
- **Frontmatter:** name + description
+- **Frontmatter:** standard fields (`name`, `description`, `category`, `risk`, `source`, `date_added`)
 - **Content:** 100-200 words
 - **Sections:** Overview + Instructions

 ### Standard Skill
- **Frontmatter:** name + description
+- **Frontmatter:** standard fields (`name`, `description`, `category`, `risk`, `source`, `date_added`)
 - **Content:** 300-800 words
 - **Sections:** Overview + When to Use + Instructions + Examples

 ### Comprehensive Skill
- **Frontmatter:** name + description + optional fields
+- **Frontmatter:** standard fields plus `source_repo`/`source_type` for external GitHub-derived skills and optional fields where useful
 - **Content:** 800-2000 words
 - **Sections:** All recommended sections
 - **Extras:** Scripts, examples, templates
@@ -1,9 +1,9 @@
 ---
 title: Jetski/Cortex + Gemini Integration Guide
-description: "Use antigravity-awesome-skills with Jetski/Cortex without hitting context-window overflow with 1,682+ skills."
+description: "Use antigravity-awesome-skills with Jetski/Cortex without hitting context-window overflow with 1,684+ skills."
 ---

-# Jetski/Cortex + Gemini: safe integration with 1,682+ skills
+# Jetski/Cortex + Gemini: safe integration with 1,684+ skills

 This guide shows how to integrate the `antigravity-awesome-skills` repository with an agent based on **Jetski/Cortex + Gemini** (or similar frameworks) **without exceeding the model context window**.

@@ -23,7 +23,7 @@ Never do:
 - concatenate all `SKILL.md` content into a single system prompt;
 - re-inject the entire library for **every** request.

-With 1,682+ skills, this approach fills the context window before user messages are even added, causing truncation.
+With 1,684+ skills, this approach fills the context window before user messages are even added, causing truncation.

 ---

@@ -21,7 +21,7 @@ This example shows one way to integrate **antigravity-awesome-skills** with a Je
 - How to enforce a **maximum number of skills per turn** via `maxSkillsPerTurn`.
 - How to choose whether to **truncate or error** when too many skills are requested via `overflowBehavior`.

-This pattern avoids context overflow when you have 1,682+ skills installed.
+This pattern avoids context overflow when you have 1,684+ skills installed.

 Manifest contract references:

@@ -5,14 +5,16 @@
 ### 1. **Intelligent Auto-Categorization Script**
 Created [`tools/scripts/auto_categorize_skills.py`](../../tools/scripts/auto_categorize_skills.py) that:
 - Analyzes skill names and descriptions
- Matches against keyword libraries for 13 categories
+- Matches against keyword libraries that seeded the current generated category metadata
 - Automatically assigns meaningful categories
 - Removes "uncategorized" bulk assignment

-**Results:**
+**Historical initial-run result:**
 - ✅ 776 skills auto-categorized
 - ✅ 46 already had categories preserved
- ✅ 124 remaining uncategorized (edge cases)
+- ✅ 124 remained uncategorized at the time of that run
+
+For current counts, use `skills_index.json`; the active repository has grown beyond this historical snapshot.

 ### 2. **Category Distribution**

@@ -26,20 +28,8 @@ security: 4

 **After:**
 ```
-Backend: 164          ████████████████
-Web Dev: 107          ███████████
-Automation: 103       ███████████
-DevOps: 83            ████████
-AI/ML: 79             ████████
-Content: 47           █████
-Database: 44          █████
-Testing: 38           ████
-Security: 36          ████
-Cloud: 33             ███
-Mobile: 21            ██
-Game Dev: 15          ██
-Data Science: 14      ██
-Uncategorized: 126    █
+Generated category metadata is now derived from the current skills_index.json.
+Do not preserve these historical counts in user-facing docs.
 ```

 ### 3. **Updated Index Generation**
@@ -54,16 +44,16 @@ Modified [`tools/scripts/generate_index.py`](../../tools/scripts/generate_index.
 **Home Page Changes:**
 - ✅ Categories sorted by skill count (most first)
 - ✅ "Uncategorized" moved to bottom
- ✅ Each shows count: "Backend (164)", "Web Dev (107)"
+- ✅ Each shows counts computed from the generated index
 - ✅ Much easier to navigate

 **Updated Code:**
 - [`apps/web-app/src/pages/Home.tsx`](../../apps/web-app/src/pages/Home.tsx) - Smart category sorting
 - Sorts categories by count using categoryStats
 - Uncategorized always last
- Displays count in dropdown
+- Displays generated counts in dropdown

-### 5. **Categorization Keywords** (13 Categories)
+### 5. **Categorization Keywords** (seed buckets)

 | Category | Key Keywords |
 |----------|--------------|
@@ -97,16 +87,16 @@ Created [`smart-auto-categorization.md`](smart-auto-categorization.md) with:

 ### Better UX
 1. **Smarter Filtering**: Categories sorted by relevance
-2. **Visual Cues**: Shows count "(164 skills)""
+2. **Visual Cues**: Shows current generated counts
 3. **Uncategorized Last**: Put bad options out of sight
 4. **Meaningful Groups**: Find skills by actual function

 ### Example Workflow
 User wants to find database skills:
 1. Opens web app
-2. Sees filter dropdown: "Backend (164) | Database (44) | Web Dev (107)..."
-3. Clicks "Database (44)"
-4. Gets 44 relevant SQL/MongoDB/Postgres skills
+2. Sees filter dropdown with generated category counts
+3. Clicks the current database-related category
+4. Gets the current matching SQL/MongoDB/Postgres skills
 5. Done! 🎉

 ## 🚀 Usage
@@ -6,7 +6,7 @@ This document keeps the repository's GitHub-facing discovery copy aligned with t

 Preferred positioning:

-> Installable GitHub library of 1,682+ agentic skills for Claude Code, Cursor, Codex CLI, Gemini CLI, Antigravity, and other AI coding assistants.
+> Installable GitHub library of 1,684+ agentic skills for Claude Code, Cursor, Codex CLI, Gemini CLI, Antigravity, and other AI coding assistants.

 Key framing:

@@ -20,7 +20,7 @@ Key framing:

 Preferred description:

-> Installable GitHub library of 1,682+ agentic skills for Claude Code, Cursor, Codex CLI, Gemini CLI, Antigravity, and more. Includes installer CLI, bundles, workflows, and official/community skill collections.
+> Installable GitHub library of 1,684+ agentic skills for Claude Code, Cursor, Codex CLI, Gemini CLI, Antigravity, and more. Includes installer CLI, bundles, workflows, and official/community skill collections.

 Preferred homepage:

@@ -28,7 +28,7 @@ Preferred homepage:

 Preferred social preview:

- use a clean preview image that says `1,682+ Agentic Skills`;
+- use a clean preview image that says `1,684+ Agentic Skills`;
 - mention Claude Code, Cursor, Codex CLI, and Gemini CLI;
 - avoid dense text and tiny logos that disappear in social cards.

@@ -72,7 +72,7 @@ The update process refreshes:
 - Canonical skills index (`skills_index.json`)
 - Compatibility mirror (`data/skills_index.json`)
 - Web app skills data (`apps\web-app\public\skills.json`)
- All 1,682+ skills from the skills directory
+- All 1,684+ skills from the skills directory

 ## When to Update

@@ -9,26 +9,28 @@ The skill collection now uses intelligent auto-categorization to eliminate "unca
 ✅ Current repository indexed through the generated catalog
 - Most skills are in meaningful categories
 - A smaller tail still needs manual review or better keyword coverage
- 11 primary categories
- Categories sorted by skill count (most first)
+- `skills_index.json` is the source of truth for current category labels and counts
+- Category filters should be derived from the generated index at build time

 ## Category Distribution

-| Category | Count | Examples |
-|----------|-------|----------|
-| Backend | 164 | Node.js, Django, Express, FastAPI |
-| Web Development | 107 | React, Vue, Tailwind, CSS |
-| Automation | 103 | Workflow, Scripting, RPA |
-| DevOps | 83 | Docker, Kubernetes, CI/CD, Git |
-| AI/ML | 79 | TensorFlow, PyTorch, NLP, LLM |
-| Content | 47 | Documentation, SEO, Writing |
-| Database | 44 | SQL, MongoDB, PostgreSQL |
-| Testing | 38 | Jest, Cypress, Unit Testing |
-| Security | 36 | Encryption, Authentication |
-| Cloud | 33 | AWS, Azure, GCP |
-| Mobile | 21 | React Native, Flutter, iOS |
-| Game Dev | 15 | Unity, WebGL, 3D |
-| Data Science | 14 | Pandas, NumPy, Analytics |
+Do not copy fixed counts into user-facing docs. To inspect the current distribution, generate it from the index:
+
+```bash
+node - <<'NODE'
+const fs = require('fs');
+const skills = JSON.parse(fs.readFileSync('skills_index.json', 'utf8'));
+const counts = new Map();
+for (const skill of skills) {
+  const category = skill.category || 'uncategorized';
+  counts.set(category, (counts.get(category) || 0) + 1);
+}
+console.log(`skills=${skills.length} categories=${counts.size}`);
+for (const [category, count] of [...counts.entries()].sort((a, b) => b[1] - a[1]).slice(0, 12)) {
+  console.log(`${category}: ${count}`);
+}
+NODE
+```

 ## How It Works

@@ -91,20 +93,17 @@ Sample changes:

 **After:**
 - Categories sorted by skill count (most first, "uncategorized" last)
- Shows count: "Backend (164)" "Web Development (107)"
+- Shows counts from the generated index instead of hard-coded documentation numbers
 - Much easier to browse

 ### Example Dropdowns

 **Sorted Order:**
 1. All Categories
-2. Backend (164)
-3. Web Development (107)
-4. Automation (103)
-5. DevOps (83)
-6. AI/ML (79)
-7. ... more categories ...
-8. Uncategorized (126) ← at the end
+2. Highest-count generated category
+3. Next generated category
+4. ... more generated categories ...
+5. Uncategorized, if present, at the end

 ## For Skill Creators

@@ -1061,4 +1061,4 @@ Found a skill that should be in a bundle? Or want to create a new bundle? [Open

 ---

-_Last updated: June 2026 | Total Skills: 1,682+ | Total Bundles: 59_
+_Last updated: June 2026 | Total Skills: 1,684+ | Total Bundles: 59_
@@ -12,7 +12,7 @@ Install the library into Claude Code, then invoke focused skills directly in the

 ## Why use this repo for Claude Code

- It includes 1,682+ skills instead of a narrow single-domain starter pack.
+- It includes 1,684+ skills instead of a narrow single-domain starter pack.
 - It supports the standard `.claude/skills/` path and the Claude Code plugin marketplace flow.
 - It also ships generated bundle plugins so teams can install focused packs like `Essentials` or `Security Developer` from the marketplace metadata.
 - It includes onboarding docs, bundles, and workflows so new users do not need to guess where to begin.
@@ -103,11 +103,11 @@ No. The public site is a static GitHub Pages deploy.

 We classify skills so you know what you're running. These values map directly to the `risk:` field in every `SKILL.md` frontmatter:

- 🔵 **`none`**: Pure reference or planning content — no shell commands, no mutations, no network access.
- ⚪ **`safe`**: Community skills that are non-destructive (read-only, planning, code review, analysis).
- 🔴 **`critical`**: Skills that modify files, drop data, use network scanners, or perform destructive actions. **Use with caution.**
- 🟣 **`offensive`**: Security-focused offensive techniques (pentesting, exploitation). **Authorized use only** — always confirm the target is in scope.
- ⬜ **`unknown`**: Legacy or unclassified content. Review the skill manually before use.
+- ⚪ **`unknown`**: Legacy or unclassified content. Review the skill manually before use.
+- 🟢 **`none`**: Pure reference or planning content — no shell commands, no mutations, no network access.
+- 🔵 **`safe`**: Non-destructive guidance such as read-only commands, planning, code review, and analysis.
+- 🟠 **`critical`**: Skills that modify files, drop data, use network scanners, or perform destructive actions. **Use with caution.**
+- 🔴 **`offensive`**: Security-focused offensive techniques (pentesting, exploitation). **Authorized use only** — always confirm the target is in scope.

 ### Can these skills hack my computer?

@@ -12,7 +12,7 @@ Install into the Gemini skills path, then ask Gemini to apply one skill at a tim

 - It installs directly into the expected Gemini skills path.
 - It includes both core software engineering skills and deeper agent/LLM-oriented skills.
- It helps new users get started with bundles and workflows rather than forcing a cold start from 1,682+ files.
+- It helps new users get started with bundles and workflows rather than forcing a cold start from 1,684+ files.
 - It is useful whether you want a broad internal skill library or a single repo to test many workflows quickly.

 ## Install Gemini CLI Skills
@@ -1,4 +1,4 @@
-# Getting Started with Antigravity Awesome Skills (V13.1.1)
+# Getting Started with Antigravity Awesome Skills (V13.2.0)

 **New here? This guide will help you supercharge your AI Agent in 5 minutes.**

@@ -18,7 +18,7 @@ Kiro is AWS's agentic AI IDE that combines:

 Kiro's agentic capabilities are enhanced by skills that provide:

- **Domain expertise** across 1,682+ specialized areas
+- **Domain expertise** across 1,684+ specialized areas
 - **Best practices** from Anthropic, OpenAI, Google, Microsoft, and AWS
 - **Workflow automation** for common development tasks
 - **AWS-specific patterns** for serverless, infrastructure, and cloud architecture
@@ -1,7 +1,7 @@
-# Local Skills Configuration
+# Local Skills Configuration Snapshot

-> **Current Status**: All 96 skills are available in the repository.  
-> **This Document**: Recommends 35 high-priority skills for typical usage.
+> **Historical snapshot**: This page preserves an older 35-skill local configuration recommendation from 2026-01-16. It is not the current repository catalog.
+> **Current catalog**: Use [`../../skills_index.json`](../../skills_index.json), [`../../CATALOG.md`](../../CATALOG.md), or the installer filters in the README for the active 1,684+ skill library.

 ## 📊 Recommended High-Priority Skills (35)

@@ -67,17 +67,17 @@ Skills actively used for your specific projects:

 ---

-## 🗂️ Repository Structure
+## 🗂️ Snapshot Structure

 ```
-skills/
-├── [96 active skills]     ← All skills available
-└── [4 symlinks]           ← docx, pdf, pptx, xlsx → official versions
+local snapshot/
+├── [96 active skills in this snapshot]
+└── [4 symlinks in this snapshot]
 ```

 ---

-## 📚 Other Available Skills (61)
+## 📚 Other Snapshot Skills (61)

 All other skills in the repository are available for use as needed. Some notable categories:

@@ -140,13 +140,13 @@ Miscellaneous:
 ## 🎯 Benefits of This Recommendation

 ✅ **Focused Guidance** - 35 high-priority skills for common workflows  
-✅ **Full Availability** - All 96 skills accessible when needed  
+✅ **Snapshot Availability** - All 96 skills from this older local set were accessible when needed
 ✅ **Balanced Coverage** - Core dev + AI/automation + frontend excellence  
 ✅ **Easy Discovery** - Categorized list of all other available skills

 ---

-**Last Updated**: 2026-01-16  
+**Snapshot Date**: 2026-01-16
 **Recommended Skills**: 35 high-priority  
-**Total Available**: 96 skills + 4 symlinks = 100 total  
+**Snapshot Total**: 96 skills + 4 symlinks = 100 total
 **Recent Additions to Recommendations**: `senior-fullstack`, `concise-planning`, `address-github-comments`, `javascript-mastery`, `workflow-automation`, `llm-app-patterns`, `autonomous-agent-patterns`, `prompt-library`
@@ -17,9 +17,9 @@ That makes specialized plugins the better default product shape. A root plugin c

 ## Selection Method

-This pass evaluated the full local catalog in `data/skills_index.json`:
+This snapshot pass evaluated the then-current local catalog. For current catalog checks, use the canonical root `skills_index.json` and treat `data/skills_index.json` only as the compatibility mirror:

- Total skills evaluated: 1,678.
+- Total skills evaluated in this snapshot: 1,678.
 - Broadest categories: development, cloud, AI/ML, security, business, workflow, content, marketing, automation, and web development.
 - Existing editorial bundles are all small and mostly plugin-compatible, which makes them a good starting point.
 - The stronger opportunity is to turn the best bundles into first-class product plugins with sharper names, richer descriptions, and optional app/MCP extensions.
@@ -71,7 +71,7 @@ These are promising and should be hardened after Tier 1.
 3. Rename or reframe bundle plugins as product plugins where the job is clear.
 4. Add richer `interface` metadata to the strongest plugin manifests: display name, short description, brand color, and default prompt.
 5. Add per-plugin quality gates:
-   - every skill exists in `data/skills_index.json`;
+  - every skill exists in canonical `skills_index.json`;
   - every skill is Codex-supported before Codex publication;
   - every skill is Claude-supported before Claude publication;
   - every plugin has a 5-10 skill target range unless it has a concrete reason to be larger;
@@ -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,682+ skill files** to your computer (default: `~/.agents/skills/`; or a custom path like `~/.agent/skills/` if you used `--path`)
+✅ **Downloaded 1,684+ 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,682+ tools (✅ done)
+- You installed a toolbox with 1,684+ 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,682+ skills at once. Here's a sensible approach:
+Don't try to use all 1,684+ 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,682+ skills installed locally, you should **not** concatenate every `SKILL.md` into a single system prompt or context block.
+No. Even though you have 1,684+ skills installed locally, you should **not** concatenate every `SKILL.md` into a single system prompt or context block.

 The intended pattern is:

@@ -34,7 +34,7 @@ antigravity-awesome-skills/
 ├── 📄 CONTRIBUTING.md                  ← Contributor workflow
 ├── 📄 CATALOG.md                       ← Full generated catalog
 │
-├── 📁 skills/                          ← 1,682+ skills live here
+├── 📁 skills/                          ← 1,684+ skills live here
 │   │
 │   ├── 📁 brainstorming/
 │   │   └── 📄 SKILL.md                 ← Skill definition
@@ -47,7 +47,7 @@ antigravity-awesome-skills/
 │   │   └── 📁 2d-games/
 │   │       └── 📄 SKILL.md             ← Nested skills also supported
 │   │
-│   └── ... (1,682+ total)
+│   └── ... (1,684+ total)
 │
 ├── 📁 apps/
 │   └── 📁 web-app/                     ← Interactive browser
@@ -100,7 +100,7 @@ antigravity-awesome-skills/

 ```
                    ┌─────────────────────────┐
-                    │  1,682+ SKILLS          │
+                    │  1,684+ 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,682+ total)                │
+│   └── ... (1,684+ total)                │
 └─────────────────────────────────────────┘
 ```

@@ -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._
@@ -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
@@ -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.

 ---

@@ -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?**  
@@ -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
 ```
@@ -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
+npx antigravity-awesome-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
+# 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.
@@ -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.

 ---

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