{"product_id":"hướng-dẫn-toan-diện-xay-dựng-skills-cho-claude-tổng-hợp-từ-tai-liệu-chinh-thức-anthropic","title":"Hướng dẫn toàn diện xây dựng Skills cho Claude — Tổng hợp từ tài liệu chính thức Anthropic","description":"\n\u003cdiv class=\"source-credit\" style=\"background: #f5f0eb; padding: 1.5rem; border-radius: 8px; margin-bottom: 2rem;\"\u003e\n  \u003cp\u003e\u003cstrong\u003eNguồn gốc:\u003c\/strong\u003e Bài viết này được dịch và biên soạn từ tài liệu chính thức của Anthropic.\u003c\/p\u003e\n  \u003cp\u003e\u003ca href=\"https:\/\/resources.anthropic.com\/hubfs\/The-Complete-Guide-to-Building-Skill-for-Claude.pdf?hsLang=en\" target=\"_blank\" rel=\"noopener\"\u003eTải tài liệu gốc (PDF tiếng Anh)\u003c\/a\u003e\u003c\/p\u003e\n\u003c\/div\u003e\n\n\u003ch2\u003eGiới thiệu: Skill là gì và tại sao quan trọng?\u003c\/h2\u003e\n\n\u003cp\u003eSkill là một tập hợp hướng dẫn được đóng gói dưới dạng thư mục, giúp dạy Claude cách xử lý các tác vụ hoặc quy trình làm việc cụ thể. Thay vì phải giải thích lại sở thích, quy trình và kiến thức chuyên môn trong mỗi cuộc hội thoại, Skills cho phép bạn dạy Claude một lần và hưởng lợi mỗi khi sử dụng. Đây là một trong những cách mạnh mẽ nhất để tùy biến Claude phục vụ nhu cầu riêng của bạn.\u003c\/p\u003e\n\n\u003cp\u003eSkills phát huy sức mạnh khi bạn có các quy trình lặp lại: tạo giao diện frontend từ specs, thực hiện nghiên cứu với phương pháp nhất quán, tạo tài liệu theo style guide của nhóm, hay điều phối các quy trình nhiều bước. Chúng hoạt động tốt với các khả năng tích hợp sẵn của Claude như thực thi mã và tạo tài liệu. Đối với những ai đang xây dựng tích hợp MCP, Skills bổ sung thêm một lớp mạnh mẽ giúp biến quyền truy cập công cụ thô thành các quy trình làm việc đáng tin cậy và tối ưu.\u003c\/p\u003e\n\n\u003cp\u003eBài viết này là bản tổng hợp toàn bộ tài liệu \"The Complete Guide to Building Skills for Claude\" của Anthropic. Dù bạn đang xây dựng Skill cho bản thân, cho nhóm, hay cho cộng đồng, đây là lộ trình giúp bạn nắm vững mọi khía cạnh cần thiết. Serial gồm 6 phần chi tiết, mỗi phần đi sâu vào một chủ đề cụ thể. Bài tổng quan này giúp bạn có cái nhìn toàn cảnh trước khi đọc từng phần.\u003c\/p\u003e\n\n\u003ch2\u003eTổng quan 6 chương trong tài liệu gốc\u003c\/h2\u003e\n\n\u003ch3\u003eChương 1: Kiến thức nền tảng (Fundamentals)\u003c\/h3\u003e\n\u003cp\u003eChương mở đầu giải thích Skill là gì từ góc độ kỹ thuật — một thư mục chứa file SKILL.md bắt buộc cùng các thư mục tùy chọn như scripts\/, references\/ và assets\/. Chương này giới thiệu ba nguyên tắc thiết kế cốt lõi: Progressive Disclosure (tiết lộ dần), Composability (khả năng kết hợp) và Portability (tính di động). Đặc biệt, phần \"Skills + MCP Connectors\" giải thích cách Skills bổ trợ cho MCP thông qua phép ẩn dụ nhà bếp nổi tiếng.\u003c\/p\u003e\n\u003cp\u003e\u003ca href=\"\/en\/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\"\u003eĐọc chi tiết Phần 1: Giới thiệu và Kiến trúc cơ bản\u003c\/a\u003e\u003c\/p\u003e\n\n\u003ch3\u003eChương 2: Lập kế hoạch và Thiết kế (Planning and Design)\u003c\/h3\u003e\n\u003cp\u003eTrước khi viết bất kỳ dòng mã nào, bạn cần xác định 2-3 use case cụ thể mà Skill cần hỗ trợ. Chương này trình bày 3 loại Skill phổ biến (Document Creation, Workflow Automation, MCP Enhancement), cách định nghĩa tiêu chí thành công, yêu cầu kỹ thuật về cấu trúc thư mục, YAML frontmatter, và kỹ thuật viết hướng dẫn hiệu quả trong SKILL.md.\u003c\/p\u003e\n\u003cp\u003e\u003ca href=\"\/en\/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\"\u003eĐọc chi tiết Phần 2: Thiết kế và Lập kế hoạch\u003c\/a\u003e\u003c\/p\u003e\n\n\u003ch3\u003eChương 3: Testing và Tối ưu (Testing and Iteration)\u003c\/h3\u003e\n\u003cp\u003eSkills có thể được kiểm thử ở nhiều mức độ: thủ công trong Claude.ai, scripted trong Claude Code, hoặc programmatic qua Skills API. Chương này đề xuất phương pháp kiểm thử theo 3 vùng: Triggering tests (Skill có kích hoạt đúng lúc không), Functional tests (kết quả có chính xác không), và Performance comparison (so sánh có\/không có Skill). Phần sử dụng skill-creator để tạo và cải thiện Skill cũng được đề cập chi tiết.\u003c\/p\u003e\n\u003cp\u003e\u003ca href=\"\/en\/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\"\u003eĐọc chi tiết Phần 3: Testing và Tối ưu hiệu suất\u003c\/a\u003e\u003c\/p\u003e\n\n\u003ch3\u003eChương 4: Phân phối và Chia sẻ (Distribution and Sharing)\u003c\/h3\u003e\n\u003cp\u003eKhi Skill đã sẵn sàng, bạn cần phân phối nó đến người dùng. Chương này trình bày mô hình phân phối hiện tại (tải về, zip, upload), triển khai cấp tổ chức, sử dụng Skills qua API cho các hệ thống tự động, và chiến lược định vị sản phẩm — tập trung vào kết quả thay vì tính năng kỹ thuật. Anthropic cũng công bố Agent Skills như một tiêu chuẩn mở.\u003c\/p\u003e\n\u003cp\u003e\u003ca href=\"\/en\/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\"\u003eĐọc chi tiết Phần 4: Phân phối và Chia sẻ\u003c\/a\u003e\u003c\/p\u003e\n\n\u003ch3\u003eChương 5: Patterns thực chiến và Xử lý lỗi (Patterns and Troubleshooting)\u003c\/h3\u003e\n\u003cp\u003eĐây là chương thực chiến nhất, tổng hợp 5 patterns đã được kiểm chứng từ early adopters và nội bộ Anthropic: Sequential Workflow, Multi-MCP Coordination, Iterative Refinement, Context-aware Tool Selection, và Domain-specific Intelligence. Phần troubleshooting bao quát các lỗi phổ biến từ upload thất bại đến Skill không kích hoạt đúng.\u003c\/p\u003e\n\u003cp\u003e\u003ca href=\"\/en\/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\"\u003eĐọc chi tiết Phần 5: Patterns thực chiến và Xử lý lỗi\u003c\/a\u003e\u003c\/p\u003e\n\n\u003ch3\u003eChương 6: Tài liệu tham khảo và Checklist (Resources and References)\u003c\/h3\u003e\n\u003cp\u003eChương cuối cung cấp danh sách tài liệu chính thức, công cụ hỗ trợ (skill-creator), checklist hoàn chỉnh trước\/trong\/sau khi upload, bảng tham chiếu YAML frontmatter đầy đủ, và liên kết đến các ví dụ Skill hoàn chỉnh trên GitHub. Đây là chương bạn sẽ quay lại nhiều lần trong quá trình phát triển.\u003c\/p\u003e\n\u003cp\u003e\u003ca href=\"\/en\/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\"\u003eĐọc chi tiết Phần 6: Tài liệu tham khảo và Checklist hoàn chỉnh\u003c\/a\u003e\u003c\/p\u003e\n\n\u003ch2\u003eKiến trúc cơ bản: Progressive Disclosure và cấu trúc SKILL.md\u003c\/h2\u003e\n\n\u003cp\u003eMột trong những nguyên tắc thiết kế quan trọng nhất của Skills là Progressive Disclosure — tiết lộ thông tin theo từng cấp độ. Hệ thống này giúp tối thiểu hóa lượng token sử dụng trong khi vẫn duy trì chuyên môn chuyên sâu.\u003c\/p\u003e\n\n\u003ch3\u003eBa cấp độ Progressive Disclosure\u003c\/h3\u003e\n\n\u003cp\u003e\u003cstrong\u003eCấp 1 — YAML frontmatter:\u003c\/strong\u003e Luôn được tải vào system prompt của Claude. Cung cấp vừa đủ thông tin để Claude biết khi nào nên sử dụng mỗi Skill, mà không cần tải toàn bộ nội dung. Đây là \"bộ lọc\" đầu tiên quyết định Skill có được kích hoạt hay không.\u003c\/p\u003e\n\n\u003cp\u003e\u003cstrong\u003eCấp 2 — Phần thân SKILL.md:\u003c\/strong\u003e Được tải khi Claude đánh giá Skill phù hợp với tác vụ hiện tại. Chứa toàn bộ hướng dẫn và chỉ dẫn chi tiết — đây là nơi bạn viết các bước thực hiện, ví dụ, và quy tắc xử lý.\u003c\/p\u003e\n\n\u003cp\u003e\u003cstrong\u003eCấp 3 — Tệp liên kết:\u003c\/strong\u003e Các tệp bổ sung trong thư mục Skill mà Claude có thể chọn truy cập khi cần. Bao gồm tài liệu tham chiếu trong references\/, scripts thực thi trong scripts\/, và templates trong assets\/.\u003c\/p\u003e\n\n\u003ch3\u003eCấu trúc thư mục của một Skill\u003c\/h3\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\/          # Tùy chọn - mã thực thi\n│   ├── process_data.py\n│   └── validate.sh\n├── references\/       # Tùy chọn - tài liệu tham chiếu\n│   ├── api-guide.md\n│   └── examples\/\n└── assets\/           # Tùy chọn - templates, fonts, icons\n    └── report-template.md\u003c\/code\u003e\u003c\/pre\u003e\n\n\u003ch3\u003eYAML frontmatter tối thiểu\u003c\/h3\u003e\n\n\u003cp\u003eĐể bắt đầu, bạn chỉ cần hai trường bắt buộc trong YAML frontmatter:\u003c\/p\u003e\n\n\u003cpre\u003e\u003ccode\u003e---\nname: your-skill-name\ndescription: What it does. Use when user asks to [specific phrases].\n---\u003c\/code\u003e\u003c\/pre\u003e\n\n\u003cp\u003eTrong đó, \u003ccode\u003ename\u003c\/code\u003e phải dùng kebab-case (chữ thường, dấu gạch ngang), và \u003ccode\u003edescription\u003c\/code\u003e phải bao gồm cả việc Skill làm gì lẫn khi nào nên dùng nó. File phải đặt tên chính xác là \u003ccode\u003eSKILL.md\u003c\/code\u003e (phân biệt hoa thường), không chấp nhận biến thể nào khác.\u003c\/p\u003e\n\n\u003ch3\u003eYAML frontmatter đầy đủ\u003c\/h3\u003e\n\n\u003cpre\u003e\u003ccode\u003e---\nname: skill-name\ndescription: Mô tả skill và khi nào nên sử dụng.\nlicense: MIT\nallowed-tools: \"Bash(python:*) Bash(npm:*) WebFetch\"\nmetadata:\n  author: Company Name\n  version: 1.0.0\n  mcp-server: server-name\n  category: productivity\n  tags: [project-management, automation]\n  documentation: https:\/\/example.com\/docs\n  support: support@example.com\n---\u003c\/code\u003e\u003c\/pre\u003e\n\n\u003ch2\u003e3 loại Skills phổ biến\u003c\/h2\u003e\n\n\u003cp\u003eQua kinh nghiệm nội bộ và từ cộng đồng early adopters, Anthropic đã nhận diện 3 loại Skill chính mà hầu hết use case đều rơi vào.\u003c\/p\u003e\n\n\u003ch3\u003eLoại 1: Document and Asset Creation\u003c\/h3\u003e\n\u003cp\u003eTạo output nhất quán, chất lượng cao bao gồm tài liệu, bài thuyết trình, ứng dụng, thiết kế và mã nguồn. Loại này không yêu cầu công cụ bên ngoài — sử dụng hoàn toàn khả năng tích hợp sẵn của Claude.\u003c\/p\u003e\n\u003cp\u003e\u003cstrong\u003eVí dụ thực tế:\u003c\/strong\u003e Skill \u003cem\u003efrontend-design\u003c\/em\u003e — \"Tạo giao diện frontend production-grade với chất lượng thiết kế cao. Sử dụng khi xây dựng web components, pages, hoặc ứng dụng.\"\u003c\/p\u003e\n\u003cp\u003e\u003cstrong\u003eKỹ thuật chính:\u003c\/strong\u003e nhúng style guide và brand standards, cấu trúc template cho output nhất quán, checklist chất lượng trước khi hoàn thiện.\u003c\/p\u003e\n\n\u003ch3\u003eLoại 2: Workflow Automation\u003c\/h3\u003e\n\u003cp\u003eQuy trình nhiều bước hưởng lợi từ phương pháp nhất quán, bao gồm phối hợp giữa nhiều MCP server.\u003c\/p\u003e\n\u003cp\u003e\u003cstrong\u003eVí dụ thực tế:\u003c\/strong\u003e Skill \u003cem\u003eskill-creator\u003c\/em\u003e — \"Hướng dẫn tương tác để tạo skill mới. Dẫn dắt người dùng qua định nghĩa use case, tạo frontmatter, viết hướng dẫn, và xác thực.\"\u003c\/p\u003e\n\u003cp\u003e\u003cstrong\u003eKỹ thuật chính:\u003c\/strong\u003e quy trình từng bước với validation gates, templates cho các cấu trúc phổ biến, gợi ý cải thiện tích hợp, vòng lặp tinh chỉnh.\u003c\/p\u003e\n\n\u003ch3\u003eLoại 3: MCP Enhancement\u003c\/h3\u003e\n\u003cp\u003eHướng dẫn quy trình làm việc để nâng cao khả năng truy cập công cụ mà MCP server cung cấp. Đây là loại Skill dành cho những ai đã có MCP server và muốn biến truy cập công cụ thô thành quy trình mượt mà.\u003c\/p\u003e\n\u003cp\u003e\u003cstrong\u003eVí dụ thực tế:\u003c\/strong\u003e Skill \u003cem\u003esentry-code-review\u003c\/em\u003e (từ Sentry) — \"Tự động phân tích và sửa bug phát hiện được trong GitHub Pull Requests sử dụng dữ liệu monitoring từ Sentry qua MCP server.\"\u003c\/p\u003e\n\u003cp\u003e\u003cstrong\u003eKỹ thuật chính:\u003c\/strong\u003e phối hợp nhiều MCP call theo trình tự, nhúng chuyên môn domain, cung cấp ngữ cảnh người dùng thường phải chỉ định riêng, xử lý lỗi cho các vấn đề MCP phổ biến.\u003c\/p\u003e\n\n\u003ch2\u003eSkills + MCP: Phép ẩn dụ nhà bếp\u003c\/h2\u003e\n\n\u003cp\u003eAnthropic sử dụng một phép ẩn dụ đơn giản nhưng rất hiệu quả để giải thích mối quan hệ giữa Skills và MCP:\u003c\/p\u003e\n\n\u003cp\u003e\u003cstrong\u003eMCP cung cấp căn bếp chuyên nghiệp:\u003c\/strong\u003e quyền truy cập vào công cụ, nguyên liệu, và thiết bị. MCP kết nối Claude với dịch vụ của bạn (Notion, Asana, Linear...), cung cấp truy cập dữ liệu thời gian thực và khả năng gọi công cụ.\u003c\/p\u003e\n\n\u003cp\u003e\u003cstrong\u003eSkills cung cấp 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ị. Skills dạy Claude cách sử dụng dịch vụ hiệu quả, nắm bắt quy trình và best practices.\u003c\/p\u003e\n\n\u003ch3\u003eSo sánh trước và sau khi có Skills\u003c\/h3\u003e\n\n\u003ctable\u003e\n  \u003cthead\u003e\n    \u003ctr\u003e\n      \u003cth\u003eTiêu chí\u003c\/th\u003e\n      \u003cth\u003eChỉ có MCP (không có Skills)\u003c\/th\u003e\n      \u003cth\u003eMCP + Skills\u003c\/th\u003e\n    \u003c\/tr\u003e\n  \u003c\/thead\u003e\n  \u003ctbody\u003e\n    \u003ctr\u003e\n      \u003ctd\u003eTrải nghiệm người dùng\u003c\/td\u003e\n      \u003ctd\u003eKết nối xong nhưng không biết làm gì tiếp\u003c\/td\u003e\n      \u003ctd\u003eQuy trình dựng sẵn tự kích hoạt khi cần\u003c\/td\u003e\n    \u003c\/tr\u003e\n    \u003ctr\u003e\n      \u003ctd\u003eHỗ trợ\u003c\/td\u003e\n      \u003ctd\u003eSupport tickets hỏi \"làm X như thế nào?\"\u003c\/td\u003e\n      \u003ctd\u003eBest practices nhúng sẵn trong mỗi tương tác\u003c\/td\u003e\n    \u003c\/tr\u003e\n    \u003ctr\u003e\n      \u003ctd\u003eTính nhất quán\u003c\/td\u003e\n      \u003ctd\u003eKết quả khác nhau vì mỗi người prompt khác nhau\u003c\/td\u003e\n      \u003ctd\u003eSử dụng công cụ nhất quán, đáng tin cậy\u003c\/td\u003e\n    \u003c\/tr\u003e\n    \u003ctr\u003e\n      \u003ctd\u003eĐường cong học tập\u003c\/td\u003e\n      \u003ctd\u003eMỗi cuộc hội thoại bắt đầu từ đầu\u003c\/td\u003e\n      \u003ctd\u003eGiảm đáng kể thời gian làm quen\u003c\/td\u003e\n    \u003c\/tr\u003e\n    \u003ctr\u003e\n      \u003ctd\u003eQuy lỗi\u003c\/td\u003e\n      \u003ctd\u003eNgười dùng đổ lỗi cho connector khi thực ra thiếu hướng dẫn\u003c\/td\u003e\n      \u003ctd\u003eHướng dẫn quy trình rõ ràng giảm hiểu lầm\u003c\/td\u003e\n    \u003c\/tr\u003e\n  \u003c\/tbody\u003e\n\u003c\/table\u003e\n\n\u003ch2\u003e5 Patterns quan trọng đã được kiểm chứng\u003c\/h2\u003e\n\n\u003cp\u003eNhững patterns này xuất hiện từ các Skill do early adopters và nhóm nội bộ tạo ra. Chúng đại diện cho các cách tiếp cận phổ biến đã được chứng minh hiệu quả.\u003c\/p\u003e\n\n\u003ch3\u003ePattern 1: Sequential Workflow Orchestration\u003c\/h3\u003e\n\u003cp\u003e\u003cstrong\u003eSử dụng khi:\u003c\/strong\u003e người dùng cần quy trình nhiều bước theo thứ tự cụ thể. Mỗi bước có thứ tự rõ ràng, phụ thuộc giữa các bước, xác thực ở từng giai đoạn, và hướng dẫn rollback khi thất bại. Ví dụ: quy trình onboard khách hàng mới gồm tạo tài khoản, thiết lập thanh toán, tạo subscription, và gửi email chào mừng.\u003c\/p\u003e\n\n\u003ch3\u003ePattern 2: Multi-MCP Coordination\u003c\/h3\u003e\n\u003cp\u003e\u003cstrong\u003eSử dụng khi:\u003c\/strong\u003e quy trình trải dài qua nhiều dịch vụ. Ví dụ: handoff từ thiết kế sang phát triển — export từ Figma MCP, lưu trữ trên Drive MCP, tạo task trên Linear MCP, và thông báo trên Slack MCP. Kỹ thuật chính: phân chia phase rõ ràng, truyền dữ liệu giữa các MCP, xác thực trước khi chuyển phase.\u003c\/p\u003e\n\n\u003ch3\u003ePattern 3: Iterative Refinement\u003c\/h3\u003e\n\u003cp\u003e\u003cstrong\u003eSử dụng khi:\u003c\/strong\u003e chất lượng output cải thiện qua lặp lại. Ví dụ: tạo báo cáo qua các vòng draft, kiểm tra chất lượng bằng validation script, sửa từng vấn đề, và lặp lại cho đến khi đạt ngưỡng chất lượng. Điểm mấu chốt là biết khi nào nên dừng lặp.\u003c\/p\u003e\n\n\u003ch3\u003ePattern 4: Context-aware Tool Selection\u003c\/h3\u003e\n\u003cp\u003e\u003cstrong\u003eSử dụng khi:\u003c\/strong\u003e cùng kết quả mong muốn nhưng công cụ khác nhau tùy ngữ cảnh. Ví dụ: lưu trữ file — file lớn (\u0026gt;10MB) dùng cloud storage, tài liệu cộng tác dùng Notion\/Docs, file code dùng GitHub, file tạm dùng local. Skill đưa ra quyết định dựa trên cây quyết định rõ ràng và giải thích cho người dùng lý do lựa chọn.\u003c\/p\u003e\n\n\u003ch3\u003ePattern 5: Domain-specific Intelligence\u003c\/h3\u003e\n\u003cp\u003e\u003cstrong\u003eSử dụng khi:\u003c\/strong\u003e Skill cần thêm kiến thức chuyên biệt vượt xa quyền truy cập công cụ. Ví dụ: xử lý thanh toán với tuân thủ pháp luật — kiểm tra danh sách cấm vận, xác minh quyền tài phán, đánh giá mức độ rủi ro, ghi log audit trail. Kiến thức chuyên môn domain được nhúng trực tiếp vào logic của Skill.\u003c\/p\u003e\n\n\u003ch2\u003eQuy trình xây dựng Skill từ đầu đến cuối\u003c\/h2\u003e\n\n\u003cp\u003eDựa trên tài liệu chính thức, quy trình xây dựng một Skill hoàn chỉnh gồm 4 giai đoạn chính:\u003c\/p\u003e\n\n\u003ch3\u003eGiai đoạn 1: Lập kế hoạch\u003c\/h3\u003e\n\u003cul\u003e\n  \u003cli\u003eXác định 2-3 use case cụ thể mà Skill cần hỗ trợ\u003c\/li\u003e\n  \u003cli\u003eTrả lời: Người dùng muốn đạt được gì? Cần quy trình nhiều bước nào? Công cụ nào cần thiết (built-in hay MCP)? Kiến thức domain nào cần nhúng?\u003c\/li\u003e\n  \u003cli\u003eĐịnh nghĩa tiêu chí thành công — cả định lượng (Skill kích hoạt trên 90% truy vấn liên quan, hoàn thành trong X tool calls) và định tính (người dùng không cần prompt thêm, quy trình hoàn thành không cần sửa)\u003c\/li\u003e\n  \u003cli\u003eChọn loại Skill phù hợp: Document Creation, Workflow Automation, hay MCP Enhancement\u003c\/li\u003e\n\u003c\/ul\u003e\n\n\u003ch3\u003eGiai đoạn 2: Xây dựng\u003c\/h3\u003e\n\u003cul\u003e\n  \u003cli\u003eTạo cấu trúc thư mục kebab-case với SKILL.md (chính xác tên này, phân biệt hoa thường)\u003c\/li\u003e\n  \u003cli\u003eViết YAML frontmatter với name (kebab-case) và description (bao gồm cả WHAT và WHEN)\u003c\/li\u003e\n  \u003cli\u003eViết hướng dẫn trong thân SKILL.md — cụ thể, có thể hành động, kèm ví dụ\u003c\/li\u003e\n  \u003cli\u003eThêm scripts\/, references\/, assets\/ nếu cần\u003c\/li\u003e\n  \u003cli\u003eBao gồm xử lý lỗi và troubleshooting cho các tình huống phổ biến\u003c\/li\u003e\n\u003c\/ul\u003e\n\n\u003ch3\u003eGiai đoạn 3: Kiểm thử\u003c\/h3\u003e\n\u003cul\u003e\n  \u003cli\u003e\n\u003cstrong\u003eTriggering tests:\u003c\/strong\u003e Skill có kích hoạt trên các tác vụ rõ ràng không? Trên yêu cầu diễn đạt khác? Có kích hoạt nhầm trên chủ đề không liên quan không?\u003c\/li\u003e\n  \u003cli\u003e\n\u003cstrong\u003eFunctional tests:\u003c\/strong\u003e Output có chính xác không? API call có thành công không? Edge case có được xử lý không?\u003c\/li\u003e\n  \u003cli\u003e\n\u003cstrong\u003ePerformance comparison:\u003c\/strong\u003e So sánh kết quả có và không có Skill — số tin nhắn qua lại, số API call thất bại, tổng token tiêu thụ\u003c\/li\u003e\n  \u003cli\u003eMẹo: Lặp lại trên một tác vụ duy nhất cho đến khi Claude thành công, rồi mới mở rộng sang nhiều test case\u003c\/li\u003e\n\u003c\/ul\u003e\n\n\u003ch3\u003eGiai đoạn 4: Phân phối và Cải thiện\u003c\/h3\u003e\n\u003cul\u003e\n  \u003cli\u003eHost trên GitHub với README rõ ràng (README dành cho con người, không nằm trong thư mục Skill)\u003c\/li\u003e\n  \u003cli\u003eTạo hướng dẫn cài đặt: tải về, zip, upload qua Settings \u0026gt; Capabilities \u0026gt; Skills\u003c\/li\u003e\n  \u003cli\u003eTheo dõi tín hiệu under-triggering và over-triggering để điều chỉnh description\u003c\/li\u003e\n  \u003cli\u003eThu thập phản hồi người dùng và cập nhật liên tục — Skills là tài liệu sống\u003c\/li\u003e\n\u003c\/ul\u003e\n\n\u003ch2\u003eCách viết description hiệu quả\u003c\/h2\u003e\n\n\u003cp\u003eTrường description trong YAML frontmatter là phần quan trọng nhất — nó quyết định Claude có tải Skill hay không. Cấu trúc: \u003cstrong\u003e[Skill làm gì] + [Khi nào sử dụng] + [Khả năng chính]\u003c\/strong\u003e.\u003c\/p\u003e\n\n\u003cp\u003e\u003cstrong\u003eDescription tốt:\u003c\/strong\u003e\u003c\/p\u003e\n\u003cpre\u003e\u003ccode\u003e# Cụ thể và có thể hành động\ndescription: Analyzes Figma design files and generates developer\n  handoff documentation. Use when user uploads .fig files, asks for\n  \"design specs\", \"component documentation\", or \"design-to-code handoff\".\n\n# Bao gồm trigger phrases\ndescription: Manages Linear project workflows including sprint planning,\n  task creation, and status tracking. Use when user mentions \"sprint\",\n  \"Linear tasks\", \"project planning\", or asks to \"create tickets\".\u003c\/code\u003e\u003c\/pre\u003e\n\n\u003cp\u003e\u003cstrong\u003eDescription xấu:\u003c\/strong\u003e\u003c\/p\u003e\n\u003cpre\u003e\u003ccode\u003e# Quá mơ hồ\ndescription: Helps with projects.\n\n# Thiếu trigger\ndescription: Creates sophisticated multi-page documentation systems.\n\n# Quá kỹ thuật, không có trigger\ndescription: Implements the Project entity model with hierarchical\n  relationships.\u003c\/code\u003e\u003c\/pre\u003e\n\n\u003ch2\u003eChecklist nhanh trước khi triển khai\u003c\/h2\u003e\n\n\u003ch3\u003eTrước khi bắt đầu\u003c\/h3\u003e\n\u003cul\u003e\n  \u003cli\u003eĐã xác định 2-3 use case cụ thể\u003c\/li\u003e\n  \u003cli\u003eĐã xác định công cụ cần thiết (built-in hoặc MCP)\u003c\/li\u003e\n  \u003cli\u003eĐã xem qua tài liệu hướng dẫn và ví dụ Skills\u003c\/li\u003e\n  \u003cli\u003eĐã lên kế hoạch cấu trúc thư mục\u003c\/li\u003e\n\u003c\/ul\u003e\n\n\u003ch3\u003eTrong quá trình phát triển\u003c\/h3\u003e\n\u003cul\u003e\n  \u003cli\u003eThư mục đặt tên kebab-case\u003c\/li\u003e\n  \u003cli\u003eFile SKILL.md tồn tại (đúng chính tả)\u003c\/li\u003e\n  \u003cli\u003eYAML frontmatter có dấu phân cách \u003ccode\u003e---\u003c\/code\u003e\n\u003c\/li\u003e\n  \u003cli\u003eTrường name: kebab-case, không dấu cách, không viết hoa\u003c\/li\u003e\n  \u003cli\u003eDescription bao gồm WHAT (làm gì) và WHEN (khi nào dùng)\u003c\/li\u003e\n  \u003cli\u003eKhông có XML tags (\u003ccode\u003e\u0026lt; \u0026gt;\u003c\/code\u003e) ở bất kỳ đâu\u003c\/li\u003e\n  \u003cli\u003eHướng dẫn rõ ràng, có thể hành động\u003c\/li\u003e\n  \u003cli\u003eXử lý lỗi được bao gồm\u003c\/li\u003e\n  \u003cli\u003eVí dụ được cung cấp\u003c\/li\u003e\n  \u003cli\u003eTài liệu tham chiếu được liên kết rõ ràng\u003c\/li\u003e\n\u003c\/ul\u003e\n\n\u003ch3\u003eTrước khi upload\u003c\/h3\u003e\n\u003cul\u003e\n  \u003cli\u003eĐã test triggering trên tác vụ rõ ràng\u003c\/li\u003e\n  \u003cli\u003eĐã test triggering trên yêu cầu diễn đạt khác\u003c\/li\u003e\n  \u003cli\u003eĐã xác nhận không trigger trên chủ đề không liên quan\u003c\/li\u003e\n  \u003cli\u003eFunctional tests đạt\u003c\/li\u003e\n  \u003cli\u003eTích hợp công cụ hoạt động (nếu có)\u003c\/li\u003e\n  \u003cli\u003eĐã nén thành file .zip\u003c\/li\u003e\n\u003c\/ul\u003e\n\n\u003ch3\u003eSau khi upload\u003c\/h3\u003e\n\u003cul\u003e\n  \u003cli\u003eTest trong cuộc hội thoại thực tế\u003c\/li\u003e\n  \u003cli\u003eTheo dõi tín hiệu under\/over-triggering\u003c\/li\u003e\n  \u003cli\u003eThu thập phản hồi người dùng\u003c\/li\u003e\n  \u003cli\u003eCập nhật description và hướng dẫn\u003c\/li\u003e\n  \u003cli\u003eCập nhật version trong metadata\u003c\/li\u003e\n\u003c\/ul\u003e\n\n\u003ch2\u003eHai hướng tiếp cận: Problem-first hay Tool-first?\u003c\/h2\u003e\n\n\u003cp\u003eAnthropic sử dụng phép ẩn dụ Home Depot: bạn có thể bước vào với một vấn đề (\"tôi cần sửa tủ bếp\") và nhân viên chỉ bạn đúng công cụ, hoặc bạn chọn một máy khoan mới và hỏi cách dùng cho công việc cụ thể.\u003c\/p\u003e\n\n\u003cp\u003e\u003cstrong\u003eProblem-first:\u003c\/strong\u003e \"Tôi cần thiết lập workspace dự án\" — Skill điều phối đúng MCP call theo đúng trình tự. Người dùng mô tả kết quả mong muốn; Skill xử lý phần công cụ.\u003c\/p\u003e\n\n\u003cp\u003e\u003cstrong\u003eTool-first:\u003c\/strong\u003e \"Tôi có Notion MCP kết nối rồi\" — Skill dạy Claude quy trình tối ưu và best practices. Người dùng có quyền truy cập; Skill cung cấp chuyên môn.\u003c\/p\u003e\n\n\u003cp\u003eHầu hết Skills nghiêng về một hướng. Biết được framing nào phù hợp giúp bạn chọn đúng pattern.\u003c\/p\u003e\n\n\u003ch2\u003eLời khuyên quan trọng từ Anthropic\u003c\/h2\u003e\n\n\u003cul\u003e\n  \u003cli\u003e\n\u003cstrong\u003eLặp lại trên một tác vụ duy nhất trước khi mở rộng:\u003c\/strong\u003e Tập trung vào một tác vụ khó cho đến khi Claude thành công, rồi rút ra cách tiếp cận hiệu quả thành Skill. Điều này tận dụng in-context learning và cho tín hiệu nhanh hơn kiểm thử rộng.\u003c\/li\u003e\n  \u003cli\u003e\n\u003cstrong\u003eGiữ SKILL.md dưới 5,000 từ:\u003c\/strong\u003e Di chuyển tài liệu chi tiết vào references\/. Liên kết thay vì nhúng inline.\u003c\/li\u003e\n  \u003cli\u003e\n\u003cstrong\u003eĐánh giá nếu bạn có hơn 20-50 Skills bật đồng thời:\u003c\/strong\u003e Quá nhiều Skills đồng thời gây chậm và giảm chất lượng phản hồi.\u003c\/li\u003e\n  \u003cli\u003e\n\u003cstrong\u003eDùng script cho validation quan trọng:\u003c\/strong\u003e Code là xác định; diễn giải ngôn ngữ thì không. Với các kiểm tra thiết yếu, đóng gói script thay vì dựa vào chỉ dẫn ngôn ngữ.\u003c\/li\u003e\n  \u003cli\u003e\n\u003cstrong\u003eSkills là tài liệu sống:\u003c\/strong\u003e Lên kế hoạch cải thiện dựa trên phản hồi thực tế — under-triggering, over-triggering, và kết quả không nhất quán đều là tín hiệu cần điều chỉnh.\u003c\/li\u003e\n\u003c\/ul\u003e\n\n\u003ch2\u003eKết luận: Bắt đầu từ đâu?\u003c\/h2\u003e\n\n\u003cp\u003eNếu bạn chưa từng xây dựng Skill, dự kiến khoảng 15-30 phút để xây dựng và kiểm thử Skill đầu tiên bằng skill-creator. Bắt đầu với một use case đơn giản thuộc loại Document Creation, nắm vững cấu trúc SKILL.md và cách viết description hiệu quả, rồi dần dần mở rộng sang Workflow Automation và MCP Enhancement.\u003c\/p\u003e\n\n\u003cp\u003eSerial 6 phần dưới đây đi sâu vào từng khía cạnh với ví dụ thực tế, mã mẫu, và hướng dẫn chi tiết. Đọc theo thứ tự nếu bạn mới bắt đầu, hoặc nhảy thẳng vào phần bạn cần nếu đã có kinh nghiệm.\u003c\/p\u003e\n\n\u003cdiv class=\"serial-index\" style=\"background: #f9f7f4; padding: 2rem; border-radius: 8px; margin-top: 2rem;\"\u003e\n  \u003ch3\u003eĐọc chi tiết từng phần\u003c\/h3\u003e\n  \u003col\u003e\n    \u003cli\u003e\n\u003ca href=\"\/en\/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\"\u003ePhần 1: Giới thiệu và Kiến trúc cơ bản\u003c\/a\u003e — Skill là gì, SKILL.md, Progressive Disclosure, MCP kitchen analogy\u003c\/li\u003e\n    \u003cli\u003e\n\u003ca href=\"\/en\/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 — Use cases, 3 loại Skills, tiêu chí thành công, yêu cầu kỹ thuật\u003c\/li\u003e\n    \u003cli\u003e\n\u003ca href=\"\/en\/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 hiệu suất\u003c\/a\u003e — Triggering tests, functional tests, performance comparison, skill-creator\u003c\/li\u003e\n    \u003cli\u003e\n\u003ca href=\"\/en\/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 — Mô hình phân phối, Skills qua API, tiêu chuẩn mở, định vị sản phẩm\u003c\/li\u003e\n    \u003cli\u003e\n\u003ca href=\"\/en\/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 thực chiến và Xử lý lỗi\u003c\/a\u003e — 5 patterns, troubleshooting upload, triggering, MCP issues\u003c\/li\u003e\n    \u003cli\u003e\n\u003ca href=\"\/en\/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 hoàn chỉnh\u003c\/a\u003e — Official docs, skill-creator, YAML reference, ví dụ hoàn chỉnh\u003c\/li\u003e\n  \u003c\/ol\u003e\n  \u003cp\u003e\u003ca href=\"https:\/\/resources.anthropic.com\/hubfs\/The-Complete-Guide-to-Building-Skill-for-Claude.pdf?hsLang=en\" target=\"_blank\" rel=\"noopener\"\u003eTải tài liệu gốc PDF (tiếng Anh)\u003c\/a\u003e\u003c\/p\u003e\n\u003c\/div\u003e\n","brand":"Minh Tuấn","offers":[{"title":"Default Title","offer_id":47731146916052,"sku":null,"price":0.0,"currency_code":"VND","in_stock":true}],"thumbnail_url":"\/\/cdn.shopify.com\/s\/files\/1\/0821\/0264\/9044\/files\/h_ng-d_n-toan-di_n-xay-d_ng-skills-cho-claude-t_ng-h_p-t_-tai-li_u-chinh-th_c-anthropic.jpg?v=1774756467","url":"https:\/\/claude.vn\/en\/products\/h%c6%b0%e1%bb%9bng-d%e1%ba%abn-toan-di%e1%bb%87n-xay-d%e1%bb%b1ng-skills-cho-claude-t%e1%bb%95ng-h%e1%bb%a3p-t%e1%bb%ab-tai-li%e1%bb%87u-chinh-th%e1%bb%a9c-anthropic","provider":"CLAUDE.VN","version":"1.0","type":"link"}