Tóm tắt nhanh:
ak-skill-creatorcó 4 lệnh con chính:create,update,audit,optimize. Trước khi viết skill mới, nó kiểm xem skill có thật là thứ bạn cần không, hay chỉ cần một rule, reference hoặc script. Nó chỉ coi là xong khi có bằng chứng đúng loại thay đổi, và nó không làm CLI hay MCP server.
Công khai: mình là maintainer của AgentKit và có quan hệ affiliate: link AgentKit trong bài là link affiliate, mua qua link này bạn được giảm 30%.
Tóm tắt
Dùng khi bạn cần một skill mới, muốn sửa một skill đang có, hoặc nghi một skill đang kích hoạt nhầm, chạy lâu hay tốn token. Không cần khi việc chỉ là một quy ước ổn định cho cả project (một rule là đủ), hoặc khi bạn muốn làm MCP server hay CLI cho agent.
flowchart LR
A["Cần skill mới hoặc skill chạy tệ"] --> B["ak-skill-creator"]
B --> C["create, update: skill mới hoặc bản sửa"]
B --> D["audit: báo cáo, không sửa file"]
D --> E["optimize: diff, áp dụng khi có --apply"]
B --> F["Dừng: giao reference, script hay rule thay cho skill"]Bốn khái niệm cần nắm:
| Khái niệm | Câu hỏi | Ví dụ |
|---|---|---|
| Lệnh con | Lần này bạn muốn làm gì với skill? | create viết skill mới, update sửa một skill có sẵn, audit chỉ ra báo cáo, optimize đưa diff để sửa theo báo cáo |
| Có cần skill không | Thứ bạn cần có phải là một skill riêng không, hay chỉ là một reference, script, template hoặc rule? | Quy ước đặt tên nhánh của team hợp với một rule theo phạm vi project hơn là một skill mới phải cạnh tranh trong catalog |
| Phạm vi | Skill mới nằm ở đâu? | Mặc định là project hiện tại, như .claude/skills/<slug>/ cho Claude Code hay .agents/skills/<slug>/ cho Codex. Cấp user chỉ khi bạn yêu cầu. Cấp kit chỉ trong repo AgentKit |
| Bằng chứng xong | Bằng chứng nào cho thấy thay đổi này tốt hơn? | Đổi description cần dấu vết định tuyến thật, có ca nên kích hoạt và ca gần giống không nên kích hoạt. Chỉ sửa chính tả thì kiểm cấu trúc là đủ |
Skill mới chỉ đáng có khi nó mang thứ agent không tự suy ra được: quy ước riêng của tổ chức, luật của một lĩnh vực, script chạy chắc chắn, ranh giới quyền, hoặc cách chặn một lỗi hay lặp lại.
Prompt mẫu để viết skill mới cho project:
/ak-skill-creator create release-notes
Mục đích: viết release notes từ các commit giữa hai tag theo mẫu của team <tên team>.
Người đọc: khách hàng, không đọc code.
Ràng buộc: không nêu số ticket nội bộ, nhóm theo tính năng chứ không theo commit.
Không làm: không tự tạo tag, không đăng bài.
Xong khi: có ca kiểm thử bình thường, ca biên, và so được với lúc không có skill.| Cờ | Để làm gì | Từ ak |
|---|---|---|
--kit, --project, --user | Chọn nơi đặt skill mới | 2.15.0 |
--long-horizon | Tạo một repo skill để phát triển lâu dài | 2.15.0 |
--all | Audit toàn bộ thay vì một skill | 2.15.0 |
--target-model | Ghi rõ model đích cho bản audit | 2.15.0 |
--apply | Cho phép optimize sửa file thật | 2.15.0 |
--from-audit | Tối ưu theo một báo cáo audit có sẵn | 2.15.0 |
--advice | Model mạnh hơn góp ý ở mốc quan trọng | 2.13.0 |
Phần dưới đây là bản chi tiết: luồng chạy, 6 tình huống kèm prompt, giải thích từng cờ (dùng khi, không cần khi, nhận lại gì, đi kèm cờ nào), lịch sử thay đổi theo bản ak và các lỗi hay vấp. Bản chi tiết và trang trực quan dành cho subscriber. Agent của bạn cũng tìm được trong đó qua MCP của portal.
Mở khi tài khoản có quyền subscriber
Bài này dành cho subscriber
Khi tài khoản có quyền, toàn bộ bài, bản visual tương tác và lệnh gọi từ agent đều mở.
- Đăng nhập hoặc tạo tài khoản modernEngineerQuyền đọc gắn với email tài khoản.
- Chọn gói trên trang Bảng giáGói 1, 3 hoặc 12 tháng, trả bằng chuyển khoản VietQR. Quyền đọc mở khoảng một phút sau khi tiền về.
- Hoặc nhập mã Facebook subscriberNgười ủng hộ trang qua Facebook nhận mã kích hoạt qua tin nhắn mỗi tháng.
Đã là subscriber? Đăng nhập để đọc.
Dùng bài này trong agent của bạn
Lấy API keyChép đoạn dưới, dán vào Claude Code, Codex hay agent bạn đang dùng. Agent đọc bài rồi đối chiếu với repo đang mở.
Đọc bài "ak-skill-creator: tạo, sửa, rà soát và tối ưu skill cho agent" trên modernEngineer rồi áp dụng vào repo này.
1. Gọi tool content_get của MCP server modernengineer với locale "vi", slug "ak-skill-creator". Nếu chưa nối MCP server modernengineer, dừng lại và hướng dẫn tôi nối theo https://modernengineer.dev/vi/mcp.
2. Tóm tắt các bước chính của bài, chỉ ra bước nào áp dụng được cho repo này.
3. Đề xuất thay đổi cụ thể và hỏi tôi trước khi sửa file.Nối MCP cho Claude Code (một lần)
claude mcp add --transport http modernengineer \
https://api.modernengineer.dev/mcp \
--header "Authorization: Bearer <API key>"Đọc trọn bài qua MCP cần API key của tài khoản subscriber hoặc đã mua guide này. Không có quyền, agent sẽ chỉ đọc được phần mở đầu.
- Phiên bản
- v1.1.0
- Cập nhật
- 01/11/2026
- Giấy phép
- Bảo lưu mọi quyền
- Slug
- ak-skill-creator
