Ưu, nhược và chỗ chưa rõ
| Ưu | README ghi: skill supabase-postgres-best-practices chia hướng dẫn thành 8 nhóm, xếp theo mức ảnh hưởng, gồm query, connection, schema, khóa bảng và RLS. | README, mục Available Skills |
|---|---|---|
| Ưu | Agent chỉ đọc file hướng dẫn, nên bạn không phải đưa mật khẩu database hay token Supabase cho skill. | Thư mục skills |
| Ưu | Skill supabase dặn agent dùng token giới hạn theo project thay cho token có quyền trên cả tài khoản khi gọi Management API, CLI hoặc MCP. | SKILL.md |
| Nhược | Khi bạn nhờ agent dựng project mới từ đầu, các file tham khảo của skill Postgres không được nạp, vì phần mô tả skill chỉ nhắc tới tối ưu hiệu năng. Agent quay về kiến thức cũ, ví dụ gói auth đã bỏ. Issue mở ngày 05/06/2026, chưa đóng. | Issue #100 |
| Nhược | Skill supabase bắt agent tải changelog và trang docs của Supabase trước khi làm, nên mỗi việc tốn thêm lượt gọi mạng và token. | SKILL.md |
| Chưa rõ | Cả hai cách cài (plugin marketplace và npx skills add) đều lấy bản mới nhất, README không ghi cách ghim phiên bản. | README, mục Installation |
| Chưa rõ | Plugin lấy gốc repo làm nguồn, và gốc repo có .mcp.json khai báo Supabase MCP (nhóm docs). Cài plugin có thể thêm luôn server MCP này; mình không chạy thử để xác nhận. | marketplace.json |
Khi nên dùng
- Bạn viết SQL, thiết kế schema hoặc RLS cho Postgres hay Supabase và muốn agent theo hướng dẫn của Supabase mà không cấp quyền vào database.
Khi không nên dùng
- Bạn cần agent chạy query thật trên database (dùng một MCP), hoặc bạn đang dựng project mới từ đầu và chưa có cách bắt agent nạp file tham khảo (Issue #100).
Cách cài
Claude Code
claude plugin marketplace add supabase/agent-skills && claude plugin install postgres-best-practices@supabase-agent-skillsClaude Code, GitHub Copilot, Cursor, Cline (skills CLI; README gives one command for all agents)
npx skills add supabase/agent-skills --skill supabase-postgres-best-practicesNó chạm vào những gì
- File đọc và ghi
- Chỉ có file Markdown (SKILL.md và references/*.md), không có script trong thư mục skills. SKILL.md của skill supabase bảo agent tạo .mcp.json ở thư mục gốc project nếu chưa có, trỏ tới mcp.supabase.com.
- Gọi mạng
- SKILL.md bảo agent tải https://supabase.com/changelog.md và các trang docs trước khi làm, và chạy curl tới mcp.supabase.com khi kiểm tra kết nối. references/skill-feedback.md bảo agent hỏi bạn rồi mới tạo issue trên GitHub supabase/agent-skills.
- Script lúc cài
- Không có script chạy lúc cài. scripts/build-release.ts chỉ dùng khi Supabase phát hành bản mới.
- Tiến trình
- Không chạy tiến trình nào. File .mcp.json ở gốc repo khai báo Supabase MCP (chỉ nhóm docs), và marketplace.json lấy gốc repo làm nguồn plugin (xem dòng Chưa rõ).
Đọc từ: SKILL.md#L16, SKILL.md#L108, skill-feedback.md, .mcp.json, marketplace.json
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