| name | skill-auto-improver |
| description | Audit và cải tiến skill Claude Code: chấm điểm chất lượng (8 tiêu chí), phát hiện anti-patterns, đề xuất refactor, đo trước/sau, giữ skill gọn không phình. Dùng khi user nói 'cải tiến skill', 'review skill', 'audit skill', 'skill này chưa tốt', 'tối ưu skill', 'refactor skill', 'nâng cấp SKILL.md', hoặc muốn phân tích và cải thiện chất lượng một skill hiện có. Áp dụng 11 nguyên lý bất biến và improvement patterns có sẵn. |
Skill Auto-Improver
Phân tích skill hiện có, trích xuất bài học, đề xuất cải tiến tổng quát hóa, và thực hiện sau khi user duyệt. Mọi cải tiến phải giữ skill gọn — không phình to.
Nguyên lý bất biến
Mười một nguyên lý áp dụng cho mọi skill bất kể domain. Đọc chi tiết + ví dụ khi cần tra cứu.
- Giải thích lý do thay vì ra lệnh — LLM hiểu "tại sao" tốt hơn "phải làm"
- Tổng quát hóa > Cụ thể hóa — Không fix cho case cụ thể
- Progressive Disclosure — SKILL.md chứa workflow + quyết định, chi tiết → references/
- Mỗi dòng phải earn chỗ đứng — Xoá mà output không đổi = dead content
- Single Source of Truth — Mỗi thông tin chỉ định nghĩa 1 nơi
- Đo trước, sửa sau — Chấm điểm baseline → sửa → chấm lại
- Ranh giới quyết định phải rõ — Không kèm điều kiện = model đoán
- Ngắn ≠ Tốt, Dài ≠ Xấu — Ngắn nhất có thể mà không thiếu sót
- Degrees of Freedom — Chọn mức tự do (cao/vừa/thấp) phù hợp độ nhạy cảm
- Skill = Interface — Định nghĩa contract (output), không phải implementation (cách làm)
- Context là tài nguyên hữu hạn — Mỗi token cạnh tranh attention, nội dung dở hại chủ động toàn bộ
Quy trình (4 pha)
Pha 1: Thu thập & Phân tích