Giải quyết sự phân mảnh kỹ năng của Agent AI với npx skills

Nếu bạn đang chạy nhiều Agent AI hoặc CLI trên máy tính của mình — cho dù đó là Hermes, Claude Code, Codex, Antigravity, Kimi hay các công cụ được hỗ trợ khác — bạn có thể đã gặp phải một vấn đề cực kỳ khó chịu: sự phân mảnh kỹ năng (skills fragmentation). Mỗi Agent hoặc CLI lại tự duy trì một thư mục skills riêng biệt, dẫn đến việc cài đặt trùng lặp, lệch phiên bản và làm tăng thêm gánh nặng quản lý.

Trong quá trình làm việc với các Agent AI, chúng tôi thường xuyên gặp phải những vấn đề sau:

• Cài đặt trùng lặp: Cài đặt một kỹ năng (skill) mới cho một Agent, rồi lại phải cài đặt lại liên tục cho các Agent khác.
• Lệch phiên bản (version drift): Tùy chỉnh hoặc sửa lỗi một kỹ năng cho một Agent, nhưng quên cập nhật cho những Agent còn lại, dẫn đến việc các Agent hoạt động không nhất quán.
• Khó khăn trong quản lý: Phải lùng sục từng thư mục skills của mỗi Agent trên hệ thống chỉ để xem những kỹ năng nào thực sự đã được cài đặt.

CLI npx skills, một CLI mã nguồn mở từ Vercel, giải quyết triệt để vấn đề này bằng cách giúp bạn quản lý duy nhất một thư mục skills tập trung và chia sẻ nó cho tất cả các Agent của mình. Bạn có thể tham khảo kho lưu trữ GitHub của npx skills.

Thư mục tập trung

Khái niệm này rất đơn giản: nếu chúng ta trỏ thư mục skills của mọi Agent về cùng một thư mục vật lý, vấn đề phân mảnh sẽ biến mất hoàn toàn.

Khi bạn cài đặt một kỹ năng bằng CLI npx skills, kỹ năng đó sẽ được tải xuống thư mục tập trung trên máy của bạn (~/.agents/skills). Sau đó, CLI sẽ tạo một symlink (liên kết tượng trưng, đóng vai trò như một con trỏ trực tiếp) từ thư mục skills của từng Agent về lại thư mục tập trung đó.

Ví dụ, khi Claude Code tìm kiếm các kỹ năng trong ~/.claude/skills/, nó sẽ được tự động chuyển hướng một cách mượt mà đến ~/.agents/skills. Nếu bạn thực hiện một thay đổi nhỏ đối với một kỹ năng trong thư mục tập trung đó, mọi Agent sẽ ngay lập tức thấy bản cập nhật. Không cần sao chép thủ công, không cần tập lệnh đồng bộ hóa và không lãng phí dung lượng ổ đĩa.

Cài đặt npx skills và Thêm Kỹ năng

Chạy lệnh sau để bắt đầu và thêm kỹ năng đầu tiên của chúng ta:

npx skills add https://github.com/coleam00/excalidraw-diagram-skill --skill excalidraw-diagram

CLI sẽ hỏi bạn muốn thiết lập tính năng này cho một dự án cụ thể hay trên toàn cục (globally). Chúng tôi khuyên bạn nên chọn global để tất cả các Agent được hỗ trợ đều có thể truy cập:

Tiếp theo, hãy chắc chắn chọn Symlink để đảm bảo một nguồn dữ liệu chân lý duy nhất (single source of truth):

Sau khi hoàn tất, chúng ta có thể kiểm tra xem kỹ năng đã được cài đặt trong thư mục tập trung tại ~/.agents/skills chưa:

Mở Kimi CLI (hoặc bất kỳ Agent nào khác), kỹ năng excalidraw-diagram đã sẵn sàng và hoạt động mượt mà!

Tạo Kỹ năng từ con số 0

Để xây dựng các kỹ năng của riêng bạn, bạn có thể sử dụng công cụ skill-creator của Anthropic. Hãy cài đặt nó như thế này:

npx skills add https://github.com/anthropics/skills --skill skill-creator

Bây giờ, trong Kimi hoặc bất kỳ Agent nào khác, nhập prompt sau:

Use the skill-creator to help me build a skill for creating a product landing page

Kimi hoặc Agent của bạn sẽ tự động nhận diện skill-creator và hướng dẫn bạn từng bước thực hiện:

Các lệnh npx skills hữu ích khác

Dưới đây là một số lệnh tiện lợi khác:

• npx skills ls -g: Liệt kê tất cả các kỹ năng được cài đặt toàn cục
• npx skills update: Cập nhật tất cả các kỹ năng bằng một lệnh duy nhất
• npx skills remove: Gỡ cài đặt/xóa một kỹ năng theo cách tương tác trực quan

Vui lòng tham khảo kho lưu trữ GitHub của npx skills để biết thêm các lệnh và tài liệu tham khảo khác.

Nâng cấp hơn nữa

Vì tất cả các kỹ năng hiện đã ở cùng một nơi (~/.agents/skills), chúng ta có thể khởi tạo nó như một kho lưu trữ Git và đẩy nó lên GitHub hoặc GitLab.

cd ~/.agents/skills
git init
git add .
git commit -m "Initial skills folder"
git remote add origin https://github.com/Tech-Voyage-Dev/skills
git push -u origin main

Bây giờ, chúng ta đã có lịch sử hoàn chỉnh về tất cả các thay đổi kỹ năng, nghĩa là chúng ta có thể dễ dàng khôi phục (rollback) nếu một bản cập nhật làm hỏng thứ gì đó. Ngoài ra, chúng ta có thể đồng bộ hóa mượt mà các kỹ năng trên nhiều máy tính khác nhau (như máy tính xách tay và máy tính để bàn) bằng cách chạy lệnh nhanh git pull.

Một số lưu ý quan trọng (Bảo mật & Rủi ro)

• Khả năng tương thích khác nhau: Không phải tất cả các nền tảng Agent đều hỗ trợ mọi tính năng (như custom hook hoặc các công cụ cụ thể được cho phép). Một kỹ năng có thể hoạt động tốt trên Agent này nhưng lại hạn chế trên Agent khác.
• Tin tưởng nguồn: Chỉ cài đặt các kỹ năng từ những nguồn đáng tin cậy.
• Kiểm tra kỹ trước khi chạy: Nếu bạn đang sử dụng kỹ năng tùy chỉnh hoặc của bên thứ ba, hãy xem xét kỹ các tệp (đặc biệt là trong thư mục scripts/) trước khi cho phép Agent của bạn chạy nó.
• Quyền tối thiểu: Cố gắng không cấp cho một kỹ năng nhiều quyền công cụ hoặc quyền truy cập hơn mức thực sự cần thiết để hoàn thành công việc.
• Không bao giờ mã hóa cứng thông tin nhạy cảm: Giữ các khóa API và bí mật của bạn tránh xa các tệp kỹ năng của bạn.

Thiết lập một thư mục tập trung đóng vai trò là "nguồn dữ liệu chân lý duy nhất" với npx skills đã giúp đội ngũ của chúng tôi tiết kiệm thời gian và tránh việc làm trùng lặp không đáng có. Rất khuyến khích bạn thử trải nghiệm — năng lực AI sẽ mở rộng vượt trội khi hệ thống kỹ năng của bạn ngày càng phát triển!