{"id":"c5388a4a-63f8-4efe-b214-3c7899f963b1","shortId":"BJWr8k","kind":"skill","title":"api-design-principles","tagline":"Master REST and GraphQL API design principles to build intuitive, scalable, and maintainable APIs that delight developers and stand the test of time.","description":"# API Design Principles\n\nMaster REST and GraphQL API design principles to build intuitive, scalable, and maintainable APIs that delight developers and stand the test of time.\n\n## Use this skill when\n\n- Designing new REST or GraphQL APIs\n- Refactoring existing APIs for better usability\n- Establishing API design standards for your team\n- Reviewing API specifications before implementation\n- Migrating between API paradigms (REST to GraphQL, etc.)\n- Creating developer-friendly API documentation\n- Optimizing APIs for specific use cases (mobile, third-party integrations)\n\n## Do not use this skill when\n\n- You only need implementation guidance for a specific framework\n- You are doing infrastructure-only work without API contracts\n- You cannot change or version public interfaces\n\n## Instructions\n\n1. Define consumers, use cases, and constraints.\n2. Choose API style and model resources or types.\n3. Specify errors, versioning, pagination, and auth strategy.\n4. Validate with examples and review for consistency.\n\nRefer to `resources/implementation-playbook.md` for detailed patterns, checklists, and templates.\n\n## Resources\n\n- `resources/implementation-playbook.md` for detailed patterns, checklists, and templates.\n\n## Limitations\n- Use this skill only when the task clearly matches the scope described above.\n- Do not treat the output as a substitute for environment-specific validation, testing, or expert review.\n- Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.","tags":["api","design","principles","antigravity","awesome","skills","sickn33","agent-skills","agentic-skills","ai-agent-skills","ai-agents","ai-coding"],"capabilities":["skill","source-sickn33","skill-api-design-principles","topic-agent-skills","topic-agentic-skills","topic-ai-agent-skills","topic-ai-agents","topic-ai-coding","topic-ai-workflows","topic-antigravity","topic-antigravity-skills","topic-claude-code","topic-claude-code-skills","topic-codex-cli","topic-codex-skills"],"categories":["antigravity-awesome-skills"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/sickn33/antigravity-awesome-skills/api-design-principles","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add sickn33/antigravity-awesome-skills","source_repo":"https://github.com/sickn33/antigravity-awesome-skills","install_from":"skills.sh"}},"qualityScore":"0.700","qualityRationale":"deterministic score 0.70 from registry signals: · indexed on github topic:agent-skills · 34964 github stars · SKILL.md body (1,536 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-04-25T00:50:26.527Z","embedding":null,"createdAt":"2026-04-18T21:31:04.971Z","updatedAt":"2026-04-25T00:50:26.527Z","lastSeenAt":"2026-04-25T00:50:26.527Z","tsv":"'1':140 '2':147 '3':156 '4':164 'api':2,9,18,28,35,44,63,66,71,78,84,94,97,130,149 'api-design-principl':1 'ask':222 'auth':162 'better':68 'boundari':230 'build':13,39 'cannot':133 'case':101,144 'chang':134 'checklist':178,186 'choos':148 'clarif':224 'clear':197 'consist':171 'constraint':146 'consum':142 'contract':131 'creat':90 'criteria':233 'defin':141 'delight':20,46 'describ':201 'design':3,10,29,36,58,72 'detail':176,184 'develop':21,47,92 'developer-friend':91 'document':95 'environ':213 'environment-specif':212 'error':158 'establish':70 'etc':89 'exampl':167 'exist':65 'expert':218 'framework':121 'friend':93 'graphql':8,34,62,88 'guidanc':117 'implement':81,116 'infrastructur':126 'infrastructure-on':125 'input':227 'instruct':139 'integr':106 'interfac':138 'intuit':14,40 'limit':189 'maintain':17,43 'master':5,31 'match':198 'migrat':82 'miss':235 'mobil':102 'model':152 'need':115 'new':59 'optim':96 'output':207 'pagin':160 'paradigm':85 'parti':105 'pattern':177,185 'permiss':228 'principl':4,11,30,37 'public':137 'refactor':64 'refer':172 'requir':226 'resourc':153,181 'resources/implementation-playbook.md':174,182 'rest':6,32,60,86 'review':77,169,219 'safeti':229 'scalabl':15,41 'scope':200 'skill':56,111,192 'skill-api-design-principles' 'source-sickn33' 'specif':79,99,120,214 'specifi':157 'stand':23,49 'standard':73 'stop':220 'strategi':163 'style':150 'substitut':210 'success':232 'task':196 'team':76 'templat':180,188 'test':25,51,216 'third':104 'third-parti':103 'time':27,53 'topic-agent-skills' 'topic-agentic-skills' 'topic-ai-agent-skills' 'topic-ai-agents' 'topic-ai-coding' 'topic-ai-workflows' 'topic-antigravity' 'topic-antigravity-skills' 'topic-claude-code' 'topic-claude-code-skills' 'topic-codex-cli' 'topic-codex-skills' 'treat':205 'type':155 'usabl':69 'use':54,100,109,143,190 'valid':165,215 'version':136,159 'without':129 'work':128","prices":[{"id":"b29e00bc-763b-476c-88eb-5644bda0749a","listingId":"c5388a4a-63f8-4efe-b214-3c7899f963b1","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"sickn33","category":"antigravity-awesome-skills","install_from":"skills.sh"},"createdAt":"2026-04-18T21:31:04.971Z"}],"sources":[{"listingId":"c5388a4a-63f8-4efe-b214-3c7899f963b1","source":"github","sourceId":"sickn33/antigravity-awesome-skills/api-design-principles","sourceUrl":"https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/api-design-principles","isPrimary":false,"firstSeenAt":"2026-04-18T21:31:04.971Z","lastSeenAt":"2026-04-25T00:50:26.527Z"}],"details":{"listingId":"c5388a4a-63f8-4efe-b214-3c7899f963b1","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"sickn33","slug":"api-design-principles","github":{"repo":"sickn33/antigravity-awesome-skills","stars":34964,"topics":["agent-skills","agentic-skills","ai-agent-skills","ai-agents","ai-coding","ai-workflows","antigravity","antigravity-skills","claude-code","claude-code-skills","codex-cli","codex-skills","cursor","cursor-skills","developer-tools","gemini-cli","gemini-skills","kiro","mcp","skill-library"],"license":"mit","html_url":"https://github.com/sickn33/antigravity-awesome-skills","pushed_at":"2026-04-24T06:41:17Z","description":"Installable GitHub library of 1,400+ agentic skills for Claude Code, Cursor, Codex CLI, Gemini CLI, Antigravity, and more. Includes installer CLI, bundles, workflows, and official/community skill collections.","skill_md_sha":"dcdb892dd6ba80ef151484a6b4e226dbf3156ceb","skill_md_path":"skills/api-design-principles/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/api-design-principles"},"layout":"multi","source":"github","category":"antigravity-awesome-skills","frontmatter":{"name":"api-design-principles","description":"Master REST and GraphQL API design principles to build intuitive, scalable, and maintainable APIs that delight developers and stand the test of time."},"skills_sh_url":"https://skills.sh/sickn33/antigravity-awesome-skills/api-design-principles"},"updatedAt":"2026-04-25T00:50:26.527Z"}}