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

Trình viết tài liệu API (bản tiếng Tây Ban Nha)

Biến spec API thô hoặc collection Postman thành tài liệu tham chiếu endpoint chuẩn cho nhà phát triển.

Lập trìnhTrung cấp★ 1,437⑂ 257Điểm AI 8/10Cập nhật lần cuối: 11 thg 10, 2026

Giúp được gì

  • Nhận mô tả endpoint, spec thô hoặc file export Postman và tạo tài liệu tham chiếu theo khuôn mẫu cố định.
  • Cấu trúc đầu ra: Summary/Description/Authentication → Request (bảng header, path, query, body) → Response (bảng field kèm kiểu dữ liệu) → bảng mã lỗi kèm cách xử lý → ví dụ code tối thiểu 2 ngôn ngữ (mặc định cURL + Python).
  • Thiếu thông tin thì vẫn xuất đủ tài liệu, đánh dấu (assumed, confirm) và liệt kê giả định ở cuối.
  • Có rubric tự chấm 0–40 điểm (độ đầy đủ tham số, phủ error path, ví dụ chạy được, trung thực về hành vi) cùng checklist chất lượng và danh sách anti-pattern.
  • Dùng kèm references/example-first-docs.md và templates/endpoint-entry.md.
  • Lưu ý: skill không sinh file OpenAPI YAML, chỉ Markdown hoặc văn bản cho Confluence/Notion.

Phù hợp với ai

  • Backend developer cần tài liệu API nhanh mà không muốn viết tay
  • Technical writer, DevRel quản lý developer portal, README, Notion
  • Nhóm cung cấp API cho đối tác bên ngoài cần tài liệu chuẩn hóa
  • Nhóm làm việc bằng tiếng Tây Ban Nha (đây là bản dịch tiếng Tây Ban Nha)

Ví dụ sử dụng

  1. "Viết tài liệu cho endpoint này: GET /v1/users?limit&cursor, auth Bearer" → nhận bảng query param, ví dụ response, bảng lỗi 400/401/404/429/500 và snippet cURL, Python.
  2. Dán JSON collection Postman và yêu cầu "chuyển thành docs cho developer" → nhận bộ trang tham chiếu cho từng endpoint.
  3. "Viết developer guide cho API thanh toán của chúng tôi" → bản nháp gồm xác thực, phân trang, rate limit và các gotcha.

· · · 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/mohitagw15856/pm-claude-skills/HEAD/i18n/es/skills/api-docs-writer/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 i18n/es/skills/api-docs-writer từ repo GitHub mohitagw15856/pm-claude-skills vào ~/.claude/skills/api-docs-writer/ 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/mohitagw15856/pm-claude-skills.git /tmp/pm-claude-skills && mkdir -p ~/.claude/skills && cp -r /tmp/pm-claude-skills/i18n/es/skills/api-docs-writer ~/.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.
  2. Clone repo: git clone https://github.com/mohitagw15856/pm-claude-skills.git /tmp/pm-claude-skills
  3. Tạo thư mục skill: mkdir -p ~/.claude/skills
  4. Copy skill bản tiếng Tây Ban Nha: cp -r /tmp/pm-claude-skills/i18n/es/skills/api-docs-writer ~/.claude/skills/
    • Muốn bản gốc tiếng Anh thì copy /tmp/pm-claude-skills/skills/api-docs-writer.
  5. Kiểm tra các thư mục con references/ và templates/ đã được copy.
  6. Khởi động lại Claude Code và thử: "Viết tài liệu cho endpoint API này".
Xem mã nguồn trên GitHub ↗Giấy phép: MIT