Chia sẻ skill

Skill trở nên giá trị hơn nhiều khi được chia sẻ trong cả team hay tổ chức. Một skill review PR chỉ mình bạn dùng đã hữu ích, nhưng chính skill đó khi chia sẻ cho cả team sẽ chuẩn hoá việc review code và tạo ra trải nghiệm nhất quán trong tổ chức. Hãy xem các cách khác nhau để phân phối skill.

Commit skill vào repository

Cách chia sẻ đơn giản nhất là commit skill trực tiếp vào repository. Đặt chúng trong .claude/skills, và bất kỳ ai clone repo cũng tự động nhận được các skill đó - không cần cài đặt gì thêm.

Khi bạn push cập nhật, mọi người nhận được chúng ở lần pull tiếp theo. Cách này phù hợp với:

• Quy chuẩn code của team.
• Quy trình đặc thù của project.
• Các skill tham chiếu tới cấu trúc codebase của bạn.

Thư mục .claude chứa agent, hook, skill, và cấu hình của bạn - tất cả đều được quản lý bằng version control và chia sẻ với team qua quy trình Git thông thường.

Phân phối skill qua plugin

Plugin là cách mở rộng Claude Code với chức năng tuỳ chỉnh, được thiết kế để chia sẻ giữa các team và project. Trong project plugin của bạn, tạo một thư mục skills theo cấu trúc tương tự thư mục .claude - mỗi skill có thư mục riêng, chứa một file SKILL.md bên trong.

Sau khi bạn phân phối plugin lên một marketplace, người dùng khác có thể khám phá và tự cài nó vào Claude Code của họ.

Cách này phù hợp nhất khi skill của bạn không quá đặc thù cho một project cụ thể, và có thể hữu ích cho cộng đồng rộng hơn team của bạn.

Thư mục skills bên trong một plugin, theo cùng cấu trúc như .claude/skills.

Triển khai cấp enterprise qua managed settings

Admin có thể triển khai skill cho toàn tổ chức thông qua managed settings. Skill enterprise có ưu tiên cao nhất - chúng ghi đè skill cá nhân, project, và plugin trùng tên.

File managed settings hỗ trợ các tính năng như strictKnownMarketplaces để kiểm soát nơi plugin được phép cài từ đó:

"strictKnownMarketplaces": [
  {
    "source": "github",
    "repo": "acme-corp/approved-plugins"
  },
  {
    "source": "npm",
    "package": "@acme-corp/compliance-plugins"
  }
]

Đây là lựa chọn đúng cho các quy chuẩn bắt buộc, yêu cầu bảo mật, quy trình tuân thủ (compliance), và thực hành code phải nhất quán trong toàn tổ chức. Từ khoá ở đây là “phải”.

Skill enterprise, triển khai qua managed settings, có ưu tiên cao nhất.

Skill và Subagent

Đây là điều khiến nhiều người bất ngờ: subagent không tự động thấy skill của bạn. Khi bạn giao một tác vụ cho subagent, nó bắt đầu với một ngữ cảnh hoàn toàn mới, sạch sẽ.

Có vài điểm khác biệt quan trọng cần hiểu:

• Agent có sẵn (như Explorer, Plan, và Verify) hoàn toàn không thể truy cập skill.
• Subagent tuỳ chỉnh bạn tự định nghĩa có thể dùng skill, nhưng chỉ khi bạn liệt kê chúng tường minh.
• Skill được nạp khi subagent khởi động, chứ không phải theo yêu cầu như trong hội thoại chính.

Để tạo một subagent tuỳ chỉnh có skill, thêm một file markdown agent trong .claude/agents. Bạn có thể dùng lệnh /agents trong Claude Code để tạo nó theo kiểu tương tác.

Tạo một subagent tuỳ chỉnh bằng lệnh /agents.

File agent được sinh ra có một field skills liệt kê những skill nào sẽ được nạp. Frontmatter trông như sau:

---
name: frontend-security-accessibility-reviewer
description: "Use this agent when you need to review frontend code for accessibility..."
tools: Bash, Glob, Grep, Read, WebFetch, WebSearch, Skill...
model: sonnet
color: blue
skills: accessibility-audit, performance-check
---

Khi bạn giao việc cho subagent này, nó đã có sẵn cả hai skill được nạp và áp dụng chúng vào mọi lượt review. Trước tiên hãy đảm bảo các skill đó tồn tại trong thư mục .claude/skills của bạn, sau đó hoặc tạo một subagent mới, hoặc thêm field skills vào file markdown của một agent đã có.

Pattern này hoạt động rất tốt khi:

• Bạn muốn giao việc cô lập với chuyên môn cụ thể.
• Các subagent khác nhau cần các skill khác nhau (reviewer frontend so với backend).
• Bạn muốn thực thi quy chuẩn trong công việc được giao mà không phụ thuộc vào prompt.

Nguồn

Dịch từ bài giảng “Sharing skills”, khóa Introduction to agent skills trên Claude Academy.