Skill System Guide

Hướng dẫn trực quan xây dựng hệ thống kỹ năng AI — từ tư duy gốc đến triển khai thực tế 30 ngày

5 Layer
kiến trúc
8 Loại kỹ năng
cơ bản
7 Bước
triển khai
30 Ngày
lộ trình

Kỹ năng khác gì với Prompt?

Hiểu sự khác biệt cốt lõi giữa prompt đơn lẻ và hệ thống kỹ năng — nền tảng để xây dựng "AI Knowledge OS".

Prompt truyền thống

Gửi yêu cầu → nhận kết quả → chỉnh sửa → thử lại. Phù hợp tác vụ ngắn, ít bước, ít rủi ro. Phải giải thích lại từ đầu mỗi lần.

Skill System

Đóng gói tri thức, quy tắc, quy trình vào file Markdown. Claude "biết" sẵn context, chỉ cần kích hoạt. Tái sử dụng, kiểm chứng, phối hợp nhóm.

Ian Loe: "Nếu prompt engineering vẫn là giới hạn cao nhất cho khả năng AI của bạn, thì bạn đã tụt lại phía sau." Thay vào đó, hãy xây dựng thư viện skills — mỗi skill đóng gói tri thức cho một loại công việc cụ thể.

Mỗi skill thực chất là một thư mục chứa SKILL.md cùng các tài nguyên liên quan. Claude "tự học" skill một lần rồi áp dụng lại mãi mà không phải giải thích lại từ đầu. Điều này giúp chuyển từ prompt engineer cá nhân sang skill system tổ chức.

# Ví dụ: Thay vì prompt lặp lại mỗi lần...
"Viết proposal đào tạo AI cho doanh nghiệp X,
 cần có phần mục tiêu, phương pháp, timeline..."

# ...Bạn tạo skill một lần, dùng mãi:
/write-enterprise-proposal
→ Claude đã biết cấu trúc, ngôn ngữ, checklist
→ Chỉ cần cung cấp: tên KH, mục tiêu, đối tượng

Mô hình 5 lớp của hệ Skill

Kiến trúc hoàn chỉnh từ mục tiêu đến cải tiến liên tục — mỗi lớp trả lời một câu hỏi then chốt.

1. INTENT — Mục tiêu Xác định rõ nhiệm vụ, đầu ra mong đợi và tiêu chí đúng/sai Cái gì? 2. KNOWLEDGE — Tri thức Domain guides, quy định, best practices, style guide, API docs, template Cần biết gì? 3. EXECUTION — Thực thi Scripts, workflow, commands, templates, automation, checklist thao tác Cách làm? 4. VERIFICATION — Kiểm chứng Test cases, checklist, ví dụ mẫu, anti-patterns, đối chiếu thực tế Đã đúng? 5. EVOLUTION — Phát triển Gotchas, lessons learned, changelog, phiên bản nâng cấp Học được gì? Vòng lặp cải tiến
Sơ đồ: Mô hình 5 lớp của hệ Skill — vòng lặp liên tục từ Intent đến Evolution
1

Intent Layer — Lớp Mục tiêu

Xác định rõ nhiệm vụ cần làm, đầu ra mong đợi và tiêu chí đúng/sai. Nếu không rõ ràng ở bước này, AI rất dễ sinh ra kết quả "có vẻ ổn" nhưng không thực sự giải quyết yêu cầu.

"Chúng ta đang cố gắng đạt mục tiêu gì, theo tiêu chuẩn nào?"
2

Knowledge Layer — Lớp Tri thức

Cung cấp mọi kiến thức nền tảng, quy tắc và tài liệu cần thiết: domain guides, quy định doanh nghiệp, best practices, style guide, API docs, template, voice branding.

"AI cần biết gì để làm đúng?"
3

Execution Layer — Lớp Thực thi

Hướng dẫn cách thực hiện nhiệm vụ: scripts, mẫu workflow, commands, file template, code scaffold, automation script, checklist thao tác. Biến hướng dẫn thành công cụ thực thi cụ thể.

"Cần làm gì và chạy như thế nào?"
4

Verification Layer — Lớp Kiểm chứng

Đảm bảo kết quả đầu ra thực sự đạt yêu cầu: test case, ví dụ đầu ra mong đợi, checklist chống mẫu lỗi (anti-patterns), bước mô phỏng, đối chiếu thực tế.

"Làm sao biết kết quả là đúng và có thể tin dùng?"
5

Evolution Layer — Lớp Phát triển

Kỹ năng không phải tài liệu bất động. Sau mỗi lần sử dụng, rút kinh nghiệm và cập nhật skill: gotchas, lessons learned, changelog, phiên bản nâng cấp.

"Sau mỗi lần, học được gì để cải thiện?"

8 loại kỹ năng cơ bản

Phân loại skill theo vai trò — giúp tổ chức hệ thống có cấu trúc, dễ tìm kiếm và tái sử dụng.

📚

Knowledge Skills

Cung cấp nền tảng tri thức và khung tham khảo: company overview, brand voice, framework đào tạo, tiêu chuẩn proposal

genai-training-framework

Verification Skills

Kiểm tra đầu ra của các task khác. Điểm khác biệt giữa "AI trả lời hay" và "AI làm việc đáng tin"

verify-proposal-completeness
📊

Data Skills

Xử lý và phân tích dữ liệu: phân tích báo cáo, làm sạch danh sách, rút insight từ khảo sát

analyze-excel-sales-report

Automation Skills

Thực hiện các chuỗi thao tác lặp đi lặp lại: tạo thư mục, tạo báo cáo, xuất bản nội dung

generate-client-kickoff-pack
🏗️

Scaffolding Skills

Dựng khung ban đầu cho project hay tài liệu: khởi tạo project, dựng khuôn proposal, tạo dàn ý

scaffold-laravel-project
🔍

Review Skills

Phản biện, rà soát và cải thiện đầu ra: đánh giá logic nghiệp vụ, nhận xét slide, soát bài viết

review-business-logic
📋

Runbook Skills

Hướng dẫn vận hành theo quy trình: onboard khách hàng, xử lý bug, vận hành ngày đào tạo

runbook-client-onboarding
🚀

Infra/CI/Delivery

Triển khai kỹ thuật và đảm bảo chất lượng: deploy, pre-release checks, CI checklist

deploy-vercel-app
Mẹo: Verification Skills chính là yếu tố quyết định sự ổn định. Chúng giúp tự động kiểm tra sai sót, từ đó nâng giá trị kết quả của AI.

4 nguyên tắc vàng khi thiết kế Skill

Những quy tắc quan trọng nhất để xây dựng kỹ năng chất lượng, đáng tin cậy và dễ bảo trì.

1. Một skill = một nhiệm vụ duy nhất

Đừng gom nhiều chức năng khác nhau vào một skill. Tạo các micro-skill nhỏ, đơn nhiệm — giảm phức tạp và tăng khả năng bảo trì.

✘ Sai
skill_viết_bài_kiểm_tra_đăng_fb_tạo_ảnh
✔ Đúng
write-facebook-post + verify-facebook-post + generate-cover-image

2. Skill là thư mục, không chỉ file đơn lẻ

Mỗi thư mục skill có thể chứa SKILL.md (bắt buộc) kèm theo scripts/, references/, assets/.

skill-name/
├── SKILL.md              # Hướng dẫn (file chính)
├── scripts/              # Script (mã tự động)
├── references/           # Tài liệu bổ sung
└── assets/               # Tài nguyên (template, hình ảnh)

3. Luôn có Verification đi kèm

Nếu thiếu bước kiểm chứng, skill chỉ là "máy phát sinh" kết quả. Mỗi skill cần định nghĩa rõ: tiêu chí đạt, test case, checklist, ví dụ mẫu tốt/xấu, gotchas và cách sửa.

4. Cấu trúc hướng dẫn ưu tiên hơn điều khiển cứng

Tránh liệt kê quá chi tiết kiểu "Bước 1 làm này, Bước 2 làm kia". Thay vào đó, xác định mục tiêu chung, cung cấp ngữ cảnh và công cụ phù hợp, rồi để Claude tự biện luận chi tiết.

Claude docs: "Set appropriate degrees of freedom" — chọn mức hướng dẫn chung hay chi tiết tuỳ vào độ phức tạp của nhiệm vụ.

Personal Skill OS — 6 cụm chức năng

Xây dựng thư viện kỹ năng cá nhân như một "hệ điều hành" cho công việc hằng ngày.

🧠

Thinking Skills

Phân tích, viết lách chiến lược, phát triển ý tưởng. VD: think-strategically, write-in-my-voice, build-framework-from-ideas

✍️

Content Skills

Tạo và chỉnh sửa nội dung. VD: write-facebook-post, write-linkedin-article, create-video-script

🎓

Teaching Skills

Thiết kế chương trình đào tạo. VD: design-nontech-ai-training, build-case-study-by-department

💼

Consulting Skills

Dự án tư vấn, khảo sát nhu cầu. VD: diagnose-enterprise-ai-readiness, build-ai-usecase-map

🔧

Build Skills

Prototyping, code, tự động hoá. VD: scaffold-agent-project, build-laravel-module, setup-rag-structure

⚙️

Operating Skills

Công việc hằng ngày. VD: meeting-note-to-actions, weekly-review-and-planning, postmortem-after-project

Project Skill OS — Cấu trúc dự án

Mỗi dự án là một "mini-OS" có cấu trúc thư mục rõ ràng, giúp Claude dễ dàng truy cập và thực thi.

project-name/
├── context/              # Bối cảnh dự án (goals, stakeholders, scope)
├── skills/               # Các thư mục skill (knowledge/, verification/, automation/)
├── templates/            # Mẫu tài liệu, mẫu code, ví dụ
├── data/                 # Dữ liệu mẫu, schema, mapping
├── scripts/              # Mã nguồn phục vụ dự án
├── outputs/              # Kết quả đã tạo (báo cáo, code)
├── logs/                 # Nhật ký quá trình chạy
└── lessons/              # Bài học, gotchas, changelog, failure cases
Workflow: Claude làm việc trong project → truy cập skills/ để chọn skill phù hợp → dùng templates/scripts/ sẵn có → ghi output vào outputs/ → rút kinh nghiệm vào lessons/

Quy trình triển khai 7 bước

Từ xác định tác vụ đến cập nhật liên tục — quy trình thực chiến để biến công việc thành skill.

B1

Xác định tác vụ

Liệt kê 5–10 việc lặp lại nhiều nhất

B2

Tách đơn vị

Chia nhỏ thành các bước độc lập

B3

Đóng gói

Tạo thư mục skill với SKILL.md

B4

Viết SKILL.md

Theo cấu trúc chuẩn

B5

Đính kèm tài nguyên

Template, ví dụ, checklist

B6

Sử dụng thực tế

Test với 5–10 bài toán

B7

Cập nhật & Evolve

Rút kinh nghiệm, thêm gotchas

Mẫu SKILL.md chuẩn

Template đầy đủ để tạo skill đầu tiên của bạn — chỉ cần copy và tuỳ chỉnh.

# SKILL: write-enterprise-proposal

## Purpose
Tạo proposal đào tạo/tư vấn chuẩn enterprise,
logic rõ ràng, hướng đến lãnh đạo doanh nghiệp.

## Use When
- Cần viết proposal cho khách hàng doanh nghiệp
- Cần chuẩn hoá cấu trúc đề xuất
- Cần giữ phong cách chuyên nghiệp, chiến lược

## Required Inputs
- Tên khách hàng
- Bối cảnh / nhu cầu của khách
- Đối tượng học viên
- Mục tiêu chương trình
- Thời lượng dự kiến

## Expected Output
- Proposal có cấu trúc hoàn chỉnh
- Ngôn ngữ rõ ràng, thuyết phục
- Logic: bối cảnh → vấn đề → mục tiêu → chương trình → kết quả

## Execution Approach
1. Phân tích bối cảnh và nhu cầu
2. Nhóm nhu cầu thành 3–5 mục tiêu trọng tâm
3. Thiết kế chương trình phù hợp từng nhóm
4. Viết proposal theo cấu trúc chuẩn
5. Kiểm tra sự rõ ràng và sức thuyết phục

## Verification
- Đã có đủ phần bắt buộc chưa?
- Logic triển khai (mục tiêu → kết quả) có xuyên suốt?
- Ngôn ngữ phù hợp đối tượng?
- Bám sát đầu vào (nhu cầu khách hàng)?

## Gotchas
- Nhu cầu KH mơ hồ → hỏi lại trước khi viết
- Đối tượng quá đa dạng → tách section riêng
- Thiếu data thực tế → dùng case study tương tự

## References
- templates/proposal-outline.md
- examples/sample-proposal-b2b.md
- verification/checklist.md

## Changelog
- v1.0: Khởi tạo cơ bản
- v1.1: Thêm mục tiêu chi tiết theo phòng ban
- v1.2: Cập nhật checklist, bổ sung ví dụ

Cơ chế kiểm chứng 4C

Framework 4C để thiết kế bước kiểm chứng cho mọi skill — biến đầu ra "có vẻ ổn" thành "đủ tin cậy để dùng".

Correctness — Đúng đắn

Kết quả có chính xác không? Đúng logic, đúng dữ kiện, đúng quy trình/định dạng?

📋

Completeness — Đầy đủ

Có thiếu phần nào không? Tất cả phần bắt buộc đã có chưa? Có bỏ sót bước quan trọng?

🎯

Context-fit — Phù hợp

Nội dung đúng ngành chưa? Đúng đối tượng (non-tech/kỹ thuật)? Có bám sát mục tiêu?

⚠️

Consequence — Hậu quả

Nếu kết quả này được dùng thực tế, có rủi ro gì? Có điều gì sẽ bị hiểu sai?

Câu hỏi vàng: "Nếu kết quả này được đưa vào thực tế ngay lập tức, rủi ro lớn nhất là gì?" — Thêm câu hỏi này vào cuối mỗi skill để nâng cao độ tin cậy.

4 trục tuỳ chỉnh cho cá nhân

Dựa trên định hướng cá nhân, tuỳ chỉnh bộ skill thành 4 trục chính phù hợp với bạn.

📝

Trục 1: Tư duy & Viết chiến lược AI

Phân tích, viết bài chia sẻ, nghiên cứu. VD: translate-research-into-insight, write-ai-article-in-my-voice, build-framework-from-research

🎓

Trục 2: Đào tạo doanh nghiệp

Nội dung đào tạo và case-study. VD: design-enterprise-ai-training, adapt-content-for-nontech, write-training-proposal

🤖

Trục 3: Phát triển sản phẩm/agent

Kỹ thuật và phát triển agent. VD: scaffold-agent-skill-system, design-system-prompt, build-rag-folder-structure

💼

Trục 4: Vận hành kinh doanh

Thu thập yêu cầu, họp hành, chuyển tải. VD: client-brief-to-prd, meeting-notes-to-action-plan, diagnose-ai-readiness

Lộ trình triển khai 30 ngày

Gợi ý chia tiến trình xây skill thành 5 giai đoạn — bắt đầu từ từ, tích luỹ dần và hoàn thiện bền vững.

Giai đoạn 1 — Ngày 1–7

Gom & Đánh giá

Liệt kê 10 tác vụ lặp lại nhiều nhất. Đánh giá những task vừa lặp lại, vừa giá trị để ưu tiên.

Giai đoạn 2 — Ngày 8–14

Chuẩn hoá 5 skill đầu tiên

2 skill nội dung + 2 skill đào tạo/tư vấn + 1 skill verification. Viết SKILL.md cơ bản, đặt vào thư mục, thêm templates và ví dụ đơn giản.

Giai đoạn 3 — Ngày 15–20

Hoàn thiện chi tiết

Đính kèm đầy đủ mẫu tài liệu, ví dụ đầu ra, checklist kiểm tra, kịch bản thực thi. Kiểm thử vài lần để chắc skill chạy ổn.

Giai đoạn 4 — Ngày 21–27

Thực dùng 5–10 bài toán

Quan sát: skill nào tiết kiệm thời gian nhất? Skill nào ra output chưa ổn? Lỗi lặp lại ở đâu? Ghi lại mọi thiếu sót.

Giai đoạn 5 — Ngày 28–30

Cập nhật & Đóng nhãn phiên bản

Thêm gotchas, lessons learned. Đóng nhãn version mới. Đảm bảo mọi skill đều có verification và cập nhật.

Công thức vận hành ngắn gọn

Một vòng lặp liên tục tạo ra năng lực tích luỹ — mỗi lần lặp lại đều giúp cải thiện hệ thống tổng thể.

SCOPE Xác định bài toán SKILL Chọn/tạo module EXECUTE Thực thi VERIFY Kiểm tra EVOLVE Cập nhật Vòng lặp cải tiến liên tục
Công thức vận hành: SCOPE → SKILL → EXECUTE → VERIFY → EVOLVE → (lặp lại)
Hệ Skill không chỉ giúp tăng tốc công việc một cách nhất quán, mà còn cho phép mở rộng năng lực cá nhân và tổ chức theo thời gian. Mỗi lần lặp lại — từ xác định scope đến chỉnh sửa skill — đều giúp cải thiện hệ thống tổng thể.

Nguồn tham khảo

Tài liệu chính thức và các bài viết chuyên sâu — đáng bookmark.