Claude Skill MartKhám phá skillCâu dùng ngayHọc qua videoDùng terminalSkill là gì?
 
← Về danh sách

Chuyên gia thiết kế API (api-designer)

Kỹ năng giúp thiết kế API REST/GraphQL bài bản: từ mô hình tài nguyên đến đặc tả OpenAPI 3.1 và chiến lược phiên bản.

Web · APITrung cấp★ 11,020⑂ 1,033Điểm AI 8/10Cập nhật lần cuối: 7 thg 8, 2026

Kỹ năng này làm gì

  • Dẫn dắt quy trình 6 bước: phân tích nghiệp vụ → mô hình tài nguyên → thiết kế endpoint → viết đặc tả OpenAPI 3.1 → chạy mock server kiểm thử hợp đồng → lập kế hoạch versioning.
  • Cung cấp mẫu YAML copy-paste sẵn: phân trang bằng cursor, lỗi theo RFC 7807 (application/problem+json), xác thực Bearer JWT.
  • Nhắc kiểm tra bằng npx @redocly/cli lint openapi.yaml và mock bằng npx @stoplight/prism-cli mock openapi.yaml.
  • Liệt kê rõ điều PHẢI làm / KHÔNG được làm: không dùng động từ trong URI, cấu trúc phản hồi nhất quán, luôn có phân trang và rate limiting.

Phù hợp với ai

  • Lập trình viên backend, kiến trúc sư cần thiết kế API mới từ đầu.
  • Team lead muốn chuẩn hóa định dạng lỗi, chính sách phiên bản, phân trang cho cả nhóm.
  • Người cần tài liệu hóa API hiện có thành OpenAPI để sinh SDK.

Ví dụ sử dụng

  1. "Thiết kế REST API cho module đơn hàng và thanh toán" → nhận bảng tài nguyên, danh sách endpoint, file OpenAPI 3.1 và danh mục lỗi.
  2. "Thêm trường mới vào API v1 mà không phá vỡ tương thích" → nhận chiến lược deprecation và lộ trình migration.
  3. "Chuyển API danh sách sang phân trang cursor" → nhận schema next_cursor/has_more cùng phản hồi 400/401/429.

· · · 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/Jeffallan/claude-skills/HEAD/skills/api-designer/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)
  1. Tải tệp ZIP bằng nút bên dưới.
  2. Trong Claude, mở Settings → Capabilities và bật 'Code execution and file creation'. (chỉ một lần)
  3. Vào Customize → Skills → + → 'Upload a skill' rồi tải tệp ZIP lên.
↓ Tải ZIP
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/api-designer từ repo GitHub Jeffallan/claude-skills vào ~/.claude/skills/api-designer/ 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/Jeffallan/claude-skills.git /tmp/claude-skills && mkdir -p ~/.claude/skills && cp -r /tmp/claude-skills/skills/api-designer ~/.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.

  1. Mở terminal và tải repo: git clone https://github.com/Jeffallan/claude-skills.git
  2. Tạo thư mục skill: mkdir -p ~/.claude/skills
  3. Sao chép skill: cp -r claude-skills/skills/api-designer ~/.claude/skills/
  4. Kiểm tra bằng ls ~/.claude/skills/api-designer để chắc chắn có SKILL.md và thư mục references/.
  5. Cài Node.js (kèm npx) nếu muốn dùng lệnh lint và mock server.
  6. Khởi động lại Claude Code, rồi yêu cầu ví dụ: "Thiết kế OpenAPI cho API người dùng" để skill tự kích hoạt.
Xem mã nguồn trên GitHub ↗Giấy phép: MIT