Ưu, nhược và chỗ chưa rõ
| Ưu | SKILL.md bảo agent tải README mới nhất của SDK Python và TypeScript trước khi viết code, nên agent ít dùng tên hàm cũ của SDK. | SKILL.md |
|---|---|---|
| Ưu | Skill có sẵn hướng dẫn viết 10 câu hỏi để chấm server, kèm script chạy bộ câu hỏi đó qua stdio, SSE hoặc HTTP. | reference/evaluation.md |
| Nhược | evaluation.py chấm 0 điểm với mọi MCP server thật: kết quả tool không đổi được sang JSON, nên agent chỉ thấy lỗi. Một người dùng sửa tay thì bộ 11 câu lên 11/11. Issue mở từ 04/07/2026, chưa được sửa ở commit mình đọc. | Issue #1390 |
| Nhược | requirements.txt cho cài mcp bản 2.x, mà connections.py dùng tên hàm cũ, nên script báo ImportError ngay khi chạy. Người báo lỗi xác nhận mcp 2.1.1 hỏng, 1.29.1 chạy được. | Issue #1668 |
| Nhược | Model mặc định của evaluation.py là claude-3-7-sonnet-20250219, một bản cũ; phải truyền -m với model khác thì mới chấm theo model đang dùng. | Issue #1716 |
| Chưa rõ | Một issue mở ngày 04/10/2026 cho rằng lời khuyên viết mô tả tool ngắn gọn trong SKILL.md đi ngược tài liệu tool-use của Anthropic, vốn khuyên mô tả chi tiết. Đến 29/10/2026 chưa có trả lời. | Issue #1967 |
| Chưa rõ | Plugin example-skills cài một lúc 12 skill (có cả canvas-design, slack-gif-creator), không cài riêng được mcp-builder theo lệnh trong README. Anthropic còn có skill build-mcp-server trong plugin mcp-server-dev ở chợ claude-plugins-official cho cùng việc; mình chưa so hai skill. | marketplace.json của anthropics/skills |
| Chưa rõ | Lệnh `/plugin marketplace add anthropics/skills` lấy bản mới nhất của repo, không ghim theo commit mình đọc. | README, mục Claude Code |
Khi nên dùng
- Bạn cần nối agent vào một API chưa có MCP server, và muốn agent đi theo các bước có sẵn: đọc API, đặt tên tool, viết server Python hoặc TypeScript.
Khi không nên dùng
- Bạn định dùng evaluation.py để chấm server: ở commit này script chấm sai và hỏng với mcp 2.x, phải tự sửa trước.
Cách cài
Claude Code
/plugin marketplace add anthropics/skills rồi /plugin install example-skills@anthropic-agent-skillsNó chạm vào những gì
- File đọc và ghi
- Skill là file Markdown. Script evaluation.py đọc file câu hỏi XML bạn đưa vào và chỉ ghi file báo cáo khi bạn truyền -o.
- Gọi mạng
- SKILL.md bảo agent tải tài liệu MCP từ modelcontextprotocol.io và README của SDK từ raw.githubusercontent.com. evaluation.py gọi Claude API (api.anthropic.com) và nối tới MCP server bạn chỉ định qua URL.
- Script lúc cài
- Không có script lúc cài. Hai file Python trong scripts/ chỉ chạy khi bạn tự gọi; requirements.txt cần anthropic và mcp.
- Tiến trình
- Ở chế độ stdio, evaluation.py khởi động MCP server bằng lệnh và tham số bạn truyền vào.
Đọc từ: SKILL.md#L70-L75, evaluation.py, connections.py#L75-L85, requirements.txt
Mục này chạy mã trên máy bạn với quyền của tài khoản bạn. Theo tài liệu Claude Code, hook và MCP server chạy ngoài sandbox. Đọc phần trên và file của tác giả trước khi cài. Tài liệu bảo mật plugin