npm - opencode-skills-collection - Versions diffs - 4.0.53 → 4.0.55 - Mend

opencode-skills-collection 4.0.53 → 4.0.55

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (1230) hide show

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

@@ -1,242 +0,0 @@
-# 🤝 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ở.
-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)
-**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`, `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.
-5.  **Hành động (Actions)**: Phải định nghĩa các bước hành động cụ thể cho AI, không chỉ là các "ý nghĩ".
----
-## Các Cách để Đóng góp
-Bạn không cần phải là một chuyên gia! Dưới đây là những cách mà bất kỳ ai cũng có thể giúp đỡ:
-### 1. Cải thiện Tài liệu (Dễ nhất!)
-- Sửa lỗi chính tả hoặc ngữ pháp.
-- Làm cho các giải thích trở nên rõ ràng hơn.
-- Thêm ví dụ vào các kỹ năng hiện có.
-- Dịch tài liệu sang các ngôn ngữ khác.
-### 2. Báo cáo Vấn đề (Issues)
-- Thấy điều gì đó khó hiểu? Hãy cho chúng tôi biết!
-- Kỹ năng không hoạt động? Hãy báo cho chúng tôi!
-- Bạn có đề xuất? Chúng tôi luôn sẵn sàng lắng nghe!
-### 3. Tạo Kỹ năng (Skill) mới
-- Chia sẻ chuyên môn của bạn dưới dạng một kỹ năng.
-- Lấp đầy các khoảng trống trong bộ sưu tập hiện tại.
-- Cải thiện các kỹ năng sẵn có.
-### 4. Kiểm thử và Xác thực
-- Thử nghiệm các kỹ năng và báo cáo những gì hoạt động hoặc không hoạt động.
-- Kiểm tra trên các công cụ AI khác nhau.
-- Đề xuất các cải tiến.
----
-## Cách Tạo một Kỹ năng mới
-### Hướng dẫn Từng bước
-#### Bước 1: Chọn Chủ đề cho Kỹ năng của bạn
-Hãy tự hỏi: "Tôi ước trợ lý AI của mình hiểu rõ hơn về điều gì?".
-Ví dụ: "Tôi giỏi về Docker, tôi sẽ tạo một kỹ năng về Docker".
-#### Bước 2: Tạo Cấu trúc Thư mục
-Các kỹ năng nằm trong thư mục `skills/`. Sử dụng định dạng `kebab-case` cho tên thư mục.
-```bash
-# Di chuyển đến thư mục skills
-cd skills/
-# Tạo thư mục cho skill của bạn
-mkdir my-awesome-skill
-cd my-awesome-skill
-# Tạo file SKILL.md
-touch SKILL.md
-```
-#### Bước 3: Viết Nội dung cho SKILL.md
-Mỗi kỹ năng đều cần cấu trúc cơ bản này. **Hãy sao chép mẫu dưới đây:**
-```markdown
----
-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
-## Tổng quan
-Giải thích skill này làm gì và khi nào nên sử dụng nó.
-## Khi nào nên sử dụng Skill này
-- Sử dụng khi [tình huống 1]
-- Sử dụng khi [tình huống 2]
-## Cách hoạt động
-Hướng dẫn chi tiết từng bước cho AI...
-## Ví dụ
-### Ví dụ 1
-\`\`\`
-code ví dụ ở đây
-\`\`\`
-## Thực hành tốt nhất
-- ✅ Nên làm điều này
-- ❌ Không nên làm điều này
-```
-#### 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ế độ thông thường
-npm run validate
-# Chế độ nghiêm ngặt (chế độ mà hệ thống CI sẽ chạy)
-npm run validate:strict
-```
-Bước này sẽ kiểm tra:
-- ✅ File `SKILL.md` có tồn tại hay không.
-- ✅ Phần Frontmatter có chính xác không.
-- ✅ Tên (Name) có khớp với tên thư mục không.
-- ✅ Có vượt qua các kiểm tra của Quality Bar không.
-#### Bước 5: Gửi Kỹ năng của bạn
-```bash
-git add skills/my-awesome-skill/
-git commit -m "feat: add my-awesome-skill"
-git push origin my-branch
-```
----
-## Bản mẫu (Template) Kỹ năng (Copy & Paste)
-Tiết kiệm thời gian! Hãy sao chép bản mẫu này:
-```markdown
----
-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
-## Tổng quan
-[2-3 câu giải thích skill này làm gì]
-## Khi nào nên sử dụng Skill này
-- Sử dụng khi bạn cần [tình huống 1]
-- Sử dụng khi bạn muốn [tình huống 2]
-## Hướng dẫn Từng bước
-### 1. [Tên Bước đầu tiên]
-[Hướng dẫn chi tiết]
-## Ví dụ
-### Ví dụ 1: [Tên Trường hợp sử dụng]
-\`\`\`language
-// Code ví dụ ở đây
-\`\`\`
-## Thực hành tốt nhất
-- ✅ **Nên:** [Thực hành tốt]
-- ❌ **Không nên:** [Điều cần tránh]
-## Xử lý Sự cố
-**Vấn đề:** [Lỗi thường gặp]
-**Giải pháp:** [Cách khắc phục]
-```
----
-## Hướng dẫn về Thông điệp Commit (Commit Message)
-Sử dụng các tiền tố sau:
-- `feat:` - Kỹ năng mới hoặc tính năng lớn.
-- `docs:` - Cải thiện tài liệu hướng dẫn.
-- `fix:` - Sửa lỗi.
-- `refactor:` - Cải thiện code mà không thay đổi chức năng.
-- `test:` - Thêm hoặc cập nhật các bài kiểm tra.
-- `chore:` - Các tác vụ bảo trì.
-**Ví dụ:**
-```
-feat: add kubernetes-deployment skill
-docs: improve getting started guide
-fix: correct typo in stripe-integration skill
-```
----
-## Tài liệu Học tập
-### Bạn mới sử dụng Git/GitHub?
-- [Hướng dẫn Hello World của GitHub](https://guides.github.com/activities/hello-world/)
-- [Cơ bản về Git](https://git-scm.com/book/en/v2/Git-Basics-Getting-a-Git-Repository)
-### Bạn mới sử dụng Markdown?
-- [Hướng dẫn Markdown](https://www.markdownguide.org/basic-syntax/)
----
-## Quy tắc Ứng xử (Code of Conduct)
-- Luôn tôn trọng và hòa nhập.
-- Chào đón những người mới.
-- Tập trung vào các phản hồi mang tính xây dựng.
-- **Không chứa nội dung gây hại**: Xem `docs/vietnamese/SECURITY_GUARDRAILS.md`.
----
-**Cảm ơn bạn đã làm cho dự án này trở nên tốt đẹp hơn cho mọi người!**
-Mọi sự đóng góp, dù nhỏ đến đâu, đều tạo nên sự khác biệt. Dù bạn sửa một lỗi chính tả, cải thiện một câu văn, hay tạo ra một kỹ năng hoàn toàn mới - bạn đang giúp đỡ hàng ngàn lập trình viên khác!

package/bundled-skills/docs/vietnamese/EXAMPLES.vi.md DELETED Viewed

@@ -1,56 +0,0 @@
-# 🧪 Ví dụ Thực tế ("Sổ tay Nấu ăn Antigravity")
-Các kỹ năng (skills) vốn dĩ đã mạnh mẽ khi đứng riêng lẻ, nhưng chúng sẽ trở nên không thể ngăn cản khi được kết hợp lại với nhau.
-Dưới đây là ba tình huống phổ biến và cách giải quyết chúng bằng cách sử dụng repository này.
-## 🥘 Công thức 1: "Kiểm tra Code cũ (Legacy Code Audit)"
-_Tình huống: Bạn vừa tiếp nhận một repository Node.js 5 năm tuổi đang rất hỗn loạn. Bạn cần sửa nó một cách an toàn._
-**Các Skill sử dụng:**
-1. `concise-planning` (Để lập bản đồ cho sự hỗn loạn)
-2. `lint-and-validate` (Để tìm ra lỗi)
-3. `security-audit` (Để tìm ra lỗ hổng bảo mật)
-**Quy trình làm việc (Workflow):**
-1. **Lập kế hoạch**: "Agent, hãy dùng `concise-planning` để tạo một danh sách kiểm tra (checklist) cho việc tái cấu trúc (refactoring) file `src/legacy-api.js`."
-2. **Kiểm tra**: "Chạy `security-audit` trên file `package.json` để tìm các thư viện phụ thuộc có lỗ hổng bảo mật."
-3. **Sửa lỗi**: "Sử dụng các quy tắc của `lint-and-validate` để tự động sửa các lỗi định dạng trong thư mục `src/`."
----
-## 🥘 Công thức 2: "Ứng dụng Web hiện đại"
-_Tình huống: Bạn cần xây dựng một trang Landing Page hiệu suất cao trong vòng 2 giờ._
-**Các Skill sử dụng:**
-1. `frontend-design` (Để đảm bảo tính thẩm mỹ)
-2. `react-patterns` (Để xây dựng cấu trúc)
-3. `tailwind-mastery` (Để tăng tốc độ triển khai)
-**Quy trình làm việc (Workflow):**
-1. **Thiết kế**: "Hãy sử dụng `frontend-design` để tạo bảng màu và kiểu chữ cho một 'Quán cà phê phong cách Cyberpunk'."
-2. **Khởi tạo**: "Khởi tạo một dự án Vite. Sau đó áp dụng `react-patterns` để tạo component 'Hero'."
-3. **Định dạng kiểu dáng**: "Sử dụng `tailwind-mastery` để làm cho các nút bấm có hiệu ứng glassmorphic (hiệu ứng kính mờ) và phản hồi tốt trên nhiều thiết bị (responsive)."
----
-## 🥘 Công thức 3: "Kiến trúc sư Agent"
-_Tình huống: Bạn muốn xây dựng một trợ lý AI (agent) tùy chỉnh có khả năng tự xác minh mã code của chính nó._
-**Các Skill sử dụng:**
-1. `mcp-builder` (Để xây dựng công cụ)
-2. `agent-evaluation` (Để kiểm tra độ tin cậy)
-3. `prompt-engineering` (Để trau chuốt các hướng dẫn)
-**Quy trình làm việc (Workflow):**
-1. **Xây dựng**: "Sử dụng `mcp-builder` để tạo một công cụ `verify-file`."
-2. **Hướng dẫn**: "Áp dụng các mẫu `prompt-engineering` vào System Prompt để agent luôn kiểm tra lại đường dẫn file."
-3. **Kiểm tra**: "Chạy `agent-evaluation` để đo lường tần suất agent thất bại trong việc tìm file."

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

@@ -1,195 +0,0 @@
-# ❓ Câu hỏi thường gặp (FAQ)
-**Bạn có thắc mắc?** Bạn không hề cô đơn! Dưới đây là câu trả lời cho những câu hỏi thường gặp nhất về Agentic Awesome Skills.
----
-## 🎯 Câu hỏi Chung
-### "Skills" (kỹ năng) chính xác là gì?
-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 1,936 skills không?
-**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.
-### Những công cụ AI nào hoạt động với các kỹ năng này?
-- ✅ **Claude Code** (Dòng lệnh CLI của Anthropic)
-- ✅ **Gemini CLI** (Google)
-- ✅ **Codex CLI** (OpenAI)
-- ✅ **Cursor** (IDE tích hợp AI)
-- ✅ **Antigravity IDE**
-- ✅ **OpenCode**
-- 🧪 **GitHub Copilot** (hỗ trợ preview qua GitHub CLI `gh skill`)
-Với Copilot, `gh skill` hiện vẫn ở trạng thái preview. Repository lớn này có cả bản canonical và bản mirror trong plugin, vì vậy hãy dùng đường dẫn chính xác; chỉ dùng `--all` khi bạn thực sự muốn cài mọi bản được phát hiện:
-```bash
-gh skill preview sickn33/agentic-awesome-skills skills/brainstorming/SKILL.md
-gh skill install sickn33/agentic-awesome-skills skills/brainstorming/SKILL.md --agent github-copilot --scope user --pin v14.2.0
-```
-### Những kỹ năng này có được sử dụng miễn phí không?
-**Có!** Repository này được cấp phép theo giấy phép MIT License.
-- ✅ Miễn phí cho sử dụng cá nhân.
-- ✅ Miễn phí cho sử dụng thương mại.
-- ✅ Bạn có thể sửa đổi chúng.
-### Các kỹ năng có hoạt động ngoại tuyến (offline) không?
-Bản thân các file skill được lưu trữ cục bộ trên máy tính của bạn, nhưng trợ lý AI của bạn vẫn cần kết nối internet để hoạt động.
----
-## 🔒 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ì. 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`:
-- ⚪ **`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?
-**Không.** Kỹ năng là các file văn bản. Tuy nhiên, chúng *hướng dẫn* AI chạy các dòng lệnh. Nếu một skill nói "xóa toàn bộ file", một AI tuân thủ có thể sẽ thử làm việc đó.
-_Luôn kiểm tra nhãn rủi ro và xem xét mã nguồn trước khi dùng._
----
-## 📦 Cài đặt & Thiết lập
-### Tôi nên cài đặt các kỹ năng này ở đâu?
-Đường dẫn mặc định của installer là `~/.agents/skills/` cho Antigravity global:
-```bash
-npx agentic-awesome-skills
-```
-**Các đường dẫn cụ thể cho từng công cụ:**
-- Claude Code: `.claude/skills/`
-- Gemini CLI: `.gemini/skills/`
-- 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ó.** Hãy dùng lệnh cài đặt chuẩn:
-```bash
-npx agentic-awesome-skills
-```
-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?
-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
-npx agentic-awesome-skills
-# hoặc, nếu bạn tự clone repository:
-cd ~/.agents/skills
-git pull origin main
-```
----
-## 🛠️ Cách sử dụng Skills
-### Làm thế nào để gọi một kỹ năng?
-Sử dụng biểu tượng `@` theo sau là tên skill:
-```bash
-@brainstorming giúp tôi thiết kế một ứng dụng todo
-```
-### Tôi có thể dùng nhiều kỹ năng cùng một lúc không?
-**Có!** Bạn có thể gọi nhiều kỹ năng:
-```bash
-@brainstorming giúp tôi thiết kế phần này, sau đó dùng @writing-plans để tạo danh sách nhiệm vụ.
-```
-### Làm thế nào để tôi biết nên dùng kỹ năng nào?
-1. **Duyệt qua danh mục**: Xem [Danh mục Skill (Skill Catalog)](../../CATALOG.md).
-2. **Tìm kiếm**: `ls skills/ | grep "từ-khóa"`
-3. **Hỏi AI của bạn**: "Bạn có kỹ năng nào để kiểm thử (testing) không?"
----
-## 🏗️ Xử lý sự cố
-### Trợ lý AI của tôi không nhận diện được kỹ năng
-**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ử 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?
-### Một kỹ năng đưa ra lời khuyên sai hoặc lỗi thời
-Hãy [Mở một issue](https://github.com/sickn33/agentic-awesome-skills/issues)!
-Vui lòng gửi kèm:
-- Skill nào?
-- Điều gì đã xảy ra?
-- Đáng lẽ điều gì nên xảy ra?
----
-## 🤝 Đóng góp
-### Tôi là người mới đối với mã nguồn mở. Tôi có thể đóng góp không?
-**Chắc chắn là có!** Chúng tôi chào đón những người mới bắt đầu.
-- Sửa lỗi đánh máy.
-- Thêm ví dụ.
-- Cải thiện tài liệu hướng dẫn.
-Hãy xem [CONTRIBUTING.md](../../CONTRIBUTING.md) để biết hướng dẫn chi tiết.
-### Pull Request (PR) của tôi thất bại khi kiểm tra "Quality Bar". Tại sao?
-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 `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 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.
----
-## 💡 Mẹo Chuyên nghiệp
-- Bắt đầu với `@brainstorming` trước khi xây dựng bất kỳ thứ gì mới.
-- Sử dụng `@systematic-debugging` khi gặp lỗi khó nhằn.
-- Thử `@test-driven-development` để code có chất lượng tốt hơn.
-- Khám phá `@skill-creator` để tự tạo kỹ năng của riêng bạn.
-**Vẫn còn thắc mắc?** [Mở một cuộc thảo luận (Discussion)](https://github.com/sickn33/agentic-awesome-skills/discussions) và chúng tôi sẽ giúp bạn! 🙌

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

@@ -1,123 +0,0 @@
-# Hướng dẫn Bắt đầu với Agentic Awesome Skills (V14.0.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.**
----
-## 🤔 "Skills" (Kỹ năng) là gì?
-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.
----
-## ⚡️ Khởi động nhanh: Các "Gói khởi đầu" (Starter Packs)
-Đừng lo lắng về con số hơn 1,936 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
-Khuyến nghị dùng installer CLI. Mặc định, lệnh này cài vào `~/.agents/skills` cho Antigravity global:
-```bash
-npx agentic-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)):
-| Vai trò               | Tên Gói kỹ năng | Bên trong có những gì?                            |
-| :-------------------- | :-------------- | :------------------------------------------------ |
-| **Web Developer**     | `Web Wizard`    | React Patterns, Tailwind mastery, Frontend Design |
-| **Security Engineer** | `Hacker Pack`   | OWASP, Metasploit, Pentest Methodology            |
-| **Manager / PM**      | `Product Pack`  | Brainstorming, Planning, SEO, Strategy            |
-| **Cơ bản cho tất cả** | `Essentials`    | Clean Code, Planning, Validation (Những thứ cơ bản nhất) |
----
-## 🚀 Cách sử dụng một Skill
-Sau khi cài đặt, bạn chỉ cần trò chuyện với AI một cách tự nhiên.
-### Ví dụ 1: Lập kế hoạch cho một Tính năng (**Essentials**)
-> "Sử dụng **@brainstorming** để giúp tôi thiết kế một luồng đăng nhập mới."
-**Điều gì sẽ xảy ra:** AI sẽ tải kỹ năng brainstorming, đặt cho bạn các câu hỏi có cấu trúc và tạo ra một bản đặc tả chuyên nghiệp.
-### Ví dụ 2: Kiểm tra Code của bạn (**Web Wizard**)
-> "Chạy **@lint-and-validate** trên file này và sửa các lỗi."
-**Điều gì sẽ xảy ra:** AI sẽ tuân theo các quy tắc linting nghiêm ngặt được định nghĩa trong skill để làm sạch code của bạn.
-### Ví dụ 3: Kiểm tra Bảo mật (**Hacker Pack**)
-> "Sử dụng **@api-security-best-practices** để xem xét các endpoint API của tôi."
-**Điều gì sẽ xảy ra:** AI sẽ kiểm tra code của bạn dựa trên các tiêu chuẩn OWASP.
----
-## 🔌 Các công cụ được hỗ trợ
-| Công cụ          | Trạng thái      | Đường dẫn         |
-| :--------------- | :-------------- | :---------------- |
-| **Claude Code**  | ✅ Hỗ trợ đầy đủ | `.claude/skills/` hoặc Claude plugin marketplace |
-| **Gemini CLI**   | ✅ Hỗ trợ đầy đủ | `.gemini/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**      | 🧪 Hỗ trợ preview qua `gh skill` | Dùng GitHub CLI với đường dẫn skill chính xác |
-> **GitHub Copilot (preview):** `gh skill` hiện vẫn ở trạng thái preview. Vì repository lớn này có cả bản canonical và bản mirror trong plugin, hãy dùng đường dẫn chính xác để tránh nhầm lẫn; chỉ dùng `--all` khi bạn thực sự muốn cài mọi bản được phát hiện:
->
-> ```bash
-> gh skill preview sickn33/agentic-awesome-skills skills/brainstorming/SKILL.md
-> gh skill install sickn33/agentic-awesome-skills skills/brainstorming/SKILL.md --agent github-copilot --scope user --pin v14.2.0
-> ```
----
-## 🛡️ 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ì. 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`:
-- ⚪ **`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 đủ._
----
-## ❓ FAQ
-**H: Tôi có cần cài đặt tất cả 1,936+ 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?**
-Đ: Có! Sử dụng kỹ năng **@skill-creator** để tự xây dựng.
-**H: Nó có miễn phí không?**
-Đ: Có, Giấy phép MIT. Mã nguồn mở mãi mãi.
----
-## ⏭️ Các bước tiếp theo
-1. [Duyệt qua các Gói kỹ năng (Bundles)](BUNDLES.vi.md)
-2. [Xem các Ví dụ thực tế (Examples)](EXAMPLES.vi.md)
-3. [Đóng góp một Skill mới](../../CONTRIBUTING.md)

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

@@ -1,69 +0,0 @@
-# 🏆 Tiêu chuẩn Chất lượng & Xác thực
-Để biến **Agentic Awesome Skills** từ một tập hợp các script thành một nền tảng đáng tin cậy, mỗi skill (kỹ năng) phải đáp ứng một tiêu chuẩn cụ thể về chất lượng và an toàn.
-## Huy hiệu "Đã xác thực" (Validated) ✅
-Một skill chỉ nhận được huy hiệu "Đã xác thực" nếu nó vượt qua **5 bước kiểm tra tự động** sau:
-### 1. Tính toàn vẹn của siêu dữ liệu (Metadata Integrity)
-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.
-- `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")
-Skill BẮT BUỘC phải có một phần nêu rõ thời điểm nên kích hoạt nó.
-- **Tốt**: "Sử dụng khi người dùng yêu cầu debug (gỡ lỗi) một component React."
-- **Tệ**: "Skill này giúp bạn xử lý code."
-### 3. Phân loại An toàn & Rủi ro
-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).
-- 🔴 **offensive**: Các công cụ Pentesting/Red Team. **BẮT BUỘC** phải có cảnh báo "Chỉ dành cho mục đích sử dụng đã được cấp phép".
-### 4. Ví dụ thực tế (Copy-Pasteable)
-Ít nhất một khối code hoặc ví dụ tương tác mà người dùng (hoặc agent) có thể sử dụng ngay lập tức.
-### 5. Giới hạn rõ ràng (Explicit Limitations)
-Danh sách các trường hợp biên hoặc những việc mà skill _không thể_ thực hiện.
-- _Ví dụ_: "Không hoạt động trên Windows nếu không có WSL."
----
-## Các cấp độ Hỗ trợ
-Chúng tôi cũng phân loại skill dựa trên người duy trì chúng:
-| Cấp độ        | Huy hiệu | Ý nghĩa                                              |
-| :------------ | :------- | :--------------------------------------------------- |
-| **Official**  | 🟣       | Do đội ngũ cốt lõi duy trì. Độ tin cậy cao.          |
-| **Community** | ⚪       | Do cộng đồng đóng góp. Hỗ trợ theo khả năng tốt nhất. |
-| **Verified**  | ✨       | Skill cộng đồng đã vượt qua vòng kiểm duyệt thủ công chuyên sâu. |
----
-## Cách Xác thực Skill của bạn
-Chạy validator trước khi gửi Pull Request (PR):
-```bash
-npm run validate
-npm run validate:strict
-```