claude-plugins-official: kho plugin chính thức cho Claude Code

claude-plugins-official là gì

Nếu bạn đang dùng Claude Code và muốn mở rộng khả năng của nó, anthropics/claude-plugins-official là kho lưu trữ đáng để ghé qua. Đây là thư mục plugin chính thức, được Anthropic quản lý, tập hợp các plugin chất lượng cao dành cho Claude Code.

Kho này phù hợp với hai nhóm người: những ai muốn tìm và cài plugin đáng tin cậy cho Claude Code, và những nhà phát triển muốn tạo plugin riêng theo một cấu trúc chuẩn. Dự án hiện có hơn 42.000 sao trên GitHub, cho thấy sự quan tâm rất lớn từ cộng đồng.

Cấu trúc của kho plugin

Kho được chia thành hai thư mục chính, giúp bạn dễ phân biệt nguồn gốc của từng plugin:

• /plugins: các plugin nội bộ do Anthropic phát triển và duy trì.
• /external_plugins: các plugin bên thứ ba đến từ đối tác và cộng đồng.

Các chủ đề gắn với dự án gồm claude-code, mcp và skills, phản ánh đúng những thành phần mà một plugin có thể chứa.

Một plugin gồm những gì

Mỗi plugin tuân theo một cấu trúc chuẩn. Theo README, cấu trúc đó trông như sau:

plugin-name/
├── .claude-plugin/
│   └── plugin.json      # Plugin metadata (required)
├── .mcp.json            # MCP server configuration (optional)
├── commands/            # Slash commands (optional)
├── agents/              # Agent definitions (optional)
├── skills/              # Skill definitions (optional)
└── README.md            # Documentation

Như vậy, chỉ có tệp plugin.json trong thư mục .claude-plugin là bắt buộc. Các phần còn lại là tùy chọn:

• Cấu hình máy chủ MCP qua tệp .mcp.json.
• Lệnh slash đặt trong thư mục commands/.
• Định nghĩa agent trong thư mục agents/.
• Định nghĩa skill trong thư mục skills/.

Plugin dạng gói skill

Một điểm thú vị là kho hỗ trợ các plugin dạng gói skill. Khi kho mã nguồn của một plugin chỉ chứa các tệp SKILL.md mà không có manifest .claude-plugin/plugin.json, mục khai báo trong marketplace có thể liệt kê trực tiếp các skill bằng cách đặt strict: false kèm một mảng skills rõ ràng.

Mỗi đường dẫn trong skills là tương đối so với source.path và trỏ tới một thư mục có chứa SKILL.md. Đường dẫn có thể đi sâu nhiều cấp, nhờ đó bạn có thể chọn ra một tập con skill từ nhiều thư mục thư viện khác nhau. Trong Claude Code, mỗi skill sẽ được đăng ký với tên dạng <plugin-name>:<skill-name>.

Tên plugin là bất biến

README nhấn mạnh một quy tắc quan trọng: trường name trong mục marketplace là một slug bất biến. Khi plugin đã được phát hành, tên này không nên thay đổi, vì người dùng đã cài plugin theo slug đó và việc đổi tên sẽ gây lỗi plugin-not-found.

• Nếu chỉ muốn đổi cách hiển thị trên giao diện, hãy dùng trường displayName.
• Nếu thật sự phải đổi tên, hãy thêm mục vào bản đồ renames ở cấp cao nhất của tệp .claude-plugin/marketplace.json để các bản cài đặt cũ tự động chuyển đổi.

"renames": {
  "old-name": "new-name"
}

Trình nạp plugin của Claude Code sẽ đọc bản đồ này và tự động đổi slug cũ sang slug mới ở lần đồng bộ tiếp theo của người dùng.

Trường hợp sử dụng thực tế

• Tìm plugin đáng tin cậy: thay vì tự tìm kiếm rải rác, bạn có một danh mục được tuyển chọn để duyệt và cài đặt.
• Học cách viết plugin: thư mục /plugins/example-plugin là bản triển khai mẫu để tham khảo.
• Phân phối plugin của bạn: đối tác bên thứ ba có thể gửi plugin để được đưa vào marketplace.
• Đóng gói skill có sẵn: tận dụng cơ chế gói skill để đưa các tệp SKILL.md vào Claude Code mà không cần viết manifest riêng.

Cách bắt đầu

Plugin có thể được cài trực tiếp từ marketplace này thông qua hệ thống plugin của Claude Code:

1. Mở Claude Code.
2. Chạy lệnh cài đặt, thay {plugin-name} bằng tên plugin bạn muốn:

   /plugin install {plugin-name}@claude-plugins-official

3. Hoặc vào /plugin > Discover để duyệt và chọn plugin.

Nếu muốn đóng góp plugin bên ngoài, bạn cần dùng biểu mẫu gửi plugin. Plugin bên ngoài phải đáp ứng các tiêu chuẩn về chất lượng và bảo mật để được duyệt.

Lưu ý quan trọng

Hãy chắc chắn rằng bạn tin tưởng một plugin trước khi cài đặt, cập nhật hoặc sử dụng nó. Theo README, Anthropic không kiểm soát các máy chủ MCP, tệp hay phần mềm khác được đưa vào plugin, và không thể xác minh rằng chúng sẽ hoạt động như mong đợi hay sẽ không thay đổi.

• Giấy phép: kho được gắn giấy phép Apache License 2.0, nhưng README khuyên bạn xem tệp LICENSE của từng plugin để biết giấy phép áp dụng cho plugin đó.
• Phát hành: dự án chưa có bản phát hành chính thức trên GitHub, nhưng vẫn được cập nhật thường xuyên.
• Tài liệu: hướng dẫn phát triển plugin chi tiết có tại tài liệu chính thức.

Kết luận

claude-plugins-official là điểm khởi đầu hợp lý cho bất kỳ ai muốn mở rộng Claude Code bằng plugin, dù bạn là người dùng tìm công cụ hay nhà phát triển muốn xây dựng và chia sẻ plugin. Hãy nhớ kiểm tra kỹ từng plugin trước khi cài. Bạn có thể xem kho tại github.com/anthropics/claude-plugins-official.