Quản lý skill và SkillX: tự chế kit riêng mà không sợ update đè mất

Bài 5/20 trong bộ onboarding AgentKit v3. Đọc khoảng 12 phút.

Bài này dài nhất bộ, vì nó chứa phần tui hào hứng nhất của v3: skill của bạn là tài sản của bạn. Bạn tự viết, tự sửa, mang qua máy khác, chia sẻ cho team, mà lần update kit sau không đè mất.

Nhưng tui cũng phải nói thẳng ngay đầu bài: một phần lớn trong đây còn là preview 🧪. Tui đánh dấu kỹ từng mục để bạn biết cái nào xài ngay được, cái nào nên đợi.

1/ Quản lý skill cơ bản ✅

ak skills list
ak skills search "deploy"
ak skills show ak-cook
ak skills install <ten-skill>
ak skills remove <ten-skill>

Muốn xem skill nào gọi skill nào:

ak skills graph

Router chọn skill cục bộ ✅

Có quá nhiều skill, không nhớ cái nào làm gì? Hỏi router:

ak skills route "viết bài blog về release mới"

Router chạy cục bộ, chọn một skill phù hợp, hoặc trả lời NONE nếu không có cái nào khớp. Nó thà nói "không biết" còn hơn chọn bừa.

(Ảnh trên chụp trong HOME tạm chưa cài kit, nên router trả về rỗng. Đúng hành vi.)

2/ Tạo skill của riêng bạn ✅

Cách nhanh nhất là để agent làm giúp. Trong Claude Code:

/ak-skill-creator tạo skill "viet-changelog" đọc git log từ tag gần nhất rồi viết changelog tiếng Việt theo giọng của team

Skill này tạo đủ SKILL.md, references/, scripts/ nếu cần, rồi kiểm tra cấu trúc. Nó cũng audit, validate và đóng gói skill có sẵn.

Sau một session làm việc, muốn biến những chỗ agent đi lòng vòng thành cải tiến skill:

/ak-dogfood

ak-dogfood mặc định chỉ đề xuất (dry-run), thêm --apply mới sửa thật. Chi tiết cách dogfood ghi bản sửa vào personal kit nằm ở bài 20.

3/ --ssot và SkillX: nền móng cho skill cá nhân 🧪

Mọi thứ ở phần 3 tới 6 cần bạn đã bật kho skill một nguồn (đọc thêm ở bài 1):

ak update --ssot --dry-run
ak update --ssot --yes

Khi scope global đã được commit sang store, SkillX tự bật. Bạn cũng có thể bật cho một lệnh bằng AGENTKIT_SKILL_STORE=1 hoặc AGENTKIT_SKILLX=1.

SkillX là gì? Là chợ skill ở skillx.sh, có CLI skillx-sh (bản 0.8.0), tìm kiếm lai (vector + full-text) và bản phát hành có chữ ký.

Với ak, bạn đọc và kiểm tra skill trên SkillX mà không phải chạy bất kỳ script nào:

ak skills resolve @publisher/ten-skill
ak skills inspect @publisher/ten-skill@1.2.0
ak skills read @publisher/ten-skill@1.2.0
ak skills read @publisher/ten-skill@1.2.0 references/notes.md

read mặc định in SKILL.md, giới hạn 256 KiB, và chỉ đọc những file không thực thi được mà manifest đã ký liệt kê. Nội dung in ra được đánh dấu là "untrusted", ký tự điều khiển terminal bị vô hiệu hoá.

inspect và read chỉ đọc file không thực thi được, sau khi đã kiểm chữ ký và digest. Đọc kỹ rồi mới cài, giống đọc nhãn trước khi uống thuốc.

4/ Personal kit: kit "của tui" dựa trên kit gốc 🧪

Ý tưởng: bạn lấy kit Engineer làm nền, rồi phủ (overlay) các chỉnh sửa của mình lên trên. Khi kit gốc ra bản mới, bạn rebase chứ không phải sửa lại từ đầu.

ak skills kit init mine --extends engineer@0.2.0   # tạo personal kit
ak skills kit status mine                         # đang ở đâu, có gì thay đổi
ak skills kit inspect mine                        # xem chi tiết
ak skills kit rebase mine --to engineer@0.3.0 --dry-run   # thử rebase lên bản gốc mới
ak skills kit apply mine                          # áp dụng vào project
ak skills kit rollback mine                       # quay lại revision trước
ak skills kit revisions mine                      # lịch sử revision

Mấy nguyên tắc tui đặt cho nó:

• Revision bất biến. Mỗi lần thay đổi là một revision mới, không sửa đè revision cũ.

• Rebase có kết quả xác định. Xung đột được ghi lại rõ ràng, không tự chọn bên thắng.

• Không revision nào có hiệu lực nếu bạn chưa duyệt.

status, inspect và dry-run của init, resolve, rebase chạy offline, không cần tài khoản SkillX.

5/ Publish, chia sẻ, đồng bộ nhiều máy 🧪

Publish

ak secrets set SKILLX_TOKEN    # lưu API key SkillX vào vault, không để trong .env
ak skills kit publish mine --private

publish đẩy lên một revision riêng tư (private). Muốn cho cộng đồng xài (public hoặc unlisted) thì dùng CLI của SkillX:

skillx publish ./skill-cua-ban --visibility public

Gói mới mặc định là private. Đổi visibility của gói đã publish hiện chỉ làm được trên dashboard web của SkillX, CLI chưa làm được. Tui ghi vào gap report rồi.

Đồng bộ nhiều máy

Đồng bộ dựa trên file lock. Máy A publish và commit file lock vào repo, máy B chạy:

ak skills sync --locked
ak skills kit sync <ten-kit> --locked

Xem trước mà không ghi gì: thêm --dry-run.

--locked nghĩa là cài chính xác những bản mà lock ghim, theo digest. Không có chuyện máy B lỡ tay lấy bản khác.

Trạng thái thật ở thời điểm viết

• Lệnh ak skills kit ... có trong binary 3.0.0. Nó bị ẩn nếu bạn đặt AGENTKIT_SKILL_OVERLAYS khác 1.

• API personal kit phía server SkillX đang sau cờ, mặc định tắt. Nếu bạn gặp lỗi kit.api_disabled (404) khi publish hoặc sync, đó là lý do, không phải bạn làm sai.

• FAQ của agentkit.best cũng ghi rõ: publish/sync skill riêng tư và personal kit là preview, chưa GA.

6/ Chạy script của skill an toàn 🧪 sau flag

Một số skill có script (Python, Node, shell). Chạy script từ skill tải về là chuyện cần cẩn thận. v3 có sẵn bộ khung exec broker:

AGENTKIT_SKILL_EXEC_BROKER=1 ak skills grants add ...
AGENTKIT_SKILL_EXEC_BROKER=1 ak skills exec ...

Thiết kế của nó:

• Ghim theo digest: quyền cấp cho đúng một bản script. Script đổi một byte là phải cấp quyền lại.

• Cách ly thật: chạy trong bubblewrap (Linux), AppContainer (Windows), hoặc docker/podman. Không có backend cách ly thì từ chối chạy, không "chạy đại".

• Mạng theo allowlist: script chỉ gọi được những domain được cho phép.

• Secret đưa vào dạng file, không đổ ra biến môi trường cho ai cũng đọc được.

• Từ chối trước khi chạy: bản SkillX bị yank, quarantine hay revoke, chạy bằng root/admin, thiếu grant... đều bị chặn trước khi tiến trình nào được tạo. Output của script bị giới hạn kích thước và redact secret.

Tui để nó sau cờ vì một lý do đơn giản: bộ quét tĩnh không phải sandbox. Khi nào phần cách ly chạy ổn trên cả 3 hệ điều hành thì mới bật mặc định.

7/ An toàn khi dùng skill người khác viết

Checklist của tui:

1. ak skills inspect trước khi cài. Xem publisher là ai, chữ ký có hợp lệ không.

2. ak skills read để đọc SKILL.md và script. Skill bảo agent làm gì thì bạn phải biết trước.

3. Cài bằng --locked từ file lock đã commit, để cả team cùng một bản.

4. Đừng cấp grants rộng chỉ vì lười. Cấp đúng cái script cần.

5. Secret (API key...) để trong vault (ak secrets), không viết thẳng vào skill.

SkillX phía server có quét nội dung và prompt injection khi đăng ký, hash API key, quarantine bản nghi ngờ, và namespace @agentkit/* được giữ riêng để không ai mạo danh. Nhưng nói thật: lớp kiểm tra cuối cùng vẫn là mắt bạn.

Bài tiếp: AgentKit Vault: secret, credential, đồng bộ đa thiết bị →

Nguồn

• ak skills --help, ak skills kit --help (ak 3.0.0): danh sách lệnh exec, grants, inspect, kit, read, resolve, route, sync

• Hướng dẫn migration v2 → v3, đoạn SkillX sau ak update --ssot: agentkit/docs/guides/v2-to-v3-migration.md (tag v3.0.0)

• SkillX: https://skillx.sh, release skillx-sh v0.8.0 (29/10/2026), tài liệu docs/personal-kits-api.md, docs/cli-reference.md (repo nextlevelbuilder/skillx)

• FAQ https://agentkit.best (kiểm tra 02/11/2026): SkillX private publish/sync và personal kit là preview

• Mã nguồn agentkit/apps/cli/internal/commands/skillbrowsecmd/personal_kit*.go, skillx_*.go (tag v3.0.0)