Tài liệu hướng dẫn

Tổng quan

SkillHub là một kho lưu trữ (registry) dùng chung cho các agent skill. Có ba lệnh con:

• codevhub skill search — tìm skill trên hub.
• codevhub skill pull — tải về và cài đặt một skill.
• codevhub skill push — xuất bản một skill lên hub.

Skill được cài vào thư mục .claude/skills/ — trong dự án hiện tại hoặc toàn cục trong thư mục home của bạn — và được Claude Code cùng các agent khác tự động nhận diện.

Tìm kiếm skill

Truyền từ khóa tìm kiếm để liệt kê các skill phù hợp từ hub. Mỗi kết quả hiển thị tên skill, phiên bản, tác giả, mô tả ngắn và id của nó.

codevhub skill search <query>

Tùy chọn:

• --limit <n> — giới hạn số lượng kết quả (mặc định 20).
• --json — in ra JSON để máy đọc thay vì danh sách đã định dạng.

codevhub skill search testing
codevhub skill search react --limit 5
codevhub skill search react --json

Cài đặt skill

Cài đặt một skill theo tên hoặc id của nó. Trong terminal, CoDev sẽ hỏi bạn muốn cài vào đâu:

• Thư mục hiện tại — ./.claude/skills/<name>, chỉ dùng được trong dự án này.
• Toàn cục — ~/.claude/skills/<name>, dùng được trong mọi dự án.

codevhub skill pull <name|id>

Tùy chọn:

• --dir <path> — vị trí cài đặt. Bắt buộc khi chạy không tương tác (CI, đầu ra qua pipe); nếu không sẽ được hỏi.
• --force / -f — ghi đè bản cài đặt hiện có của cùng một skill.
• --json — đầu ra để máy đọc.

codevhub skill pull my-skill
codevhub skill pull my-skill --dir ~/.claude/skills --force

Xuất bản skill

Xuất bản một skill từ một thư mục hoặc một tệp .zip có sẵn. Thư mục phải chứa SKILL.md ở gốc — CoDev sẽ tự nén lại cho bạn, tự động loại trừ các thư mục quản lý phiên bản, node_modules và các tệp bí mật (tệp .env, *.key và tương tự).

codevhub skill push <path>

Trong terminal, CoDev sẽ hiển thị bản xem trước những gì sẽ được tải lên (số lượng tệp, dung lượng và các tệp đầu tiên) và yêu cầu bạn xác nhận trước khi đăng nhập và tải lên.

Tùy chọn:

• --draft-only — tải lên và lưu dưới dạng bản nháp mà không gửi đi để duyệt.
• --auto-approve — xuất bản thẳng ra công khai (chỉ dành cho quản trị viên).
• --json — đầu ra để máy đọc.

codevhub skill push ./my-skill
codevhub skill push ./my-skill.zip --draft-only

Một skill được xuất bản đi qua ba trạng thái: DRAFT (đã tải lên, chưa gửi duyệt), SUBMITTED (đang chờ duyệt) và PUBLIC (đã được duyệt và mọi người có thể tìm thấy).

Dùng ở chế độ không tương tác (CI và pipe)

CoDev chỉ hiển thị các bước tương tác khi cả stdin và stdout đều là terminal. Việc truyền --json, đưa đầu ra qua pipe, hoặc chạy trong CI sẽ buộc dùng chế độ không tương tác — không có bước hỏi và không có xác nhận. Hành vi của từng lệnh thay đổi như sau.

• skill search luôn chạy không tương tác, nên hoạt động giống nhau ở mọi nơi.
• skill pull bỏ qua bước hỏi vị trí cài đặt, nên bạn phải truyền --dir <path> một cách tường minh. Nếu không, lệnh sẽ thoát với thông báo Not a terminal — pass --dir <path> to choose an install location.
• skill push bỏ qua bản xem trước và bước xác nhận, và tải lên ngay lập tức.

codevhub login --username <username> --password <password>