Xây dựng skill tùy chỉnh đầu tiên trong Claude Cowork

Đã đến lúc xây dựng một thứ gì đó. Đến cuối bài học này, bạn sẽ có một skill tùy chỉnh hoạt động được - và bạn sẽ hiểu định dạng đủ tốt để tạo thêm nhiều skill khác trong vài phút.

🔄 Tóm tắt nhanh: Trong bài học trước, bạn đã thấy cách các plugin đã cài đặt tự động áp dụng skill khi Claude phát hiện ra một nhiệm vụ liên quan. Bây giờ bạn sẽ xây dựng loại skill hỗ trợ các plugin đó.

Định dạng SKILL.md

Skill là một file markdown duy nhất gồm hai phần:

--- 
name: weekly-report-writer
description: "Tạo báo cáo trạng thái hàng tuần từ các bản cập nhật nhóm và ghi chú cuộc họp giao ban. Sử dụng khi người dùng yêu cầu báo cáo trạng thái, cập nhật hàng tuần hoặc tóm tắt tiến độ".
---

# Người viết báo cáo hàng tuần

Bạn là một người quản lý dự án giỏi, người tạo ra các báo cáo hàng tuần ngắn gọn, dễ đọc.

## Khi nào nên sử dụng skill này
- Người dùng yêu cầu báo cáo hoặc cập nhật trạng thái hàng tuần
- Người dùng có ghi chú cuộc họp hoặc dữ liệu họp giao ban cần tóm tắt

## Hướng dẫn
1. Đọc tất cả các file nguồn được cung cấp (ghi chú họp giao ban, ghi chú cuộc họp, dữ liệu)
2. Trích xuất: thành tựu, trở ngại, số liệu và các bước tiếp theo
3. Xuất ra theo định dạng này:

### Trạng thái hàng tuần — [Khoảng thời gian]
**Nhóm:** [tên nhóm]

#### Điểm nổi bật
- [3 thành tựu hàng đầu, mỗi thành tựu một câu]

#### Số liệu
| Số liệu | Tuần này | Xu hướng |
|--------|-----------|-------|
| [số liệu] | [giá trị] | [tăng/giảm/ổn định] |

#### Các vấn đề cản trở
- [Vấn đề cản trở] → [Giải pháp đề xuất]

#### Tuần tới
- [Ưu tiên hàng đầu]

## Quy tắc
- Giữ toàn bộ báo cáo dưới 500 từ
- Sử dụng gạch đầu dòng, không phải đoạn văn
- Làm nổi bật các vấn đề cản trở - những vấn đề này cần được chú ý
- Nếu thiếu dữ liệu, hãy ghi chú lại thay vì đoán mò

Vậy là xong. Phần frontmatter cho Claude biết khi nào nên sử dụng skill này. Phần body cho Claude biết cách sử dụng.

Phân tích frontmatter

--- 
name: weekly-report-writer
description: "Tạo báo cáo trạng thái hàng tuần từ các bản cập nhật nhóm và ghi chú cuộc họp giao ban. Sử dụng khi người dùng yêu cầu báo cáo trạng thái, cập nhật hàng tuần hoặc tóm tắt tiến độ".
---

name - Mã định danh của skill. Cũng trở thành lệnh slash (/weekly-report-writer). Sử dụng kiểu viết hoa chữ cái đầu mỗi từ (kebab-case), giữ cho nó mô tả rõ ràng.

description - Đây là trường quan trọng nhất. Claude đọc trường này để quyết định xem có tự động áp dụng skill hay không. Hãy viết như thể bạn đang giải thích cho một đồng nghiệp: "skill này làm được X. Hãy sử dụng nó khi Y."

Mô tả tệ: "Skill viết báo cáo"

Mô tả tốt: "Tạo báo cáo trạng thái hàng tuần từ các cập nhật của nhóm và ghi chú cuộc họp giao ban. Sử dụng khi người dùng yêu cầu báo cáo trạng thái, cập nhật hàng tuần hoặc tóm tắt tiến độ".

Mô tả tốt cung cấp cho Claude các điều kiện kích hoạt rõ ràng. Mô tả tệ quá mơ hồ - Claude sẽ không biết khi nào cần áp dụng nó.

✅ Kiểm tra nhanh: Tại sao trường mô tả là phần quan trọng nhất của frontmatter?

Viết nội dung skill

Phần nội dung markdown là hướng dẫn sử dụng của Claude. Hãy viết như thể bạn đang hướng dẫn một thành viên mới trong nhóm:

1. Định nghĩa vai trò - Claude là ai trong ngữ cảnh này? "Bạn là một người quản lý dự án lành nghề..." xác định trình độ chuyên môn và quan điểm.
2. Điều kiện kích hoạt - Khi nào skill này nên được kích hoạt? Hãy cụ thể về các tình huống.
3. Hướng dẫn từng bước - Claude nên làm gì? Đánh số các bước. Hãy cụ thể.
4. Định dạng đầu ra - Hiển thị template chính xác. Claude tuân thủ chính xác các template.
5. Quy tắc và ràng buộc - Claude nên tránh điều gì? Giới hạn từ ngữ? Giọng văn? Những điều không bao giờ được làm?

Mẹo hay: Bao gồm một ví dụ về kết quả đầu ra trong phần mô tả skill. Claude điều chỉnh kết quả đầu ra tốt hơn nhiều khi nó có thể thấy một ví dụ.

Đặt skill ở đâu?

Tạo cấu trúc thư mục này trong thư mục làm việc của bạn:

your-project/
└── .claude/
    └── skills/
        └── weekly-report-writer/
            └── SKILL.md

Cowork tự động phát hiện các skill trong thư mục .claude/skills/. Mỗi skill sẽ có một thư mục con riêng được đặt tên theo skill đó. File phải được đặt tên là SKILL.md (chính xác - chữ hoa rất quan trọng).

Kiểm tra skill của bạn

Sau khi tạo file, hãy kiểm tra nó trong Cowork:

Kiểm tra 1: Tự động phát hiện - Giao cho Cowork một nhiệm vụ phù hợp với mô tả. "Tạo báo cáo tình trạng hàng tuần từ ghi chú cuộc họp giao ban của tôi". Nếu skill được tự động áp dụng, bạn sẽ thấy Claude tuân theo template và quy tắc của bạn.

Kiểm tra 2: Lệnh slash - Gõ trực tiếp /weekly-report-writer. Điều này buộc skill được kích hoạt bất kể ngữ cảnh.

Kiểm tra 3: Trường hợp ngoại lệ - Thử một tác vụ gần giống nhưng không hoàn toàn trùng khớp. "Tóm tắt ghi chú cuộc họp của tôi". Skill có được kích hoạt không? Có nên kích hoạt không? Điều chỉnh mô tả nếu tính năng tự động phát hiện quá mạnh hoặc quá thận trọng.

Xây dựng skill đầu tiên của bạn ngay bây giờ

Chọn một trong những ví dụ này - hoặc tự nghĩ ra ví dụ của riêng bạn:

Soạn thảo email:

name: email-drafter
description: "Soạn thảo email chuyên nghiệp. Sử dụng khi người dùng yêu cầu viết, soạn thảo hoặc gửi email hoặc tin nhắn cho đồng nghiệp, khách hàng hoặc nhà cung cấp".

Công cụ làm sạch dữ liệu:

name: data-cleaner
description: "Làm sạch dữ liệu CSV và bảng tính. Sử dụng khi người dùng yêu cầu làm sạch, xác thực, loại bỏ dữ liệu trùng lặp hoặc chuẩn hóa dữ liệu trong file CSV hoặc Excel".

Ghi chú cuộc họp:

name: meeting-notes
description: "Tạo ghi chú cuộc họp có cấu trúc từ ghi chú thô hoặc bản ghi. Sử dụng khi người dùng cung cấp nội dung cuộc họp và muốn có ghi chú được sắp xếp với các mục hành động".

Chọn một skill. Viết toàn bộ nội dung SKILL.md (frontmatter + nội dung chính). Đặt nó vào thư mục .claude/skills/your-skill-name/SKILL.md. Kiểm tra nó.

Toàn bộ quá trình sẽ mất khoảng 10-15 phút. Và một khi nó hoạt động, bạn sẽ có một skill để sử dụng hàng tuần.

Shortcut Plugin Create

Không muốn tự viết code markdown? Cowork có một công cụ tích hợp sẵn: Plugin Create. Đó là một meta-plugin xây dựng các plugin.

Trong Cowork, chỉ cần mô tả những gì bạn muốn:

Tôi cần một skill định dạng ghi chú cuộc gọi bán hàng của tôi thành một mẫu chuẩn
với: tên công ty, người tham dự, nhu cầu chính, các phản đối được nêu ra, những bước tiếp theo,
và ngày theo dõi. Xuất ra dưới dạng markdown.

Claude sẽ tạo SKILL.md cho bạn. Xem lại, chỉnh sửa nếu cần và lưu nó vào .claude/skills/. Nhanh hơn so với việc viết từ đầu, mặc dù việc hiểu định dạng sẽ giúp bạn tùy chỉnh kết quả.

✅ Kiểm tra nhanh: Có hai cách nào để tạo skill tùy chỉnh?

Câu trả lời: Viết SKILL.md thủ công hoặc sử dụng công cụ Plugin Create trong Cowork.

Những lỗi thường gặp khi tạo skill đầu tiên

Quá rộng: Một skill cố gắng xử lý "tất cả các loại nhu cầu viết" là quá mơ hồ. Claude sẽ không biết khi nào nên áp dụng nó so với khả năng viết chung của nó. Hãy thu hẹp lại: "Viết đề xuất bán hàng cho phần mềm SaaS doanh nghiệp".

Không có template đầu ra: Nếu không có template, Claude sẽ tự tạo định dạng riêng mỗi lần. Hãy bao gồm cấu trúc chính xác mà bạn muốn.

Mô tả yếu: "Hỗ trợ lập báo cáo" → Claude không thể phân biệt điều này với khả năng tích hợp sẵn của nó. "Tạo báo cáo hội đồng quản trị hàng quý với tóm tắt tài chính, điểm nổi bật chiến lược và đánh giá rủi ro từ dữ liệu xuất của CFO" → Claude biết chính xác khi nào nên áp dụng điều này.

Quá nhiều quy tắc: Bắt đầu với 3-5 quy tắc rõ ràng. Bạn luôn có thể thêm nhiều hơn sau khi thử nghiệm. Một skill với 50 quy tắc sẽ khó bảo trì và gỡ lỗi hơn.

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

• File SKILL.md có hai phần: YAML frontmatter (khi nào) và Markdown body (cách thức)
• Trường mô tả kiểm soát việc tự động tìm kiếm - hãy mô tả cụ thể
• Đặt các skill vào .claude/skills/{name}/SKILL.md để được tự động tìm kiếm
• Kiểm tra cả với tính năng tự động tìm kiếm và lệnh slash
• Plugin Create có thể tạo skill từ mô tả bằng ngôn ngữ tự nhiên
• Hãy bắt đầu với phạm vi hẹp - một skill tập trung sẽ hiệu quả hơn một skill quá rộng