vercel-labs/skills: cài kỹ năng cho AI lập trình bằng một lệnh — hướng dẫn cài đặt và dùng
Bài này là một góc nhìn khác về vercel-labs/skills — repo từng đổi tên nên mình viết lại với cách tiếp cận khác. Bài hướng dẫn chính: vercel-labs/skills: cài kỹ năng cho AI lập trình bằng một lệnh — hướng dẫn cài đặt và dùng →

Tóm tắt nhanh
vercel-labs/skills là công cụ dòng lệnh (gói npm tên skills) giúp tìm và cài các agent skill, tức bộ hướng dẫn dạy AI lập trình làm một việc cụ thể. Bạn chỉ cần Node.js 22.20 trở lên rồi chạy npx skills add kèm tên repo. Cài khá dễ, không cần cài đặt phức tạp.
skills là công cụ dòng lệnh để tìm, cài và quản lý các "agent skill" cho trợ lý AI lập trình. Agent skill là một bộ hướng một trang tin tức sẵn, dạy AI cách làm một việc cụ thể: từ review code cho đến dùng đúng một thư viện nào đó. Bạn gõ một lệnh npx skills add..., chọn skill và chọn AI muốn gắn vào, thế là xong.
Repo này dành cho ai đang dùng Claude Code, Codex, Cursor, OpenCode hay một trong hơn 75 agent khác mà README liệt kê. Nếu bạn là lập trình viên mới, hoặc người làm văn phòng bắt đầu nhờ AI viết code, công cụ này giúp bạn khỏi phải tự soạn hướng dẫn cho AI từ đầu. Bạn lấy skill của người khác đã viết sẵn, dùng luôn.
Điểm đáng giá nhất là một công cụ chung cho nhiều agent. Bạn không phải nhớ mỗi AI để skill ở thư mục nào. Công cụ tự nhận ra agent đã cài trên máy và hỏi bạn muốn đặt skill vào đâu. Repo hiện có khoảng 39.150 sao và 3.432 fork, dùng giấy phép MIT, và vẫn được cập nhật trong 3 tháng gần đây.
vercel-labs/skills
Công cụ dòng lệnh npx skills để tìm, cài, cập nhật và gỡ các 'skill' (bộ hướng dẫn) cho Claude Code, Codex, Cursor, OpenCode và hơn 75 agent lập trình khác.
I.skills làm được gì
Dưới đây là những việc chính, theo thứ tự bạn sẽ dùng.
Cài skill từ một repo GitHub. Lệnh npx skills add nhận tên repo, hiện danh sách skill bên trong để bạn chọn. Bạn không phải tải file thủ công hay chép vào đúng thư mục.
Chọn AI nhận skill. Một skill có thể gắn vào Claude Code, Codex, Cursor hay agent khác. Công cụ phát hiện agent đã cài và cho bạn chọn nơi cài. Bạn dùng hai AI cùng lúc cũng không phải làm hai lần.
Cài theo dự án hoặc cài chung. Mặc định skill được cài vào dự án hiện tại, nên mỗi dự án có bộ skill riêng. Thêm -g thì skill dùng được ở mọi dự án.
Tìm skill. npx skills find giúp bạn duyệt skill có sẵn, và có thể thêm từ khoá. Thư viện skill cũng có trang web riêng để xem trước.
Quản lý sau khi cài. Có lệnh xem danh sách đã cài (list), kiểm tra bản mới (check), cập nhật (update) và gỡ (remove). Skill cũng giống phần mềm khác, tác giả sẽ sửa, và bạn cần cách cập nhật gọn.
Dùng thử không cần cài. npx skills use tạo ra một câu lệnh nhắc (prompt) từ skill, hoặc mở thẳng agent được hỗ trợ kèm skill đó. Hợp khi bạn chỉ muốn thử một lần.
Tự tạo skill. npx skills init sinh sẵn một khung skill. Bạn sửa file SKILL.md thành hướng dẫn của riêng mình, ví dụ quy trình viết báo cáo của công ty.
Khoá phiên bản bằng skills-lock.json. Công cụ ghi lại skill nào đã cài, lấy từ commit nào, kèm mã băm của nội dung. Nhờ vậy cả nhóm khôi phục đúng bộ skill giống nhau, kể cả khi repo gốc đã đổi. Tính năng khôi phục này hiện còn ở dạng thử nghiệm.
II.Cần chuẩn bị gì
Theo README và package.json, bạn chỉ cần:
- Node.js 22.20 trở lên. Đây là yêu cầu duy nhất được ghi rõ. Lệnh
npxđi kèm Node nên không cần cài thêm. - Một trợ lý AI lập trình đã cài trên máy (Claude Code, Codex, Cursor, OpenCode…) để nhận skill.
- Một thư mục dự án để chạy lệnh. README dặn chạy từ dự án của bạn.
Tư liệu không nói gì về API key hay tài khoản trả phí cho chính công cụ này. Phần hệ điều hành và phần cứng cũng chưa có thông tin riêng. Đây là gói Node nên về nguyên tắc chạy ở nơi Node 22.20 chạy được, nhưng bạn nên thử trực tiếp trên máy mình.
Nếu chưa có Node, hãy cài Node.js bản 22.20 trở lên từ trang chủ Node.js. Sau đó mở terminal và gõ node -v để xem phiên bản.
III.Cài đặt từng bước
- Kiểm tra NodeXem máy đã có Node.js 22.20 trở lên chưa
- Mở thư mục dự ánMở terminal ngay trong dự án bạn muốn gắn skill
- Chạy lệnh addGõ npx skills add kèm tên repo chứa skill
- Chọn skill và agentTích chọn skill và AI muốn cài vào
- Kiểm tra danh sáchDùng npx skills list để xem skill đã cài
A.Kiểm tra phiên bản Node
Mở terminal (PowerShell trên Windows, Terminal trên macOS) và gõ lệnh dưới đây. Kết quả cần là 22.20 hoặc cao hơn. Nếu thấp hơn, bạn cần nâng cấp Node trước, nếu không lệnh sau có thể báo lỗi.
node -vB.Mở terminal đúng thư mục dự án
Đây là chỗ người mới hay vấp. Mặc định skill được cài vào dự án hiện tại, nên bạn phải đứng đúng thư mục dự án khi chạy lệnh. Ví dụ:
cd ten-thu-muc-du-an-cua-banThay ten-thu-muc-du-an-cua-ban bằng thư mục thật của bạn. Nếu chạy nhầm chỗ, skill sẽ nằm sai dự án.
C.Cài skill đầu tiên
README dùng repo mẫu vercel-labs/agent-skills làm ví dụ. Bạn chạy:
npx skills add vercel-labs/agent-skillsLần đầu npx có thể hỏi tải gói skills, bạn đồng ý là được. Sau đó công cụ cho bạn chọn skill và chọn agent để cài vào. Chọn xong, nó sẽ tự đặt file vào đúng chỗ.
Muốn cài dùng chung cho mọi dự án, thêm -g:
npx skills add vercel-labs/agent-skills -gD.Cài đúng một skill cho đúng một agent
Nếu đã biết mình cần gì, bạn bỏ qua bước chọn bằng cách chỉ rõ. Lệnh này cài skill web-design-guidelines cho Claude Code:
npx skills add vercel-labs/agent-skills --skill web-design-guidelines -a claude-code--skill là tên skill, -a là tên agent. Muốn biết tên agent khác viết thế nào, xem phần Supported agents trong tài liệu của repo, hoặc chạy npx skills --help.
E.Duyệt skill có sẵn
Chưa biết cài gì thì cứ tìm:
npx skills findBạn cũng có thể thêm từ khoá sau find để lọc, theo dạng npx skills find [query] trong README.
README còn nhắc tới tài liệu về nguồn cài khác nhau và repo riêng tư (private). README chính chưa ghi chi tiết, bạn xem trong thư mục docs/ của repo.
IV.Kiểm tra đã chạy được chưa
Sau khi cài, chạy lệnh liệt kê:
npx skills listNếu skill vừa cài hiện trong danh sách thì xem như thành công. README cũng nói skill của dự án nằm trong thư mục .agents/skills/<tên-skill>, nên bạn có thể mở thư mục này để thấy file thật.
Cách thử cuối cùng là mở AI lập trình của bạn trong dự án đó và nhờ nó làm đúng việc skill hướng dẫn. Tư liệu chưa mô tả màn hình cụ thể của từng agent, nên bạn nhìn xem AI có nhắc tới hoặc làm theo skill không.
Cần xem công cụ còn lệnh nào khác, gõ:
npx skills --helpV.Dùng vào việc thật
A.Lập trình viên mới muốn AI làm giao diện web gọn gàng hơn
Bạn đang làm một trang web nhỏ với Claude Code. AI viết được nhưng giao diện hay lệch chuẩn. Bạn mở terminal trong dự án và cài skill hướng dẫn thiết kế có trong repo mẫu:
npx skills add vercel-labs/agent-skills --skill web-design-guidelines -a claude-codeSau đó bạn nhờ AI rà lại giao diện. Skill đóng vai bộ quy tắc để AI đối chiếu, nên bạn đỡ phải tự gõ lại các yêu cầu mỗi lần.
Skill là cuốn sổ tay bạn đưa cho AI, để nó làm việc theo cách bạn muốn thay vì đoán mò.
Ông T
B.Người chỉ muốn thử một lần, không muốn cài
Bạn tò mò một skill nhưng chưa muốn nó nằm trong dự án. Dùng use:
npx skills use vercel-labs/agent-skills@web-design-guidelines --agent claude-codeCó --agent, công cụ mở agent được hỗ trợ kèm skill. Bỏ --agent đi thì nó chỉ in ra đoạn prompt, bạn chép dán vào AI nào cũng được. Cách này hợp với người dùng AI qua khung chat thông thường.
C.Nhóm nhỏ muốn ai cũng có cùng bộ skill
Công ty bạn có vài người cùng làm một dự án. Skill được ghi lại trong skills-lock.json. Khi một người mới vào nhóm, README nói bạn có thể khôi phục skill đã ghi bằng lệnh thử nghiệm này:
npx skills experimental_installREADME cho biết skills install lấy đúng commit đã ghi, nên nội dung khớp với mã băm kể cả khi repo gốc đã thay đổi. Vì lệnh mang tiền tố experimental_, tên và cách chạy có thể đổi ở bản sau. Hãy kiểm tra npx skills --help trước khi đưa vào quy trình chính thức.
D.Chủ doanh nghiệp nhỏ muốn đóng gói quy trình riêng thành skill
Bạn có một quy trình lặp đi lặp lại, ví dụ cách viết mô tả sản phẩm theo giọng thương hiệu của shop. Tạo khung skill:
npx skills init my-skillSau đó mở file SKILL.md vừa sinh ra và viết hướng dẫn cho AI bằng ngôn ngữ thường. Định dạng chi tiết (phần đầu file, cách đặt repo) có trong tài liệu Creating skills ở repo. Khi viết xong bạn có thể cài lại cho chính mình, hoặc chia sẻ cho nhân viên.
Skill là hướng dẫn mà AI sẽ làm theo, nên hãy cài từ nguồn bạn tin tưởng và đọc qua file SKILL.md trước khi dùng. Với repo riêng tư, đừng đưa token hay mật khẩu vào file skill hoặc dán lên chỗ công khai.
VI.Lỗi hay gặp và cách xử lý
Báo lỗi phiên bản Node hoặc lệnh không chạy. Nguyên nhân thường là Node cũ hơn 22.20. Chạy node -v kiểm tra, cài bản mới rồi mở terminal mới và thử lại.
Skill cài xong nhưng AI không dùng. Có thể bạn chạy lệnh sai thư mục, hoặc chọn nhầm agent. Chạy lại npx skills list để xem skill nằm ở đâu, và đảm bảo mở AI trong đúng dự án. Nếu đã chọn sai agent, bạn gỡ bằng npx skills remove rồi cài lại.
Không tìm thấy repo hoặc skill. Kiểm tra lại cách viết tên repo (dạng chu-so-huu/ten-repo) và tên skill. Với repo riêng tư, bạn cần quyền truy cập; xem tài liệu cài đặt trong thư mục docs/ của repo.
Lệnh thử nghiệm đổi hoặc biến mất. Các lệnh bắt đầu bằng experimental_ có thể thay đổi bất cứ lúc nào mà không báo trước. Đừng dựa vào chúng cho việc quan trọng khi chưa kiểm tra lại sau mỗi lần nâng cấp.
Lo ngại về dữ liệu gửi đi. Công cụ thu thập dữ liệu sử dụng ẩn danh. Nếu muốn tắt, đặt biến môi trường DISABLE_TELEMETRY=1 hoặc DO_NOT_TRACK=1. README nói hai biến này cũng tắt luôn các yêu cầu kiểm tra bảo mật (security-audit). Với mọi sự cố khác, README có chỉ tới mục Troubleshooting trong tài liệu.
VII.Có nên dùng không
Điểm mạnh. Cài một lệnh, dùng chung cho nhiều AI, có đủ lệnh tìm, cập nhật, gỡ. Hỗ trợ khoá phiên bản để nhóm dùng giống nhau. Giấy phép MIT, repo còn được duy trì và có cộng đồng lớn.
Giới hạn. Bạn cần quen dùng terminal và có Node 22.20 trở lên. Công cụ chỉ giúp cài và quản lý; chất lượng cuối cùng phụ thuộc vào từng skill bạn chọn. Một số tính năng, như khôi phục theo skills-lock.json, vẫn là thử nghiệm. Công cụ cũng có thu thập dữ liệu ẩn danh, bạn phải tự tắt nếu không muốn.
Khi nên chọn cách khác. Nếu bạn không dùng AI lập trình, hoặc chỉ cần vài dòng hướng dẫn cố định, tự viết vào file hướng dẫn của AI đang dùng sẽ đơn giản hơn. Còn nếu bạn dùng nhiều AI, làm việc nhóm, hoặc muốn có kho skill dùng lại được, skills là lựa chọn đáng thử. Hãy bắt đầu bằng một skill nhỏ, kiểm tra kết quả, rồi mở rộng dần.
Câu hỏi thường gặp
skills có miễn phí không?
Repo dùng giấy phép MIT nên dùng tự do. Tư liệu không nhắc tới phí hay tài khoản trả phí cho chính công cụ này. Chi phí của AI lập trình bạn đang dùng thì tính riêng theo nhà cung cấp.
Cần cài gì trước khi dùng?
Bạn cần Node.js 22.20 trở lên và một AI lập trình được hỗ trợ như Claude Code, Codex, Cursor hay OpenCode. Lệnh chạy bằng npx nên không cần cài tay gói skills.
Có chạy được trên Windows không?
Tư liệu không nói riêng về hệ điều hành. Công cụ là gói Node nên chạy được ở nơi có Node 22.20 trở lên, nhưng bạn nên thử trực tiếp trên máy của mình.
Agent skill là gì?
Là bộ hướng dẫn dùng lại được, dạy AI lập trình làm một việc cụ thể, từ review code đến dùng một thư viện. Skill nằm trong file SKILL.md và công cụ này giúp bạn cài chúng vào đúng chỗ.
Có cần GPU hay API key không?
Tư liệu không yêu cầu GPU hay API key cho chính công cụ skills. Việc AI chạy thế nào do agent bạn dùng quyết định.
Dữ liệu của tôi có được gửi đi không?
Công cụ thu thập dữ liệu sử dụng ẩn danh. Bạn đặt DISABLE_TELEMETRY=1 hoặc DO_NOT_TRACK=1 để tắt, và hai biến này cũng tắt các yêu cầu kiểm tra bảo mật. README chỉ tới mục mô tả chi tiết dữ liệu thu thập trong tài liệu.
Làm sao tự tạo skill của mình?
Chạy npx skills init my-skill để sinh khung, rồi sửa file SKILL.md thành hướng dẫn cho AI. Định dạng chi tiết nằm trong tài liệu Creating skills của repo.


