{"product_id":"xay-dựng-skills-cho-claude-phần-1-giới-thiệu-va-kiến-truc-cơ-bản","title":"Xây dựng Skills cho Claude — Phần 1: Giới thiệu và Kiến trúc cơ bản","description":"\n\u003cdiv class=\"serial-nav\"\u003e\n  \u003cp\u003e\u003cstrong\u003eSerial: Hướng dẫn toàn diện xây dựng Skills cho Claude\u003c\/strong\u003e | Phần 1\/6\u003c\/p\u003e\n  \u003cp\u003e\u003ca href=\"\/products\/xay-d%E1%BB%B1ng-skills-cho-claude-ph%E1%BA%A7n-2-thi%E1%BA%BFt-k%E1%BA%BF-va-l%E1%BA%ADp-k%E1%BA%BF-ho%E1%BA%A1ch\"\u003ePhần 2: Thiết kế và Lập kế hoạch →\u003c\/a\u003e\u003c\/p\u003e\n\u003c\/div\u003e\n\n\u003cp\u003e\u003cem\u003eDịch và biên soạn từ \"The Complete Guide to Building Skills for Claude\" của Anthropic.\u003c\/em\u003e\u003c\/p\u003e\n\n\u003cp\u003eSkill là một trong những cách mạnh mẽ nhất để tuỳ biến Claude theo nhu cầu cụ thể của bạn. Thay vì phải giải thích lại quy trình, sở thích và kiến thức chuyên môn trong mỗi cuộc trò chuyện, bạn chỉ cần \"dạy\" Claude một lần và hưởng lợi mãi mãi. Bài viết này mở đầu serial 6 phần, giúp bạn hiểu rõ nền tảng trước khi bắt tay vào xây dựng.\u003c\/p\u003e\n\n\u003ch2\u003eSkill là gì?\u003c\/h2\u003e\n\n\u003cp\u003eSkill là một tập hợp các chỉ dẫn (instructions) được đóng gói dưới dạng một thư mục đơn giản, dạy Claude cách xử lý các tác vụ hoặc quy trình cụ thể. Về bản chất, một skill bao gồm:\u003c\/p\u003e\n\n\u003cul\u003e\n  \u003cli\u003e\n\u003cstrong\u003eSKILL.md\u003c\/strong\u003e (bắt buộc): File hướng dẫn chính, viết bằng Markdown với YAML frontmatter\u003c\/li\u003e\n  \u003cli\u003e\n\u003cstrong\u003escripts\/\u003c\/strong\u003e (tuỳ chọn): Mã thực thi như Python, Bash\u003c\/li\u003e\n  \u003cli\u003e\n\u003cstrong\u003ereferences\/\u003c\/strong\u003e (tuỳ chọn): Tài liệu tham khảo được tải khi cần\u003c\/li\u003e\n  \u003cli\u003e\n\u003cstrong\u003eassets\/\u003c\/strong\u003e (tuỳ chọn): Template, font, icon dùng trong output\u003c\/li\u003e\n\u003c\/ul\u003e\n\n\u003cp\u003eNói đơn giản: skill giống như một \"sổ tay hướng dẫn\" mà bạn trao cho Claude. Khi người dùng yêu cầu một việc phù hợp, Claude sẽ tự động mở đúng sổ tay và làm theo.\u003c\/p\u003e\n\n\u003ch2\u003eTại sao cần Skills?\u003c\/h2\u003e\n\n\u003cp\u003eSkills đặc biệt hữu ích khi bạn có các quy trình lặp đi lặp lại:\u003c\/p\u003e\n\n\u003cul\u003e\n  \u003cli\u003eTạo giao diện frontend từ design specs\u003c\/li\u003e\n  \u003cli\u003eNghiên cứu với phương pháp luận nhất quán\u003c\/li\u003e\n  \u003cli\u003eViết tài liệu theo đúng style guide của team\u003c\/li\u003e\n  \u003cli\u003eĐiều phối các quy trình nhiều bước phức tạp\u003c\/li\u003e\n\u003c\/ul\u003e\n\n\u003cp\u003eVí dụ thực tế tại Việt Nam: Nếu bạn là một agency làm web cho nhiều khách hàng, bạn có thể tạo skill giúp Claude tự động tạo cấu trúc dự án Shopify theo chuẩn của công ty, bao gồm cả template Liquid, cấu trúc thư mục, và checklist QA. Mỗi dự án mới sẽ bắt đầu nhanh hơn và đồng nhất hơn.\u003c\/p\u003e\n\n\u003ch2\u003eAi nên đọc serial này?\u003c\/h2\u003e\n\n\u003cul\u003e\n  \u003cli\u003eDeveloper muốn Claude tuân theo quy trình cụ thể một cách nhất quán\u003c\/li\u003e\n  \u003cli\u003ePower user muốn chuẩn hoá cách Claude làm việc\u003c\/li\u003e\n  \u003cli\u003eTeam leader muốn đồng bộ cách sử dụng Claude trong tổ chức\u003c\/li\u003e\n\u003c\/ul\u003e\n\n\u003cp\u003eKết quả mong đợi: sau khi đọc xong serial 6 phần, bạn có thể xây dựng một skill hoàn chỉnh trong khoảng 15-30 phút bằng skill-creator.\u003c\/p\u003e\n\n\u003ch2\u003eNguyên tắc thiết kế cốt lõi: Progressive Disclosure\u003c\/h2\u003e\n\n\u003cp\u003eĐây là nguyên tắc quan trọng nhất cần hiểu. Skills sử dụng hệ thống 3 cấp độ để tối ưu hoá token:\u003c\/p\u003e\n\n\u003ch3\u003eCấp 1: YAML Frontmatter (luôn được tải)\u003c\/h3\u003e\n\u003cp\u003ePhần frontmatter luôn nằm trong system prompt của Claude. Nó cung cấp vừa đủ thông tin để Claude biết khi nào nên kích hoạt skill mà không cần tải toàn bộ nội dung.\u003c\/p\u003e\n\n\u003cpre\u003e\u003ccode\u003e---\nname: project-setup\ndescription: Tạo cấu trúc dự án web theo chuẩn công ty. Dùng khi người dùng nói \"tạo dự án mới\", \"setup project\", hoặc \"khởi tạo workspace\".\n---\u003c\/code\u003e\u003c\/pre\u003e\n\n\u003ch3\u003eCấp 2: Nội dung SKILL.md (tải khi cần)\u003c\/h3\u003e\n\u003cp\u003ePhần thân của file SKILL.md chỉ được tải khi Claude nhận thấy skill phù hợp với tác vụ hiện tại. Đây là nơi chứa toàn bộ hướng dẫn chi tiết.\u003c\/p\u003e\n\n\u003ch3\u003eCấp 3: File liên kết (tải theo yêu cầu)\u003c\/h3\u003e\n\u003cp\u003eCác file trong thư mục references\/, scripts\/, assets\/ chỉ được Claude truy cập khi thực sự cần thiết. Điều này giữ cho context window không bị quá tải.\u003c\/p\u003e\n\n\u003cp\u003eCơ chế này giống như cách bạn tra cứu sách: bạn đọc mục lục trước (cấp 1), lật đến chương cần đọc (cấp 2), và chỉ mở phụ lục khi cần tra chi tiết (cấp 3).\u003c\/p\u003e\n\n\u003ch2\u003eCấu trúc thư mục của một Skill\u003c\/h2\u003e\n\n\u003cpre\u003e\u003ccode\u003eyour-skill-name\/\n├── SKILL.md          # Bắt buộc - file hướng dẫn chính\n├── scripts\/          # Tuỳ chọn - mã thực thi\n│   ├── process_data.py\n│   └── validate.sh\n├── references\/       # Tuỳ chọn - tài liệu tham khảo\n│   ├── api-guide.md\n│   └── examples\/\n└── assets\/           # Tuỳ chọn - template, tài nguyên\n    └── report-template.md\u003c\/code\u003e\u003c\/pre\u003e\n\n\u003ch3\u003eQuy tắc đặt tên quan trọng\u003c\/h3\u003e\n\n\u003cul\u003e\n  \u003cli\u003e\n\u003cstrong\u003eSKILL.md\u003c\/strong\u003e phải viết đúng chính tả, phân biệt hoa thường. Không chấp nhận skill.md, SKILL.MD, hay bất kỳ biến thể nào\u003c\/li\u003e\n  \u003cli\u003e\n\u003cstrong\u003eTên thư mục\u003c\/strong\u003e phải dùng kebab-case: \u003ccode\u003enotion-project-setup\u003c\/code\u003e\n\u003c\/li\u003e\n  \u003cli\u003eKhông dùng dấu cách: \u003ccode\u003eNotion Project Setup\u003c\/code\u003e (sai)\u003c\/li\u003e\n  \u003cli\u003eKhông dùng gạch dưới: \u003ccode\u003enotion_project_setup\u003c\/code\u003e (sai)\u003c\/li\u003e\n  \u003cli\u003eKhông viết hoa: \u003ccode\u003eNotionProjectSetup\u003c\/code\u003e (sai)\u003c\/li\u003e\n  \u003cli\u003eKhông đặt file README.md trong thư mục skill\u003c\/li\u003e\n\u003c\/ul\u003e\n\n\u003ch2\u003eYAML Frontmatter: Phần quan trọng nhất\u003c\/h2\u003e\n\n\u003cp\u003eYAML frontmatter là cách Claude quyết định có nên tải skill hay không. Đây là phần bạn cần đầu tư nhiều nhất.\u003c\/p\u003e\n\n\u003ch3\u003eĐịnh dạng tối thiểu\u003c\/h3\u003e\n\n\u003cpre\u003e\u003ccode\u003e---\nname: your-skill-name\ndescription: Mô tả skill làm gì. Dùng khi người dùng yêu cầu [cụm từ cụ thể].\n---\u003c\/code\u003e\u003c\/pre\u003e\n\n\u003ch3\u003eCác trường bắt buộc\u003c\/h3\u003e\n\n\u003cul\u003e\n  \u003cli\u003e\n\u003cstrong\u003ename\u003c\/strong\u003e (bắt buộc): Dạng kebab-case, không dấu cách, không viết hoa, nên trùng tên thư mục\u003c\/li\u003e\n  \u003cli\u003e\n\u003cstrong\u003edescription\u003c\/strong\u003e (bắt buộc): Phải bao gồm CẢ hai thông tin: skill làm gì VÀ khi nào nên dùng. Dưới 1024 ký tự. Không chứa thẻ XML\u003c\/li\u003e\n\u003c\/ul\u003e\n\n\u003ch3\u003eCác trường tuỳ chọn\u003c\/h3\u003e\n\n\u003cul\u003e\n  \u003cli\u003e\n\u003cstrong\u003elicense\u003c\/strong\u003e: Nếu phát hành mã nguồn mở (MIT, Apache-2.0)\u003c\/li\u003e\n  \u003cli\u003e\n\u003cstrong\u003ecompatibility\u003c\/strong\u003e: Yêu cầu môi trường (1-500 ký tự)\u003c\/li\u003e\n  \u003cli\u003e\n\u003cstrong\u003eallowed-tools\u003c\/strong\u003e: Giới hạn quyền truy cập công cụ\u003c\/li\u003e\n  \u003cli\u003e\n\u003cstrong\u003emetadata\u003c\/strong\u003e: Các cặp key-value tuỳ chỉnh như author, version, mcp-server\u003c\/li\u003e\n\u003c\/ul\u003e\n\n\u003ch3\u003eHạn chế bảo mật\u003c\/h3\u003e\n\n\u003cul\u003e\n  \u003cli\u003eCấm dùng dấu ngoặc nhọn XML (\u0026lt; \u0026gt;) trong frontmatter\u003c\/li\u003e\n  \u003cli\u003eKhông được đặt tên skill chứa \"claude\" hoặc \"anthropic\" (từ khoá dành riêng)\u003c\/li\u003e\n\u003c\/ul\u003e\n\n\u003cp\u003eLý do: Frontmatter xuất hiện trong system prompt của Claude. Nội dung độc hại có thể inject các chỉ dẫn không mong muốn.\u003c\/p\u003e\n\n\u003ch2\u003eSkills + MCP: Mối quan hệ bổ sung\u003c\/h2\u003e\n\n\u003cp\u003eNếu bạn đã biết về MCP (Model Context Protocol), bạn sẽ thấy Skills và MCP là hai mảnh ghép hoàn hảo. Anthropic dùng phép ẩn dụ nhà bếp rất hay:\u003c\/p\u003e\n\n\u003cul\u003e\n  \u003cli\u003e\n\u003cstrong\u003eMCP là gian bếp chuyên nghiệp:\u003c\/strong\u003e cung cấp quyền truy cập công cụ, nguyên liệu và thiết bị (kết nối với Notion, Asana, Linear, GitHub...)\u003c\/li\u003e\n  \u003cli\u003e\n\u003cstrong\u003eSkills là công thức nấu ăn:\u003c\/strong\u003e hướng dẫn từng bước cách tạo ra thứ gì đó có giá trị từ những công cụ và nguyên liệu đó\u003c\/li\u003e\n\u003c\/ul\u003e\n\n\u003ctable\u003e\n  \u003ctr\u003e\n    \u003cth\u003eMCP (Kết nối)\u003c\/th\u003e\n    \u003cth\u003eSkills (Kiến thức)\u003c\/th\u003e\n  \u003c\/tr\u003e\n  \u003ctr\u003e\n    \u003ctd\u003eKết nối Claude với dịch vụ của bạn\u003c\/td\u003e\n    \u003ctd\u003eDạy Claude cách sử dụng dịch vụ hiệu quả\u003c\/td\u003e\n  \u003c\/tr\u003e\n  \u003ctr\u003e\n    \u003ctd\u003eCung cấp truy cập dữ liệu real-time và gọi công cụ\u003c\/td\u003e\n    \u003ctd\u003eNắm bắt quy trình và best practices\u003c\/td\u003e\n  \u003c\/tr\u003e\n  \u003ctr\u003e\n    \u003ctd\u003eClaude CÓ THỂ làm gì\u003c\/td\u003e\n    \u003ctd\u003eClaude NÊN làm như thế nào\u003c\/td\u003e\n  \u003c\/tr\u003e\n\u003c\/table\u003e\n\n\u003ch3\u003eKhông có Skills, điều gì xảy ra?\u003c\/h3\u003e\n\n\u003cul\u003e\n  \u003cli\u003eNgười dùng kết nối MCP nhưng không biết bắt đầu từ đâu\u003c\/li\u003e\n  \u003cli\u003eMỗi cuộc trò chuyện phải bắt đầu lại từ đầu\u003c\/li\u003e\n  \u003cli\u003eKết quả không nhất quán vì mỗi người prompt khác nhau\u003c\/li\u003e\n  \u003cli\u003eNgười dùng đổ lỗi cho connector trong khi vấn đề thực sự là thiếu hướng dẫn quy trình\u003c\/li\u003e\n\u003c\/ul\u003e\n\n\u003ch3\u003eCó Skills, bạn được gì?\u003c\/h3\u003e\n\n\u003cul\u003e\n  \u003cli\u003eQuy trình được xây dựng sẵn, tự động kích hoạt khi cần\u003c\/li\u003e\n  \u003cli\u003eSử dụng công cụ nhất quán và đáng tin cậy\u003c\/li\u003e\n  \u003cli\u003eBest practices được nhúng vào mọi tương tác\u003c\/li\u003e\n  \u003cli\u003eĐường cong học tập thấp hơn cho integration của bạn\u003c\/li\u003e\n\u003c\/ul\u003e\n\n\u003ch2\u003eComposability: Kết hợp nhiều Skills\u003c\/h2\u003e\n\n\u003cp\u003eClaude có thể tải nhiều skill đồng thời. Khi thiết kế skill, hãy đảm bảo nó hoạt động tốt cùng các skill khác, không giả định rằng nó là khả năng duy nhất có sẵn.\u003c\/p\u003e\n\n\u003cp\u003eVí dụ: Bạn có thể có skill \"tạo dự án\" và skill \"review code\" cùng hoạt động. Khi người dùng nói \"tạo dự án mới và review cấu trúc code\", cả hai skill sẽ phối hợp liền mạch.\u003c\/p\u003e\n\n\u003ch2\u003ePortability: Viết một lần, chạy mọi nơi\u003c\/h2\u003e\n\n\u003cp\u003eSkills hoạt động giống nhau trên Claude.ai, Claude Code và API. Bạn tạo skill một lần và nó chạy trên tất cả các nền tảng mà không cần sửa đổi, miễn là môi trường hỗ trợ các dependency mà skill yêu cầu.\u003c\/p\u003e\n\n\u003cp\u003eAnthropic đã công bố Agent Skills như một tiêu chuẩn mở. Giống MCP, họ tin rằng skills nên portable giữa các công cụ và nền tảng khác nhau.\u003c\/p\u003e\n\n\u003ch2\u003eHai lộ trình học trong serial này\u003c\/h2\u003e\n\n\u003cp\u003eTuỳ theo mục tiêu, bạn có thể chọn lộ trình phù hợp:\u003c\/p\u003e\n\n\u003cul\u003e\n  \u003cli\u003e\n\u003cstrong\u003eXây dựng skill độc lập (không MCP):\u003c\/strong\u003e Tập trung vào Phần 1-3 (Cơ bản, Thiết kế, Testing)\u003c\/li\u003e\n  \u003cli\u003e\n\u003cstrong\u003eTăng cường MCP integration:\u003c\/strong\u003e Đọc thêm phần \"Skills + MCP\" trong mỗi bài và Phần 5 (Patterns)\u003c\/li\u003e\n\u003c\/ul\u003e\n\n\u003cp\u003eCả hai lộ trình đều chia sẻ chung yêu cầu kỹ thuật. Bạn chọn phần nào phù hợp với use case của mình.\u003c\/p\u003e\n\n\u003ch2\u003eTổng kết Phần 1\u003c\/h2\u003e\n\n\u003cp\u003eBạn đã nắm được:\u003c\/p\u003e\n\u003cul\u003e\n  \u003cli\u003eSkill là gì và tại sao cần skill\u003c\/li\u003e\n  \u003cli\u003eNguyên tắc Progressive Disclosure 3 cấp\u003c\/li\u003e\n  \u003cli\u003eCấu trúc thư mục và quy tắc đặt tên\u003c\/li\u003e\n  \u003cli\u003eYAML frontmatter cơ bản\u003c\/li\u003e\n  \u003cli\u003eMối quan hệ Skills + MCP (phép ẩn dụ nhà bếp)\u003c\/li\u003e\n  \u003cli\u003eComposability và Portability\u003c\/li\u003e\n\u003c\/ul\u003e\n\n\u003cp\u003eTrong \u003ca href=\"\/products\/xay-d%E1%BB%B1ng-skills-cho-claude-ph%E1%BA%A7n-2-thi%E1%BA%BFt-k%E1%BA%BF-va-l%E1%BA%ADp-k%E1%BA%BF-ho%E1%BA%A1ch\"\u003ePhần 2\u003c\/a\u003e, chúng ta sẽ đi sâu vào cách thiết kế và lập kế hoạch skill: bắt đầu từ use case, phân loại skill, xác định tiêu chí thành công, và viết description chuẩn.\u003c\/p\u003e\n\n\u003cdiv class=\"serial-nav serial-nav--bottom\"\u003e\n  \u003ch3\u003eĐọc tiếp serial\u003c\/h3\u003e\n  \u003cul\u003e\n    \u003cli\u003e\n\u003cstrong\u003ePhần 1: Giới thiệu và Cơ bản\u003c\/strong\u003e (bạn đang đọc)\u003c\/li\u003e\n    \u003cli\u003e\u003ca href=\"\/products\/xay-d%E1%BB%B1ng-skills-cho-claude-ph%E1%BA%A7n-2-thi%E1%BA%BFt-k%E1%BA%BF-va-l%E1%BA%ADp-k%E1%BA%BF-ho%E1%BA%A1ch\"\u003ePhần 2: Thiết kế và Lập kế hoạch\u003c\/a\u003e\u003c\/li\u003e\n    \u003cli\u003e\u003ca href=\"\/products\/xay-d%E1%BB%B1ng-skills-cho-claude-ph%E1%BA%A7n-3-testing-va-t%E1%BB%91i-%C6%B0u-hi%E1%BB%87u-su%E1%BA%A5t\"\u003ePhần 3: Testing và Tối ưu\u003c\/a\u003e\u003c\/li\u003e\n    \u003cli\u003e\u003ca href=\"\/products\/xay-d%E1%BB%B1ng-skills-cho-claude-ph%E1%BA%A7n-4-phan-ph%E1%BB%91i-va-chia-s%E1%BA%BB\"\u003ePhần 4: Phân phối và Chia sẻ\u003c\/a\u003e\u003c\/li\u003e\n    \u003cli\u003e\u003ca href=\"\/products\/xay-d%E1%BB%B1ng-skills-cho-claude-ph%E1%BA%A7n-5-patterns-th%E1%BB%B1c-chi%E1%BA%BFn-va-x%E1%BB%AD-ly-l%E1%BB%97i\"\u003ePhần 5: Patterns và Troubleshooting\u003c\/a\u003e\u003c\/li\u003e\n    \u003cli\u003e\u003ca href=\"\/products\/xay-d%E1%BB%B1ng-skills-cho-claude-ph%E1%BA%A7n-6-tai-li%E1%BB%87u-tham-kh%E1%BA%A3o-va-checklist-hoan-ch%E1%BB%89nh\"\u003ePhần 6: Tài liệu tham khảo và Checklist\u003c\/a\u003e\u003c\/li\u003e\n  \u003c\/ul\u003e\n\u003c\/div\u003e\n","brand":"Minh Tuấn","offers":[{"title":"Default Title","offer_id":47731139969236,"sku":null,"price":0.0,"currency_code":"VND","in_stock":true}],"thumbnail_url":"\/\/cdn.shopify.com\/s\/files\/1\/0821\/0264\/9044\/files\/xay-d_ng-skills-cho-claude-ph_n-1-gi_i-thi_u-va-ki_n-truc-c_-b_n.jpg?v=1774755467","url":"https:\/\/claude.vn\/products\/xay-d%e1%bb%b1ng-skills-cho-claude-ph%e1%ba%a7n-1-gi%e1%bb%9bi-thi%e1%bb%87u-va-ki%e1%ba%bfn-truc-c%c6%a1-b%e1%ba%a3n","provider":"CLAUDE.VN","version":"1.0","type":"link"}