AI ARCHITECT STUDIOACADEMY
★ Khóa Cơ Bản · Buổi 5 · khối LÀM

Agent Skill
Skill là gì · tự tay Build Skill

Buổi 4 xem Code chạy — hôm nay hiểu skill là gì rồi tự tay dựng một skill thật.
Cả buổi build một skill duy nhất: tạo báo giá cho khách.
Buổi 5 · Khóa Cơ Bản● Powered by Claude
AI ARCHITECT STUDIOACADEMY
Khởi động

Hôm nay ta dựng thật

Rời lý thuyếtbắt tay làm — thang khó tăng vì việc khó dần, không vì nhồi lý thuyết
1 skillcả buổi build đúng một skill: tạo báo giá cho khách KTS
Đầu ra1 cây thư mục skill chạy được + tự chấm bằng checklist
AI Architect Studio · Academy2 / 16
AI ARCHITECT STUDIOACADEMY
Chương 1 · Hiểu

Skill = thư mục có SKILL.md

Một thư mục chứa SKILL.md mà agent ĐỌC và làm theo khi gặp đúng việc — KHÔNG train lại model. Weights không đổi; skill là tờ hướng dẫn đặt trước mặt một model vốn đã giỏi.
AI Architect Studio · Academy3 / 16
AI ARCHITECT STUDIOACADEMY
Bước 1 · File tối thiểu

Skill nhỏ nhất = 1 thư mục + 1 file

Bắt buộctao-bao-gia/SKILL.md — chỉ cần cái này là đã là một skill
Thêm dầnscripts/ · references/ · assets/ (tùy chọn)
Ranh giớibuild skill ≠ train model — đừng sợ, bắt đầu từ 1 file
AI Architect Studio · Academy4 / 16
AI ARCHITECT STUDIOACADEMY
Bước 2 · description

description — trái tim kích hoạt

90% skill hỏng nằm ở đây. Người bên cạnh chỉ đọc mô tả — có đoán đúng khi nào bật không?
Nêu CẢ HAI"làm gì" VÀ "khi nào dùng"
Pushyliệt kê từ khoá · tình huống · cách nói đời thường (cả khi họ không gọi đúng tên skill)
Giải thích lý dotránh ALWAYS/NEVER cứng nhắc — model tuân tốt hơn khi hiểu VÌ SAO
AI Architect Studio · Academy5 / 16
AI ARCHITECT STUDIOACADEMY
🖐 Workshop

Viết description của bạn

✍
  • Chọn 1 việc bạn làm đi làm lại
  • Viết description đạt 3 tiêu chí: làm gì + khi nào + từ khoá
  • Chấm chéo 1 câu: "người bên cạnh đọc mô tả có đoán đúng khi nào skill nên bật không?"
AI Architect Studio · Academy6 / 16
AI ARCHITECT STUDIOACADEMY
Bước 2 · Ví dụ

description mẫu — tao-bao-gia

Mẫu
name: tao-bao-gia description: > Lập báo giá chuẩn thương hiệu cho khách của KTS. Dùng bất cứ khi nào có nhắc tới báo giá · chào giá · tính chi phí · dự toán · "khách hỏi bao nhiêu tiền" · "làm cái giá"…
AI Architect Studio · Academy7 / 16
AI ARCHITECT STUDIOACADEMY
Bước 3 · Thân runbook

Thân file — chia bước SOP

Đánh sốchia bước rõ ràng — một bước = một hành động
Không trộntrộn nhiều việc = mầm mống "kích hoạt đúng nhưng làm sai bước"
Ghi rõchỗ nào ĐỌC file phụ · chỗ nào CHẠY code (chuẩn bị Bước 4–5)
AI Architect Studio · Academy8 / 16
AI ARCHITECT STUDIOACADEMY
Bước 4 · references/

Giữ lõi gọn — đẩy chi tiết xuống tầng 3

Tự tay làm ra progressive disclosure — cái buổi 3 chỉ ngồi nhìn.
Tầng 2SKILL.md — chỉ giữ bước cần cho MỌI lần chạy
Tầng 3references/ — chi tiết dài, ví dụ, rubric → nạp KHI CẦN
Lợicontext không tràn · chuẩn không loãng · đóng gói gần như vô hạn
AI Architect Studio · Academy9 / 16
AI ARCHITECT STUDIOACADEMY
Bước 5 · CAO TRÀO

Tiền — thứ CẤM model ứng biến

Determinism (cùng đầu vào → cùng kết quả). Để model tự "nghĩ" ra số tiền = vừa ĐẮT vừa KHÔNG ổn định → khóa bằng script. Tín hiệu: agent viết lại cùng đoạn code nhiều lần → đóng thành script. (Khoảnh khắc aha của cả buổi.)
AI Architect Studio · Academy10 / 16
AI ARCHITECT STUDIOACADEMY
Bước 6 · Xây từ lỗi

Skill tốt sinh từ lỗi

Bắt đầuđánh giá — cho agent chạy THẬT, quan sát chỗ nó vấp
Vá tăng dầnmỗi vòng chỉ vá một thứ vừa quan sát được (thêm 1 dòng SOP / sửa script)
Lặp cùng Claudeyêu cầu Claude tự ghi cách làm thành công + tự phản tỉnh khi sai
AI Architect Studio · Academy11 / 16
AI ARCHITECT STUDIOACADEMY
Bước 7 · Nghiệm thu

Checklist — skill đủ chín chưa?

descriptionnêu cả làm-gì + khi-nào + từ khoá (đủ pushy)?
Thân · tầngchia bước rõ? phần ít dùng đã tách references/?
Determinismviệc tất định (tính tiền) đã đóng script? ghi rõ CHẠY/ĐỌC?
Chạy thửđã chạy thật + quan sát skill kích hoạt đúng lúc?
AI Architect Studio · Academy12 / 16
AI ARCHITECT STUDIOACADEMY
Bước 7 · Version + Bảo mật

Đóng băng · an toàn

Frozen = skillbrand + rubric + SOP + template — quản bằng git, đổi phải có lý do + số phiên bản
Instance ≠ Skillbản chạy kế thừa skill, KHÔNG sửa ngược (Skill→Instance ✔ · Instance→Skill ✘)
Bảo mậtchỉ cài skill nguồn tin cậy · nguồn kém tin → audit đọc MỌI file trước khi dùng
AI Architect Studio · Academy13 / 16
AI ARCHITECT STUDIOACADEMY
Ráp lại · 4 trục

Skill hoàn chỉnh = 4 trục đóng gói

Cây skill
tao-bao-gia/ ├── SKILL.md (lõi gọn — tầng 2) ├── scripts/tinh_bao_gia.py (DETERMINISM) ├── assets/mau-bao-gia.md (TEMPLATE + BRAND) └── references/rubric-bao-gia.md (RUBRIC)
AI Architect Studio · Academy14 / 16
AI ARCHITECT STUDIOACADEMY
Bài về nhà

Bài về nhà

1Chọn 1 việc bạn làm lặp lại nhất tuần qua
2Dựng skill cho nó theo đúng 7 bước
3Tự chấm bằng checklist 10 mục
4Nộp: cây thư mục + description + "chỗ nào khóa bằng script, vì sao"
AI Architect Studio · Academy15 / 16
AI ARCHITECT STUDIOACADEMY
Câu chốt

Đóng gói nghề thành công cụ dùng lại

Skill = brand · SOP · rubric · template gói thành một thư mục agent chạy được. Nội dung là của bạn — skill giúp nó lặp lại được, chuẩn mỗi lần. Nguồn: Anthropic · Agent Skills.
AI Architect Studio · Academy16 / 16