Xây dựng OpenClaw skill tùy chỉnh

Sử dụng các AI skill rất hữu ích. Tự xây dựng skill của riêng mình là một siêu năng lực. Khi tạo ra một skill tùy chỉnh, bạn đang biến chuyên môn của mình thành thứ mà bất kỳ AI agent nào cũng có thể chạy – lặp đi lặp lại, đáng tin cậy và có thể chia sẻ với toàn thế giới.

Thông số kỹ thuật AgentSkills hoạt động trên Claude Code, VS Code Copilot, Codex CLI, Cursor, v.v... Các skill bạn xây dựng không bị khóa vào một nền tảng nào. Và bạn không cần phải là lập trình viên để tạo ra một skill – các file SKILL.md chỉ là Markdown được cấu trúc.

Khóa học này sẽ đưa bạn từ “chưa từng xây dựng skill nào” đến “đã xuất bản trên ClawHub” trong tám bài học.

Bạn sẽ xây dựng skill hoạt động đầu tiên của mình trong bài học 2, sau đó dần dần bổ sung thêm sức mạnh: tham số và biến cho đầu vào linh hoạt, tích hợp API để kết nối với các dịch vụ bên ngoài, framework kiểm thử để đảm bảo skill của bạn thực sự hoạt động và quy trình làm việc nhiều bước cho các tác vụ phức tạp.

Bảo mật được dành riêng một bài học vì các skill công khai cần phải an toàn. Bạn sẽ tìm hiểu 7 vector tấn công phổ biến nhất và cách phòng chống từng vector. Dự án cuối cùng sẽ hướng dẫn bạn toàn bộ quy trình xuất bản.

Những gì bạn sẽ học được

  • Giải thích cấu trúc thông số kỹ thuật AgentSkills và mô hình tiết lộ dần dần
  • Tạo một SKILL.md hoạt động với frontmatter YAML và các khối hướng dẫn phù hợp
  • Triển khai các skill tham số hóa bằng cách sử dụng $ARGUMENTS và cú pháp mở rộng shell
  • Thiết kế các tích hợp API an toàn với cách ly thông tin xác thực và xử lý lỗi
  • Sử dụng Promptfoo và Cisco Skill Scanner để kiểm tra và xác thực các skill
  • Xây dựng quy trình làm việc nhiều bước bằng cách sử dụng các subagent và điều phối tác vụ
  • Áp dụng danh sách kiểm tra bảo mật để ngăn chặn 7 vector tấn công skill phổ biến
  • Thực hiện quy trình xuất bản cho ClawHub và GitHub theo các tiêu chuẩn chất lượng và an toàn

Sau khóa học này, bạn có thể

  • Biến chuyên môn của bạn thành các AI skill có thể tái sử dụng, chia sẻ được, hoạt động trên Claude Code, Copilot, Cursor, v.v...
  • Xây dựng các skill tham số hóa với những biến, tích hợp API và quy trình làm việc nhiều bước để giải quyết các vấn đề thực tế
  • Bảo vệ các skill của bạn khỏi 7 vector tấn công phổ biến nhất bằng cách sử dụng danh sách kiểm tra bảo mật có cấu trúc
  • Xuất bản các skill lên ClawHub và GitHub, thiết lập danh tiếng của bạn trong lĩnh vực AI skill đang phát triển hệ sinh thái
  • Thêm kỹ năng 'Nhà phát triển AI skill' vào hồ sơ chuyên nghiệp của bạn - một yếu tố khác biệt khi hệ sinh thái AgentSkills mở rộng

Những gì bạn sẽ xây dựng

OpenClaw skill đã xuất bản

Một skill tùy chỉnh đầy đủ chức năng, được kiểm tra bảo mật và xuất bản lên ClawHub - với phần đầu YAML, đầu vào tham số hóa, xử lý lỗi và tài liệu.

Skill quy trình làm việc nhiều bước

Một skill nâng cao kết hợp nhiều thao tác với điều phối subagent, tích hợp API và logic điều kiện - thể hiện khả năng xây dựng công cụ AI cấp độ sản xuất của bạn.

Khả năng xây dựng OpenClaw skill

Chứng minh bạn có thể tạo, kiểm thử, bảo mật và xuất bản các skill AI agent tùy chỉnh bằng cách sử dụng thông số kỹ thuật AgentSkills.

Điều kiện tiên quyết

  • Đã hoàn thành khóa học OpenClaw cơ bản (hoặc có kiến ​​thức tương đương về OpenClaw)
  • Thành thạo cơ bản với trình soạn thảo văn bản và quản lý file
  • Hiểu biết về các khái niệm API (hữu ích nhưng không bắt buộc)

Đối tượng tham gia

  • Người dùng OpenClaw đã sử dụng các skill cộng đồng và muốn xây dựng skill của riêng mình
  • Các nhà phát triển muốn biến quy trình làm việc của họ thành những công cụ AI có thể tái sử dụng và chia sẻ
  • Những người tạo prompt chuyên nghiệp sẵn sàng vượt ra ngoài các prompt sử dụng một lần và tạo ra những gói skill có tham số và có thể kiểm thử
  • Bất kỳ ai đã xây dựng GPT tùy chỉnh và muốn có ý tưởng tương tự nhưng có thể di động trên mọi AI agent chính

Cấu trúc của một AgentSkill

Hiểu rõ thông số kỹ thuật AgentSkills - file SKILL.md là gì, cách thức tiết lộ dần dần hoạt động như thế nào và tại sao tiêu chuẩn mở này lại quan trọng ngoài OpenClaw.

File dạy cho AI agent những thủ thuật mới

Điều gì sẽ xảy ra nếu bạn có thể dạy cho AI agent của mình một skill mới giống như cách bạn viết một bản ghi nhớ?

Đó chính xác là những gì một file SKILL.md là - một tài liệu Markdown hướng dẫn AI agent cách thực hiện một việc mà nó chưa biết. Không cần lập trình. Không cần biên dịch. Không cần công cụ đặc biệt. Chỉ là một file văn bản có cấu trúc.

Simon Willison, nhà nghiên cứu bảo mật đã theo dõi sự phát triển của AI agent, gọi thông số kỹ thuật AgentSkills là "nhỏ gọn một cách đáng kinh ngạc". Và ông ấy đúng - toàn bộ thông số kỹ thuật nằm gọn trên một trang duy nhất. Hai trường bắt buộc. Chỉ vậy thôi.

Nhưng sự đơn giản đó lại đánh lừa. Đằng sau hai trường đó là một hệ thống đủ mạnh để tạo ra mọi thứ, từ một trình định dạng email đơn giản đến một trợ lý nghiên cứu nhiều bước.

Những điều cần biết

Đây là khóa học trung cấp. Bạn nên nắm vững các kiến ​​thức cơ bản về OpenClaw. Bạn không cần phải biết lập trình, nhưng việc quen thuộc với trình soạn thảo văn bản và cấu trúc file sẽ hữu ích.

Mỗi bài học đều dựa trên bài học trước đó. Các skill bạn tạo ra trong các bài học đầu tiên sẽ trở thành nền tảng cho các kỹ thuật nâng cao sau này.

Tiêu chuẩn AgentSkills

Trước khi xem xét định dạng, hãy cùng hiểu vấn đề mà nó giải quyết.

Mỗi nền tảng AI agent đều có cách mở rộng khả năng riêng. Claude Code có định dạng riêng. VS Code Copilot có một định dạng khác. OpenClaw lại có một định dạng khác nữa. Nếu bạn xây dựng skill cho một nền tảng, nó sẽ vô dụng trên các nền tảng khác.

Vào cuối năm 2025, Anthropic đã đề xuất một tiêu chuẩn phổ quát: AgentSkills. Một định dạng SKILL.md duy nhất mà bất kỳ agent tuân thủ nào cũng có thể đọc được. Xây dựng một lần, sử dụng ở mọi nơi - trong Claude Code, VS Code Copilot, Codex CLI, Cursor, OpenClaw, v.v...

Triết lý thiết kế là sự đơn giản triệt để. Barry Zhang và nhóm kỹ thuật của Anthropic đã viết: thông số kỹ thuật sử dụng phương pháp tiết lộ từng bước - bắt đầu đơn giản, chỉ thêm độ phức tạp khi cần thiết.

Kiểm tra nhanh: Tại sao ngành công nghiệp cần một định dạng skill tiêu chuẩn?

Câu trả lời: Mỗi nền tảng đều có định dạng độc quyền riêng. Một tiêu chuẩn phổ quát có nghĩa là xây dựng một lần và sử dụng skill đó trên Claude Code, VS Code, OpenClaw, Codex, v.v...

3 lớp của một skill

Đây là mô hình tiết lộ từng bước giúp toàn bộ hệ thống hoạt động:

Lớp 1: Siêu dữ liệu (luôn được load)

Khi một agent khởi động, nó chỉ đọc tên và mô tả của mọi skill có sẵn. Điều này rất nhẹ - có thể chỉ 100 ký tự mỗi skill - vì vậy việc load hàng trăm skill không làm chậm bất cứ thứ gì.

--- 
name: daily-standup-formatter
description: >
   Định dạng ghi chú họp giao ban hàng ngày thành một mẫu nhất quán.
   Sử dụng khi người dùng yêu cầu định dạng ghi chú họp giao ban hoặc chuẩn bị
   cho cuộc họp nhóm hàng ngày.
---

Đó là một skill hoàn chỉnh, hợp lệ, gồm 2 trường, hoạt động tốt.

Lớp 2: Hướng dẫn đầy đủ (được load theo yêu cầu)

Khi hệ thống quyết định một skill phù hợp với yêu cầu của bạn, nó sẽ đọc toàn bộ nội dung SKILL.md - nội dung Markdown bên dưới phần mở đầu. Đây là nơi bạn đặt hướng dẫn chi tiết:

--- 
name: daily-standup-formatter
description: >
Định dạng ghi chú họp giao ban hàng ngày thành một mẫu nhất quán.
---

# Công cụ định dạng họp giao ban hàng ngày

Định dạng ghi chú họp giao ban của người dùng bằng cấu trúc này:

## Hôm qua
- Những việc đã hoàn thành

## Hôm nay
- Những việc dự kiến

## Vấn đề cản trở
- Bất kỳ trở ngại nào (hoặc "None" nếu rõ ràng)

Giữ cho các gạch đầu dòng ngắn gọn (mỗi dòng một mục).
Luôn hỏi về các phần còn thiếu.

Lớp 3: Các file được liên kết (được load khi cần)

Đối với các skill phức tạp, bạn có thể bao gồm các file hỗ trợ trong thư mục skill:

daily-standup-formatter/
├── SKILL.md   # Hướng dẫn chính
├── scripts/
│ └── parse-jira.py   # Script để lấy Jira ticket
├── references/
│ └── team-style-guide.md    # Cách nhóm định dạng cuộc họp đứng
└── assets/

└── template.md       # Mẫu đầu ra

Agent chỉ đọc các file này khi cần - không phải khi khởi động, không phải khi skill được gọi lần đầu tiên, mà khi các hướng dẫn tham chiếu đến chúng.

Kiểm tra nhanh: Agent của bạn có 200 skill được cài đặt. Có bao nhiêu skill được load đầy đủ vào bộ nhớ khi khởi động?

Đáp án: Không có gì được load đầy đủ. Trình biên dịch chỉ load Lớp 1 - tên và mô tả - cho tất cả 200 skill. Hướng dẫn đầy đủ chỉ được load cho skill đang được sử dụng.

Các trường bắt buộc (và chức năng của chúng)

Chỉ có hai trường quan trọng trong phần đầu YAML:

name (bắt buộc, tối đa 64 ký tự)

  • Chỉ chữ cái viết thường, số và dấu gạch ngang
  • Đây là cách agent nhận dạng skill: daily-standup-formatter
  • Nếu skill có thể được người dùng gọi, đây sẽ trở thành lệnh gạch chéo: /daily-standup-formatter

description (bắt buộc, tối đa 1024 ký tự) :

  • Phần văn bản quan trọng nhất trong skill của bạn
  • Đây là phần mà agent đọc để quyết định xem skill của bạn có phù hợp hay không
  • Hãy viết cho AI, không phải cho con người - hãy nêu rõ khi nào nên sử dụng skill

Mô tả là lời giới thiệu ngắn gọn về skill của bạn cho AI. Một mô tả mơ hồ có nghĩa là agent sẽ không biết khi nào nên sử dụng skill của bạn. Một mô tả chính xác có nghĩa là nó sẽ được kích hoạt chính xác khi cần thiết.

Mô tả không tốt: "Một công cụ hữu ích để định dạng mọi thứ"

Mô tả tốt: "Định dạng ghi chú họp giao ban hàng ngày theo template Yesterday/Today/Blockers. Sử dụng khi người dùng yêu cầu định dạng ghi chú họp giao ban, chuẩn bị báo cáo cuộc họp hàng ngày hoặc sắp xếp những việc họ đã làm".

Các trường tùy chọn cần biết

TrườngMục đíchSử dụng khi nào
licenseKhai báo giấy phép skillKhi công bố công khai
compatibilityGhi chú về yêu cầu nền tảng (tối đa 500 ký tự)Khi skill cần những tính năng cụ thể
metadataCặp key-value cho dữ liệu tùy chỉnhDùng để theo dõi phiên bản, thông tin tác giả, v.v.
allowed-toolsGiới hạn các công cụ mà skill này có thể sử dụng (thử nghiệm)Skill nhạy cảm về an ninh
disable-model-invocationChỉ người dùng mới có thể kích hoạt skill nàyCác skill tác dụng phụ như /deploy
user-invocableThiết lập false về skill kiến ​​thức nền tảngCác skill mà agent sử dụng một cách thầm lặng

MCP so với skill: Sự khác biệt là gì?

Có thể bạn đã nghe nói về MCP (Model Context Protocol). Vậy chúng có liên quan như thế nào?

MCP giống như hệ thống đường ống. Nó định nghĩa những công cụ nào tồn tại - "có công cụ lịch, công cụ email, công cụ GitHub." Nó xử lý lớp kết nối.

Skill giống như bộ não. Chúng định nghĩa cách sử dụng các công cụ đó một cách hiệu quả — "khi người dùng yêu cầu tóm tắt cuộc họp giao ban, hãy đọc các Jira ticket của họ thông qua công cụ Jira MCP, định dạng chúng vào mẫu và hỏi về các vấn đề cản trở."

Bạn có thể xây dựng skill mà không cần MCP, và MCP cũng hoạt động mà không cần skill. Nhưng khi kết hợp với nhau, chúng rất mạnh mẽ: MCP cung cấp cho người dùng khả năng thao tác, còn skill cung cấp cho họ kiến ​​thức về thời điểm và cách sử dụng chúng.

Những điểm chính cần ghi nhớ

  • AgentSkills là một tiêu chuẩn đa nền tảng — xây dựng một lần, sử dụng trong Claude Code, VS Code, Codex CLI, OpenClaw, và nhiều nền tảng khác
  • Chỉ có tên và mô tả là bắt buộc — mọi thứ khác đều là tùy chọn
  • Quá trình tiết lộ dần dần load nội dung skill theo ba lớp: siêu dữ liệu → hướng dẫn → file được liên kết
  • description là trường quan trọng nhất — nó cho AI biết khi nào nên sử dụng skill của bạn
  • Skill là bộ não; MCP là hệ thống đường ống — skill xác định cách sử dụng các công cụ một cách hiệu quả
  • Câu 1:

    Những nền tảng nào trong số này hỗ trợ tiêu chuẩn AgentSkills?

    GIẢI THÍCH:

    Tiêu chuẩn AgentSkills thực sự là đa nền tảng. Các skill bạn xây dựng hoạt động trên Claude Code, VS Code Copilot (GitHub Copilot), OpenAI Codex CLI, Cursor, Goose, Amp, OpenCode và OpenClaw. Xây dựng một lần, sử dụng ở mọi nơi.

  • Câu 2:

    'Tiết lộ dần dần' trong ngữ cảnh của Agent Skills là gì?

    GIẢI THÍCH:

    Tiết lộ dần dần có nghĩa là agent trước tiên chỉ thấy tên và mô tả (được load khi khởi động). Khi skill có vẻ phù hợp, nó sẽ đọc toàn bộ SKILL.md. Khi cần các script hoặc tài liệu tham khảo, nó sẽ load chúng theo yêu cầu. Điều này giúp cửa sổ ngữ cảnh hoạt động hiệu quả.

  • Câu 3:

    Hai trường BẮT BUỘC duy nhất trong phần mở đầu của SKILL.md là gì?

    GIẢI THÍCH:

    Thông số kỹ thuật của AgentSkills chỉ yêu cầu 'tên' (tối đa 64 ký tự) và 'mô tả' (tối đa 1024 ký tự). Mọi trường khác đều là tùy chọn. Sự tối giản có chủ đích này giúp giảm bớt rào cản khi tạo ra skill, trong khi thông số kỹ thuật xử lý sự phức tạp thông qua việc tiết lộ dần dần.

Thứ Bảy, 18/04/2026 11:26
51 👨 36
Xác thực tài khoản!

Theo Nghị định 147/2024/ND-CP, bạn cần xác thực tài khoản trước khi sử dụng tính năng này. Chúng tôi sẽ gửi mã xác thực qua SMS hoặc Zalo tới số điện thoại mà bạn nhập dưới đây:

Số điện thoại chưa đúng định dạng!
Số điện thoại này đã được xác thực!
Bạn có thể dùng Sđt này đăng nhập tại đây!
Lỗi gửi SMS, liên hệ Admin
0 Bình luận
Sắp xếp theo
    ❖ Học OpenClaw