[FREE EBOOK] Cài Skill từ GitHub không cần Terminal: Hướng dẫn cho người mới

Cài Skill từ GitHub: không cần tự dùng Terminal

Cẩm nang thực hành cho người mới: cài Find Skills vào Antigravity IDE bằng AI Agent, 3 prompt dán sẵn, cách kiểm tra Skill đã được nạp, bảng chọn Skill đáng thử và bảng xử lý lỗi. Tác giả Liên Lê, Vinalink Media.

⬇ Tải ebook PDF miễn phí

Hoặc xem trước trên Google Drive

Ebook Cài Skill từ GitHub hướng dẫn những gì?

Ebook hướng dẫn cài Find Skills vào một dự án Antigravity IDE nhờ AI Agent, kiểm tra Skill đã được nhận diện và thực hành tìm Skill theo một việc SEO cụ thể.

Đối tượng là người làm marketing, SEO, content và chủ doanh nghiệp muốn dùng AI nhưng chưa biết lập trình. Cả quy trình xoay quanh một chuỗi: GitHub, AI Agent, rồi file SKILL.md nằm đúng chỗ trong dự án.

Điều mình đánh giá cao ngay từ trang đầu là ebook có một mục gọi là "lời hứa có giới hạn". Bạn không phải tự gõ lệnh Terminal, nhưng để tìm Skill qua Skills CLI, Agent vẫn có thể phải chạy lệnh sau khi bạn cho phép. Ebook cũng nói thẳng đây là cẩm nang hướng dẫn, chưa phải kết quả kiểm thử thành công trên máy người mới.

Một tài liệu dám ghi giới hạn của chính nó thì dễ tin hơn một tài liệu hứa "cài trong 1 phút". Bạn nên đọc ebook với tâm thế đó: đây là lộ trình có điểm kiểm tra, không phải nút bấm thần kỳ.

Antigravity IDE, Find Skills và Skills CLI khác nhau thế nào?

Antigravity IDE là môi trường làm việc có AI Agent. Find Skills là bộ hướng dẫn giúp AI tìm Skill khác. Skills CLI là công cụ chạy lệnh để tìm và cài Skill.

Nhiều người mới nghĩ Find Skills là một phần mềm. Thật ra nó chỉ là một file chữ dặn AI cách đi tìm Skill khác, giống tờ hướng dẫn "muốn tìm sách thì xem kệ nào trước" dán ở cửa thư viện. Việc tìm thật vẫn do Skills CLI làm.

Theo tài liệu của Google, Antigravity nạp Skill theo ba bước. Khi bắt đầu hội thoại, Agent chỉ thấy tên và mô tả của các Skill có sẵn. Thấy Skill nào liên quan, Agent mới đọc toàn bộ SKILL.md, rồi làm theo hướng dẫn trong đó. Vì vậy bạn không cần gọi tên Skill, nhưng gọi tên sẽ chắc ăn hơn.

Cần chuẩn bị gì trước khi cài Skill từ GitHub?

Bạn cần Antigravity IDE đã cài, một thư mục dự án để thực hành, kết nối Internet, quyền tạo file trong dự án và không đưa dữ liệu khách hàng nhạy cảm vào dự án thử.

Danh sách chuẩn bị của ebook ngắn gọn, nhưng mục cuối rất đáng chú ý: chưa đưa dữ liệu khách hàng nhạy cảm vào dự án thử. Agent có quyền đọc file trong workspace, còn Skill tải từ cộng đồng chưa được kiểm chứng. Dự án thực hành nên là một thư mục trống, ví dụ AI-SKILL-PRACTICE.

Ebook dẫn hai nguồn chính thức: file SKILL.md của Find Skills trong repo vercel-labs/skills trên GitHub và trang tài liệu Skills của Antigravity. Mình đã mở cả hai để đối chiếu, kết quả nằm ở các mục bên dưới.

Có một điều kiện ebook nhắc ở Bước 4 mà bạn nên biết sớm: theo ebook, Skills CLI yêu cầu Node.js 22.20 trở lên. Nếu máy chưa có Node.js, phần cài Find Skills vẫn làm được, nhưng phần tìm Skill bằng CLI sẽ dừng lại.

Giao AI Agent cài Find Skills vào Antigravity như thế nào?

Mở dự án và bảng Agent, dán prompt yêu cầu lấy đúng find-skills từ repo chính thức, tạo thư mục .agents/skills/find-skills/ và xin xác nhận trước khi sửa file.

Bước 1 là mở Antigravity IDE, mở hoặc tạo thư mục dự án rồi mở bảng Agent. Dấu hiệu đạt là bạn thấy thư mục dự án và gửi được tin nhắn cho Agent. Agent chưa sẵn sàng thì kiểm tra đăng nhập và kết nối.

Bước 2 là thao tác trọng tâm. Thay vì tự tải file từ GitHub, bạn giao cho Agent làm. Prompt mẫu của ebook yêu cầu năm việc: xác định đúng Skill find-skills trong repo, kiểm tra file SKILL.md gốc, tạo thư mục .agents/skills/find-skills/ trong workspace, sao chép nguyên nội dung SKILL.md cùng tài nguyên phụ nếu có và không sửa file không liên quan.

Hai câu cuối của prompt mới là phần đáng giữ: trình bày thay đổi và xin xác nhận trước khi tạo hoặc sửa file, không chạy lệnh Terminal khi chưa được chấp thuận. Agent cũng phải báo cáo file đã tạo, đường dẫn, những gì đã kiểm tra và những gì chưa xác minh được.

Mình đối chiếu với tài liệu của Google: Skill cấp dự án đúng là nằm ở .agents/skills/tên-skill/ trong gốc workspace. Antigravity vẫn đọc được thư mục cũ .agent/skills. Skill dùng cho mọi dự án thì nằm trong thư mục cấu hình chung của người dùng.

Nếu Agent không đọc được GitHub, ebook chỉ cách làm tay: mở file gốc trên trình duyệt, bấm Raw, sao chép toàn bộ rồi lưu vào SKILL.md. Đừng chỉ chép phần tiêu đề mà bỏ phần hướng dẫn. Nếu nguồn không xác định hoặc Agent đề nghị chạy mã không rõ mục đích thì dừng lại.

Làm sao biết Antigravity đã nhận diện Skill?

Mở mục Customizations trong thanh bên Agent của Antigravity IDE và tìm find-skills. File có trong thư mục chưa có nghĩa là Agent đã nạp được Skill.

Bước 3 của ebook tách hai chuyện hay bị nhập làm một: file tồn tại và Skill được nạp. Agent có thể báo "đã cài xong" trong khi Skill không hiện trong danh sách vì sai tên thư mục, sai vị trí hoặc thiếu phần mô tả ở đầu file.

Tài liệu của Google xác nhận danh sách Skill đang hoạt động nằm trong menu Customizations ở thanh bên Agent. Trong phần đầu của SKILL.md, trường description là bắt buộc vì Agent dựa vào nó để quyết định có dùng Skill hay không. Trường name không bắt buộc, bỏ trống thì Antigravity lấy tên thư mục.

Prompt kiểm tra của ebook yêu cầu Agent xác minh đường dẫn SKILL.md, phần mô tả và việc Antigravity có nhận diện Skill hay không, phân biệt rõ file tồn tại với Skill thực sự được nạp và không tự tuyên bố thành công khi chưa kiểm tra được.

Câu "không tự tuyên bố thành công" là câu bạn nên mang theo cho mọi việc giao AI Agent. Agent rất hay báo xong việc bằng giọng tự tin, kể cả khi bước cuối chưa chạy.

Dùng Find Skills tìm Skill cho việc SEO ra sao?

Mô tả công việc thay vì đoán tên Skill. Agent tự chọn từ khóa, tìm qua Skills CLI nếu được phép và trả về tối đa 5 ứng viên kèm nguồn và link gốc.

Bước 4 dùng một tình huống quen thuộc: bạn đang viết bài SEO và muốn AI kiểm tra nội dung đã đúng ý định tìm kiếm chưa, còn thiếu câu hỏi quan trọng nào và phần nào cần bổ sung. Prompt yêu cầu Agent xác định từ khóa tìm kiếm phù hợp, chỉ tìm khi môi trường đã có Skills CLI và được cấp quyền.

Kết quả cần có tên Skill, nguồn gốc, link gốc, công việc Skill hỗ trợ và những gì chưa kiểm chứng. Hai ràng buộc quan trọng là không cài Skill mới khi chưa có đồng ý và không tự tạo kết quả tìm kiếm nếu công cụ không hoạt động.

Lệnh tìm theo tài liệu là npx skills find seo. Bạn không phải tự gõ, nhưng nên nhìn thấy lệnh này trong yêu cầu xin quyền của Agent để biết nó đang làm gì.

Ebook nói rõ danh sách ứng viên chưa phải bằng chứng Skill nào đáp ứng tốt công việc. Đây đúng là chỗ nhiều người vấp: thấy tên Skill có chữ "SEO" là cài ngay.

Bên trong Find Skills hướng dẫn AI làm gì?

Find Skills dặn AI xem bảng xếp hạng skills.sh trước, rồi mới tìm bằng CLI, kiểm tra lượt cài và uy tín nguồn, trình bày lựa chọn và chỉ cài khi bạn đồng ý.

Mình mở file SKILL.md gốc của Find Skills để xem thêm phần ebook không trình bày. Skill dặn AI làm bảy việc: xác định lĩnh vực và tác vụ, xem bảng xếp hạng trên skills.sh, tìm bằng lệnh CLI nếu chưa có, kiểm tra chất lượng, trình bày lựa chọn kèm lệnh cài và link, cài khi người dùng đồng ý, cuối cùng nói rõ nếu không tìm thấy gì.

Tiêu chí chất lượng trong Skill khá cụ thể: ưu tiên Skill có trên 1.000 lượt cài, xét uy tín nguồn và xem repo dưới 100 sao với thái độ hoài nghi. Đây là tiêu chí về độ phổ biến, không phải đánh giá an toàn. Một Skill nhiều lượt cài vẫn có thể chứa script bạn không muốn chạy.

Có một chi tiết bạn nên biết. Lệnh cài mẫu trong Find Skills có cờ -y, nghĩa là bỏ qua bước xác nhận khi cài. Nếu muốn giữ quyền duyệt, bạn nên thêm vào prompt: "không dùng cờ -y, hỏi tôi trước mỗi lần cài". Phần prompt của ebook đã yêu cầu xin đồng ý trước khi cài, nhưng nói rõ thêm vẫn an toàn hơn.

Làm sao nhận biết một Skill đáng thử?

Ebook đưa bảng kiểm 6 tiêu chí: nguồn và tác giả rõ, đã đọc SKILL.md, đúng việc cần làm, rõ đầu vào và kết quả, đã xem mã và quyền, thử được trên dữ liệu mẫu.

Ebook dặn chọn một ứng viên từ kết quả thật rồi mới chấm, sau đó tiếp tục xác minh các mục chưa đạt trước khi cài hoặc chạy. Mình thêm một mẹo: nhờ chính Agent tóm tắt SKILL.md của ứng viên thành ba phần là Skill làm gì, đọc file nào và chạy lệnh gì. Bạn vẫn phải tự đọc lại những chỗ có script.

Nếu bạn dùng Claude và muốn hiểu cấu trúc một Skill từ bên trong, xem thêm ebook tự tạo Skill để Claude viết theo văn phong của bạn.

Gặp lỗi khi cài Skill từ GitHub thì xử lý ra sao?

Phần lớn lỗi đến từ sai đường dẫn, mở sai thư mục gốc, thiếu Node.js hoặc Skills CLI và việc Agent báo thành công mà không có bằng chứng.

Thư mục bắt đầu bằng dấu chấm như .agents thường bị ẩn trong trình quản lý file của hệ điều hành. Nếu không thấy, hãy xem trong cây thư mục của IDE thay vì mở bằng Finder hay File Explorer.

Mỗi bước trong ebook đều có ba trạng thái PASS, RETRY và STOP. Mình thấy cách này rất hợp cho người mới, vì nó cho bạn quyền dừng lại thay vì cố đi tiếp khi đã có dấu hiệu bất thường.

Bài tập cuối ebook yêu cầu làm gì?

Bạn tự đi chuỗi công việc, năng lực cần tìm, Find Skills, danh sách ứng viên, kiểm tra Skill cho một bản nháp Facebook. Không tìm ra thì ghi NO_MATCH.

Tình huống bài tập: bạn có một bản nháp bài Facebook và muốn AI kiểm tra hook, độ rõ của thông điệp và những claim chưa có bằng chứng. Bài tập hoàn thành khi bạn có bản ghi gồm mô tả công việc, từ khóa đã dùng, tên và URL của ít nhất một ứng viên tìm được thật và nhận xét ứng viên đó có đáng thử không.

Câu kết của bài tập là câu mình thích nhất cả ebook: nếu không tìm ra, ghi NO_MATCH cùng từ khóa và lỗi gặp phải, không cần tạo ra một Skill chỉ để bài tập có kết quả đẹp. Đây là thái độ đúng với AI nói chung. Một kết quả trống trung thực có giá trị hơn một danh sách đẹp nhưng bịa.

Ebook này phù hợp với ai và còn thiếu gì?

Hợp với người mới đã cài Antigravity IDE và muốn thử Skill cộng đồng có kiểm soát. Người dùng Claude trên web cần cách cài khác vì claude.ai tải Skill bằng file zip.

Điểm mạnh là ba prompt dán sẵn có ràng buộc rõ, dấu hiệu đạt cho từng bước, cơ chế PASS, RETRY, STOP và sự thẳng thắn về giới hạn. Mọi đường dẫn quan trọng mình đối chiếu với tài liệu Google đều khớp.

Có vài giới hạn bạn nên biết.

Thứ nhất, ebook chỉ áp dụng cho Antigravity. Trên claude.ai, Skill được nén thành file zip chứa thư mục Skill rồi tải lên ở Customize > Skills. Thứ hai, câu "không cần Terminal" chỉ đúng một nửa: Agent vẫn chạy lệnh, máy vẫn cần Node.js cho phần tìm kiếm. Thứ ba, ebook ngắn, chưa có ảnh chụp giao diện thật, chính tác giả cũng ghi sơ đồ thư mục chỉ là minh họa.

Với một tài liệu 8 trang, mình thấy đây là điểm khởi đầu tốt. Hãy làm đủ bốn bước trên một dự án trống, sau đó mới đem Skill vào dự án thật.

Câu hỏi thường gặp về cài Skill từ GitHub

Cài Skill từ GitHub có thật sự không cần dùng Terminal không?

Bạn không phải tự gõ lệnh, vì AI Agent trong Antigravity làm thay. Nhưng khi tìm Skill qua Skills CLI, Agent vẫn có thể cần chạy lệnh sau khi bạn cho phép. Máy cũng cần có Node.js.

Find Skills là gì?

Find Skills là một Skill dạng file SKILL.md do Vercel Labs phát hành. Nó hướng dẫn AI Agent tìm các Skill khác theo nhu cầu của bạn và chỉ cài khi bạn đồng ý.

Skill trong Antigravity được lưu ở đâu?

Theo tài liệu của Google, Skill cấp dự án nằm trong thư mục .agents/skills/tên-skill/ ở gốc workspace. Mỗi Skill là một thư mục có file SKILL.md bắt buộc.

Làm sao biết Antigravity đã nhận Skill?

Mở mục Customizations trong thanh bên Agent của Antigravity IDE và tìm tên Skill. File tồn tại trong thư mục chưa đồng nghĩa với việc Agent đã nạp được Skill.

Agent không đọc được GitHub thì làm thế nào?

Mở file SKILL.md gốc trên trình duyệt, bấm chế độ Raw, sao chép toàn bộ nội dung rồi lưu vào file SKILL.md đúng thư mục trong IDE. Đừng chỉ chép phần tiêu đề.

Có nên cài mọi Skill mà Find Skills gợi ý không?

Không. Danh sách ứng viên chưa chứng minh Skill tốt. Hãy kiểm tra nguồn và tác giả, đọc SKILL.md, xem mã và quyền truy cập, rồi thử trên dữ liệu mẫu trước khi dùng thật.

Hướng dẫn này có dùng được cho Claude không?

Ebook viết cho Antigravity IDE. Trên claude.ai, Skill được nén thành file zip chứa thư mục Skill rồi tải lên ở Customize > Skills, nên cách cài khác với Antigravity.

Cài được Skill rồi thì học tiếp gì về AI Agent?

Cài Skill là bước đầu tiên để AI Agent làm việc theo quy trình của bạn. Bước tiếp theo là xây hệ thống để Agent chạy việc thật, có kiểm soát và đo được kết quả.

Nếu bạn muốn tự xây hệ thống AI vận hành tự động mà không cần biết lập trình, khóa Mastering Agentic AI: OpenClaw, Vibe Coding và n8n của Vinalink Academy học 8 buổi online qua Zoom, thực hành 100% trên laptop: bot trả lời 24/7, web app nội bộ và dây chuyền tự động hóa n8n.

Khóa không dạy riêng Antigravity hay Find Skills. Lịch khai giảng mới nhất bạn xem trên trang khóa học.