.claude/agents/ hay .claude/skills/ — và nó vận hành hoàn hảo.Mở đầu — Lật ngược mặc định
Trong tài liệu chính thức của Claude Code, bạn sẽ đọc thấy: sub-agent nằm ở.claude/agents/, skill nằm ở .claude/skills/. Nghe như quy tắc cứng.
Nhưng không phải.
Chúng tôi không dùng cấu trúc đó. Dự án Luklak tổ chức toàn bộ agent Lulu ở luklak-mintlify-docs/Lulu/ — một đường dẫn hoàn toàn tự chọn, tên thư mục tự đặt, hệ phân cấp tự thiết kế. Và Claude Code vẫn gọi đúng skill, đúng lúc, đúng context.
Bài này kể lại cách chúng tôi làm, vì sao nó chạy được, và bạn có thể bắt chước như thế nào.
Vì sao nó vẫn chạy được?
- Bạn tham chiếu đường dẫn file → Claude đọc qua công cụ
Read - Bạn mô tả vai trò và skill của agent trong prompt → Claude “nhập vai” agent đó cho lượt đó
- Bạn yêu cầu “chạy skill dịch thuật” → Claude đọc file skill đó và làm theo
- Sub-agent có thể được định nghĩa inline trong prompt, không nhất thiết trong file
.claude/agents/ và .claude/skills/ chỉ là đường tắt (shortcut) để Claude Code tự động phát hiện (auto-discover) agent và skill. Nếu bạn không dùng đường tắt đó, bạn chỉ cần chỉ đường thủ công — mà thủ công thì không khó, chỉ là viết đường dẫn vào prompt.
Tham quan thư mục Lulu
Cấu trúc thực tế của agent Lulu DocOps trong repo Luklak:00-identity — Lulu là ai?
00-identity — Lulu là ai?
01-system-prompt — Bộ não trung tâm
01-system-prompt — Bộ não trung tâm
02-skills — Tay nghề chuyên biệt
02-skills — Tay nghề chuyên biệt
03-reference — Thư viện tra cứu
03-reference — Thư viện tra cứu
docs.json. Khi Lulu cần xác minh một thông tin, nó đọc từ đây thay vì bịa.04-glossary — Từ điển EN↔VI
04-glossary — Từ điển EN↔VI
05-templates — Khuôn mẫu .mdx
05-templates — Khuôn mẫu .mdx
.mdx có sẵn cấu trúc frontmatter, component layout, vị trí callout. Lulu chỉ điền nội dung vào khuôn — không phải dựng lại mỗi lần.06-quality — Cửa chất lượng
06-quality — Cửa chất lượng
99-archive — Nghĩa trang có thứ tự
99-archive — Nghĩa trang có thứ tự
So sánh: Chính thức vs Của chúng tôi
- Chính thức (theo docs Claude Code)
- Của chúng tôi (Lulu)
.claude/ và nạp mọi agent, skill nó tìm thấy. Bạn không phải chỉ đường — framework làm giúp.Phù hợp cho: dự án lập trình, nơi thư mục .claude/ nằm gọn cùng source code, team dev quen với convention.Một skill file trông như thế nào?
Trích đoạn skill-translate-en-to-vi.md (40 dòng đầu)
Trích đoạn skill-translate-en-to-vi.md (40 dòng đầu)
Cách Lulu được “nhập vai” — sơ đồ luồng
Không có “magic registration”. Claude chỉ đọc đúng file theo thứ tự bạn chỉ dẫn, rồi thực thi với toàn bộ ngữ cảnh đã nạp. Đây là lý do cấu trúc Lulu hoạt động — mỗi folder có trách nhiệm rõ ràng, mỗi skill tự khép kín.Cách Lulu được “nhập vai” — các bước cụ thể
Khi bắt đầu một phiên làm việc, bạn không cần “khởi động Lulu” đặc biệt. Chỉ cần:Mở Claude Code trong thư mục dự án
mintlify-tailieuvn hoặc luklak-mintlify-docs — nơi có folder Lulu/.Ra lệnh chỉ đường rõ ràng
Lulu/00-identity/lulu-charter.md, sau đó làm theo Lulu/02-skills/skill-translate-en-to-vi.md cho file X.”Claude tự nhập vai
- Dùng tool
Readđọc charter → hiểu danh tính Lulu, giọng điệu, nguyên tắc - Dùng tool
Readđọc skill file → hiểu các bước cần theo - Áp dụng đúng style, thuật ngữ, quy trình vào task
Kết quả thực tế
Điểm quan trọng: không phải công cụ quyết định kết quả — mà là cách bạn tổ chức ngữ cảnh. Cấu trúc Lulu tự thiết kế giúp một biên tập viên người thật hiểu hệ thống trong 15 phút, và giúp Claude nhập vai đúng trong một câu lệnh.Tự kiểm tra
Câu 1: Sub-agent phải đặt trong `.claude/agents/` mới hoạt động?
Câu 1: Sub-agent phải đặt trong `.claude/agents/` mới hoạt động?
.claude/agents/ chỉ là đường tắt để auto-discover; nếu không dùng, bạn chỉ việc nêu đường dẫn trong prompt.Câu 2: Nếu tôi không có Lulu folder, tôi có thể bắt chước cách tổ chức này cho agent của mình không?
Câu 2: Nếu tôi không có Lulu folder, tôi có thể bắt chước cách tổ chức này cho agent của mình không?
04-policies/, HR có thể cần 04-templates-letters/, Sales có thể cần 04-playbooks-by-stage/. Hãy lấy nguyên lý phân chia, đừng lấy tên folder.Câu 3: Claude Code có 'discover' agent của tôi tự động như cách nó discover `.claude/agents/`?
Câu 3: Claude Code có 'discover' agent của tôi tự động như cách nó discover `.claude/agents/`?
README.md hoặc CLAUDE.md ở gốc dự án: “Agent X ở đường dẫn Y, khởi động bằng prompt Z.” Claude sẽ đọc CLAUDE.md đầu mỗi phiên và biết đường tìm.Bài tập
Chọn một vai trò trong công ty bạn
Liệt kê 3-5 task chính vai trò đó làm hàng ngày
Đặt tên skill cho mỗi task
skill-review-invoice.md, skill-draft-offer-letter.md, skill-weekly-revenue-report.md.Phác thảo cấu trúc folder cho agent của bạn
00-identity/, 01-policies/, 02-skills/, 03-data-sources/, 04-templates/, 05-review-gates/.Viết một file charter.md ngắn
Thử bằng Claude Code