api-design-principles – skill Lập trình cho agent AI
Nắm vững các nguyên tắc thiết kế API REST và GraphQL để xây dựng API trực quan, có khả năng mở rộng và dễ bảo trì, mang lại trải nghiệm tốt cho lập trình viên và đứng vững theo thời gian.
Cài skill api-design-principles bằng một lệnh
Chọn công cụ bạn đang dùng, copy lệnh và dán vào terminal. Skill sẽ nằm trong thư mục skills của công cụ đó và sẵn sàng dùng ở phiên làm việc tiếp theo.
Claude Code
mkdir -p ~/.claude/skills && curl -fsSL https://skill.dn1nguoi.com/z/api-design-principles-4a348.tgz | tar xz -C ~/.claude/skills
Gọi trong Claude Code: /api-design-principles – rồi mô tả công việc bạn muốn làm.
Codex
mkdir -p ~/.codex/skills && curl -fsSL https://skill.dn1nguoi.com/z/api-design-principles-4a348.tgz | tar xz -C ~/.codex/skills
Gọi trong Codex: $api-design-principles – rồi mô tả công việc bạn muốn làm.
Hermes Agent
mkdir -p ~/.hermes/skills && curl -fsSL https://skill.dn1nguoi.com/z/api-design-principles-4a348.tgz | tar xz -C ~/.hermes/skills
Gọi trong Hermes Agent: /api-design-principles – rồi mô tả công việc bạn muốn làm.
DeepSeek
mkdir -p ~/.deepcode/skills && curl -fsSL https://skill.dn1nguoi.com/z/api-design-principles-4a348.tgz | tar xz -C ~/.deepcode/skills
Gọi trong DeepSeek: /api-design-principles – rồi mô tả công việc bạn muốn làm.
Nội dung SKILL.md
Nội dung SKILL.md gốc bằng tiếng Anh.
API Design Principles
Master REST and GraphQL API design principles to build intuitive, scalable, and maintainable APIs that delight developers and stand the test of time.
Use this skill when
- Designing new REST or GraphQL APIs
- Refactoring existing APIs for better usability
- Establishing API design standards for your team
- Reviewing API specifications before implementation
- Migrating between API paradigms (REST to GraphQL, etc.)
- Creating developer-friendly API documentation
- Optimizing APIs for specific use cases (mobile, third-party integrations)
Do not use this skill when
- You only need implementation guidance for a specific framework
- You are doing infrastructure-only work without API contracts
- You cannot change or version public interfaces
Instructions
1. Define consumers, use cases, and constraints.
2. Choose API style and model resources or types.
3. Specify errors, versioning, pagination, and auth strategy.
4. Validate with examples and review for consistency.
Refer to resources/implementation-playbook.md for detailed patterns, checklists, and templates.
Resources
resources/implementation-playbook.mdfor detailed patterns, checklists, and templates.
Limitations
- Use this skill only when the task clearly matches the scope described above.
- Do not treat the output as a substitute for environment-specific validation, testing, or expert review.
- Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.
Skill liên quan
- api-designer – Tạo đặc tả endpoint REST API hoàn chỉnh, sẵn sàng cho production, cho bất kỳ hệ thống…
- api-documentation – Quy trình tài liệu API để tạo đặc tả OpenAPI, viết hướng dẫn cho lập trình viên và duy…
- api-documentation-generator – Tạo tài liệu API đầy đủ, thân thiện với lập trình viên từ mã nguồn, bao gồm endpoint…
- api-documenter – Thành thạo tài liệu API với OpenAPI 3.1, các công cụ hỗ trợ AI và thực hành trải nghiệm…
- api-endpoint-builder – Xây dựng khung (scaffold) endpoint REST API dễ rà soát, có validation, xử lý lỗi, xác…
- api-fuzzing-bug-bounty – Cung cấp kỹ thuật kiểm thử API REST, SOAP và GraphQL trong săn bug bounty và các đợt…
- api-integration – Thiết kế kiến trúc hướng sự kiện, hệ thống webhook, luồng nối chuỗi API, pipeline ETL và…
- api-integration-architect – Thiết kế, triển khai, gỡ lỗi và tối ưu tích hợp API với các mẫu chuyên sâu cho REST…