Agent Skills
› rmyndharis/antigravity-skills
› api-design-principles
api-design-principles
GitHub掌握 REST 和 GraphQL API 设计原则，构建直观、可扩展且易维护的 API。适用于设计新 API、审查规范、建立团队标准及迁移范式等场景，旨在提升开发者体验。
触发场景
设计新的 REST 或 GraphQL API
审查 API 规格说明
建立 API 设计标准
重构现有 API 以提升可用性
安装
npx skills add rmyndharis/antigravity-skills --skill api-design-principles -g -y
SKILL.md
Frontmatter
{
"name": "api-design-principles",
"description": "Master REST and GraphQL API design principles to build intuitive, scalable, and maintainable APIs that delight developers. Use when designing new APIs, reviewing API specifications, or establishing API design standards."
}
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
- Define consumers, use cases, and constraints.
- Choose API style and model resources or types.
- Specify errors, versioning, pagination, and auth strategy.
- 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.
版本历史
- e63f7dd 当前 2026-07-05 09:27
