firefrost-gaming/antigravity-skills-reference

Files

sck_0 b03f929948 docs: move Vietnamese translations to docs/vi/

2026-01-27 18:33:18 +01:00

7.1 KiB

Raw Blame History

❓ Câu Hỏi Thường Gặp (FAQ)

Bạn có thắc mắc? Đừng lo, bạn không cô đơn đâu! Dưới đây là giải đáp cho những câu hỏi phổ biến nhất về Antigravity Awesome Skills.

🎯 Câu hỏi chung

"Skill" rốt cuộc là cái gì?

Skills thực chất là các file hướng dẫn chuyên biệt dùng để dạy cho trợ lý AI cách xử lý một tác vụ cụ thể. Hãy coi nó như những module kiến thức chuyên gia mà AI của bạn có thể "nạp" vào khi cần. Ví dụ dễ hiểu: Giống như trong phim Ma Trận, khi Neo cần biết lái trực thăng, anh ấy tải chương trình lái trực thăng vào não. Skills ở đây cũng y hệt vậy, giúp biến AI của bạn thành chuyên gia trong từng lĩnh vực (luật sư, bác sĩ, thợ máy...) tùy theo nhu cầu của bạn.

Tôi có phải cài hết hơn 250 skill không?

Không hề! Khi bạn clone cái kho này về, toàn bộ skills sẽ nằm sẵn trong máy, NHƯNG AI của bạn chỉ thực sự đọc và load kỹ năng nào mà bạn gọi tên (bằng lệnh @tên-skill) thôi. Nó giống như một thư viện sách: sách thì đầy trên kệ, nhưng bạn chỉ cần rút đúng cuốn bạn định đọc. Mẹo: Dùng các Gói Khởi Điểm (Starter Packs) để cài bộ phù hợp với công việc của bạn cho gọn.

Những công cụ AI nào dùng được mấy skill này?

✅ Claude Code (Anthropic CLI)
✅ Gemini CLI (Google)
✅ Codex CLI (OpenAI)
✅ Cursor (AI IDE)
✅ Antigravity IDE
✅ OpenCode
⚠️ GitHub Copilot (Hỗ trợ một phần, phải copy-paste thủ công)

Dùng cái này có mất phí không?

Hoàn toàn miễn phí! Dự án này dùng Giấy phép MIT.

✅ Miễn phí cho dùng cá nhân
✅ Miễn phí cho thương mại/công ty
✅ Bạn thoải mái sửa đổi code

Skills có chạy offline không?

Bản thân các file skill nằm trên máy bạn (offline), nhưng trợ lý AI (Claude, Gemini...) thì vẫn cần mạng internet để hoạt động nhé.

🔒 Độ Tin Cậy & An Toàn (Cập nhật V3)

Mấy cái "Nhãn Rủi Ro" (Risk Label) nghĩa là sao?

Để đảm bảo an toàn, chúng tôi phân loại skill theo màu:

⚪ Safe (Trắng/Xanh): Skill an toàn, chỉ đọc, lập kế hoạch hoặc vô hại.
🔴 Risk (Đỏ): Skill có khả năng chỉnh sửa/xóa file hệ thống, hoặc dùng để quét mạng (pentest). Cần cẩn trọng khi dùng.
🟣 Official (Tím): Skill chính chủ do các nhà cung cấp uy tín (Anthropic, DeepMind...) bảo trì.

Dùng skill này có sợ bị hack máy không?

Không. Skill chỉ là file văn bản (text). Tuy nhiên, nó chứa hướng dẫn để AI chạy lệnh. Nếu skill bảo "xóa hết file đi", một con AI ngây thơ có thể sẽ làm thật. Do đó: Luôn kiểm tra Nhãn Rủi Ro và đọc qua nội dung skill trước khi dùng.

📦 Cài đặt & Thiết lập

Tôi nên cài skill vào đâu?

Đường dẫn chuẩn nhất dùng được cho hầu hết công cụ là .agent/skills/:

git clone https://github.com/sickn33/antigravity-awesome-skills.git .agent/skills

Đường dẫn riêng cho từng tool:

Claude Code: .claude/skills/
Gemini CLI: .gemini/skills/
Cursor: .cursor/skills/ hoặc thư mục gốc của dự án

Dùng trên Windows có được không?

Được, nhưng lưu ý là một số skill "Official" có dùng symlinks (liên kết tượng trưng) mà Windows mặc định hỗ trợ hơi kém. Hãy chạy lệnh git này để bật hỗ trợ symlink:

git clone -c core.symlinks=true https://github.com/sickn33/antigravity-awesome-skills.git .agent/skills

Hoặc bật chế độ "Developer Mode" trong phần Settings của Windows.

Cập nhật skill kiểu gì?

Chỉ cần vào thư mục đó và pull code mới về là xong:

cd .agent/skills
git pull origin main

🛠️ Cách sử dụng

Gọi skill như thế nào?

Dùng ký tự @ cộng với tên skill:

@brainstorming giúp tôi thiết kế một app quản lý công việc

Dùng nhiều skill cùng lúc được không?

Được luôn! Bạn có thể kết hợp (combo) nhiều skill:

@brainstorming lên ý tưởng cho tôi, xong rồi dùng @writing-plans để ra list công việc cụ thể nhé.

Làm sao biết nên dùng skill nào?

Đọc file README: Xem Danh sách đầy đủ các skill.
Tìm kiếm: ls skills/ | grep "từ-khóa" (ví dụ tìm "test", "security").
Hỏi chính con AI: "Cậu có skill nào liên quan đến testing không?"

🏗️ Xử lý sự cố (Troubleshooting)

AI của tôi không nhận diện được skill

Nguyên nhân có thể:

Sai đường dẫn cài đặt: Kiểm tra lại tài liệu của tool bạn dùng. Thử đường dẫn .agent/skills/ xem sao.
Cần khởi động lại: Thử tắt đi bật lại AI/IDE sau khi cài đặt.
Gõ sai tên: Bạn có gõ @brain-storming thay vì @brainstorming không?

Skill đưa ra lời khuyên sai hoặc lỗi thời

Làm ơn hãy Báo lỗi (Open Issue) giúp chúng tôi! Nhớ ghi rõ:

Skill nào bị lỗi
Lỗi là gì
Đáng lẽ nó phải làm gì

🤝 Đóng góp (Contribution)

Tôi là người mới (newbie). Tôi đóng góp được không?

Hoan nghênh nhiệt liệt! Chúng tôi rất quý trọng các đóng góp từ người mới.

Sửa lỗi chính tả
Thêm ví dụ
Cải thiện tài liệu Xem hướng dẫn tại CONTRIBUTING.vi.md nhé.

Tôi gửi PR nhưng bị trượt bài kiểm tra "Quality Bar". Tại sao?

Bản V3 có hệ thống kiểm tra chất lượng tự động. Skill của bạn có thể đang thiếu:

Phần description (mô tả).
Các ví dụ sử dụng mẫu. Hãy chạy python3 scripts/validate_skills.py trên máy để tự kiểm tra trước khi đẩy code lên nhé.

Tôi có được sửa các skill "Official" không?

Không. Các skill Official (trong thư mục skills/official/) là bản sao (mirror) từ nhà cung cấp gốc. Nếu thấy lỗi, hãy mở Issue báo cáo thay vì sửa trực tiếp.

💡 Mẹo hay cho chuyên gia (Pro Tips)

Luôn bắt đầu bằng @brainstorming trước khi xây dựng cái gì mới.
Dùng @systematic-debugging khi bí bách vì bug.
Thử @test-driven-development để code "xịn" hơn.
Khám phá @skill-creator để tự tạo skill riêng cho mình.

Vẫn còn thắc mắc? Vào đây thảo luận nhé, chúng tôi sẽ hỗ trợ hết mình! 🙌

7.1 KiB Raw Blame History