Skill và Plugin trong Claude Code khác nhau chỗ nào?
Skill là một thư mục có file SKILL.md dạy Claude một việc. Plugin là cái hộp đóng gói nhiều skill, agent, hook, MCP để cài bằng một lệnh. Khi nào dùng cái nào.
Hai từ này hay bị dùng lẫn, vì cả hai đều là cách dạy Claude Code làm việc theo ý bạn. Khác nhau ở chỗ: skill là một công thức, còn plugin là cái hộp để mang nhiều công thức đi chia cho người khác.
Skill: một thư mục có file SKILL.md
Một skill chỉ là một thư mục, bên trong có file SKILL.md. Đầu file ghi tên và mô tả, bên dưới là các bước bạn muốn Claude làm theo. Đây là skill viết caption mình dùng làm ví dụ:
---
name: viet-caption
description: Viết caption TikTok cho kênh Hiếu học code. Dùng khi cần caption cho một video.
---
# Các bước
1. Đọc kịch bản video
2. Dòng đầu là hook, tối đa 8 chữ
3. Cuối có 5 hashtag
Lưu file này ở ~/.claude/skills/viet-caption/SKILL.md là dùng được. Mỗi skill dạy Claude một việc cụ thể.
Claude đọc mô tả trước, cần mới mở các bước
Có chục skill cũng không nặng. Lúc bắt đầu phiên, Claude chỉ nạp phần tên và mô tả. Phần các bước chỉ được đọc khi việc bạn nhờ khớp với mô tả.
Bạn gọi skill theo hai cách: gõ thẳng /viet-caption, hoặc nói bình thường "viết caption cho video này" để Claude tự chọn.
Vì Claude chọn skill dựa vào mô tả, nên trong mô tả hãy ghi rõ khi nào dùng. Mô tả mơ hồ thì skill nằm đó mà không bao giờ được gọi.
Đặt ở đâu, dùng ở đó
~/.claude/skills/: skill của riêng bạn, dự án nào cũng dùng được.<dự án>/.claude/skills/: chỉ dùng trong dự án đó. Đẩy lên git là cả team có.
Plugin: một cái hộp đóng gói nhiều thứ
Plugin không phải một loại skill "to hơn". Nó là cách đóng gói. Trong một plugin có thể có:
- Skill: các quy trình, gọi bằng
/. - Agent phụ: một Claude khác được giao việc riêng.
- Hook: lệnh tự chạy khi có sự kiện, ví dụ sau mỗi lần sửa file.
- MCP: phần nối Claude với app bên ngoài.
Skill nằm trong plugin thì gọi kèm tên hộp: /ten-plugin:ten-skill.
Cài plugin như cài app
Marketplace là cửa hàng plugin. Bạn mở danh sách, tìm, bật, tắt ngay trong Claude Code:
/plugin
/plugin install ten-plugin@ten-marketplace
Cài một lệnh là skill, agent, hook đi cùng đều có. Có bản mới thì cập nhật, không phải chép file tay.
Chọn cái nào?
| Skill | Plugin | |
|---|---|---|
| Là gì | Một công thức | Bộ đồ nghề đóng hộp |
| Chứa | Một quy trình | Nhiều skill, agent, hook |
| Cho ai | Riêng bạn, hoặc một dự án | Chia cho cả team |
| Sửa | Sửa file là xong | Cài một lệnh, có phiên bản |
Cách mình làm: bắt đầu bằng skill. Khi một nhóm skill đã ổn và có người khác cần dùng, lúc đó mới đóng thành plugin.
Lưu ý: bật nhiều plugin thì chật ngữ cảnh
Plugin đang bật sẽ nạp sẵn mô tả skill, agent và công cụ MCP vào phiên làm việc, kể cả khi bạn không dùng tới. Bật cả chục cái thì tốn token và Claude dễ chọn nhầm. Chỉ bật cái đang cần, cái nào ít dùng thì tắt bớt trong /plugin.