Hướng dẫn viết Convex Component
Skill giúp thiết kế, đóng gói và publish component Convex tái sử dụng theo mẫu chuẩn.
Lập trìnhNâng cao★ 405⑂ 32Điểm AI 7/10Cập nhật lần cuối: 6 thg 2, 2026
Skill này làm gì
- Đưa ra cấu trúc thư mục chuẩn cho một component Convex (
src/index.ts,component.ts,schema.ts,functions/). - Cung cấp code mẫu cho
defineComponent,defineSchema, query/mutation kèm validatorv.*và kiểu trả về rõ ràng. - Hướng dẫn tích hợp vào app tiêu thụ bằng
defineApp().use(), kể cả dùng nhiều instance với tên khác nhau. - Kèm mẫu
package.json(peerDependencies, files, prepublishOnly) vàtsconfig.jsonđể publish lên npm. - Liệt kê 5 lỗi thường gặp: tham chiếu chéo bảng, thiếu export type, hardcode cấu hình, không versioning, tài liệu kém.
- Quy tắc an toàn: không tự chạy
npx convex deployhay lệnh git.
Phù hợp với ai
- Lập trình viên dùng Convex muốn tái sử dụng logic giữa nhiều dự án.
- Nhóm muốn publish package Convex nội bộ hoặc mã nguồn mở lên npm.
- Dev TypeScript mới tìm hiểu mô hình cô lập bảng dữ liệu của Convex component.
Ví dụ sử dụng
- "Tạo component rate limiter" → sinh bảng
requests, mutationcheckLimitvà hook phía client như ví dụ trong skill. - "Tách chức năng thông báo trong thư mục convex thành package riêng" → di chuyển schema/functions, viết index.ts và package.json.
- "Gắn component này hai lần với tên khác nhau" → áp dụng
app.use(myComponent, { name: "instance1" }).
· · · Hướng dẫn cài đặt · · ·
Dùng thử ngay, không cần cài
Dán đoạn dưới vào Claude là dùng được skill này mà không cần cài đặt.
Hãy đọc hướng dẫn trong tệp này và làm theo để giúp mình: https://raw.githubusercontent.com/waynesutton/convexskills/HEAD/skills/convex-component-authoring/SKILL.md Mình muốn: (viết việc bạn cần ở đây)
Nếu Claude không mở được liên kết, hãy mở liên kết và copy nội dung vào rồi dán.
↓ Thấy hữu ích thì tải ZIP bên dưới và cài. Sau đó skill tự chạy, không phải dán lại mỗi lần.
Cài vào ứng dụng Claude (không cần terminal)
- Tải tệp ZIP bằng nút bên dưới.
- Trong Claude, mở Settings → Capabilities và bật 'Code execution and file creation'. (chỉ một lần)
- Vào Customize → Skills → + → 'Upload a skill' rồi tải tệp ZIP lên.
Cài vào Claude Code
Để Claude làm — dán câu dưới đây vào Claude Code
Hãy cài skill mình tìm thấy trên Claude Skill Mart. Copy thư mục skills/convex-component-authoring từ repo GitHub waynesutton/convexskills vào ~/.claude/skills/convex-component-authoring/ của mình. Sau khi cài xong, cho mình biết skill này làm được gì trong một câu.
Cài bằng lệnh thủ công
git clone https://github.com/waynesutton/convexskills.git /tmp/convexskills && mkdir -p ~/.claude/skills && cp -r /tmp/convexskills/skills/convex-component-authoring ~/.claude/skills/⚠ Đây là skill do người khác tạo. Hãy kiểm tra repo gốc trước khi cài.
- Mở terminal và clone repo:
git clone https://github.com/waynesutton/convexskills.git - Tạo thư mục skill:
mkdir -p ~/.claude/skills - Copy riêng skill này:
cp -r convexskills/skills/convex-component-authoring ~/.claude/skills/ - Kiểm tra file
~/.claude/skills/convex-component-authoring/SKILL.mdđã tồn tại. - Khởi động lại Claude Code, vào thư mục dự án Convex và yêu cầu ví dụ "tạo một Convex component tái sử dụng".
- Yêu cầu trước: đã có Node.js và package
convex(bản 1.x); hãy tự kiểm tra trước khi chạy lệnh deploy.
Xem mã nguồn trên GitHub ↗Giấy phép: Apache-2.0