api-design-principles
A skill in the agentic-awesome-skills collection for designing and reviewing REST and GraphQL APIs so they are easy to use, scale and maintain.
What the skill teaches
A skill in the agentic-awesome-skills collection for designing and reviewing REST and GraphQL APIs so they are easy to use, scale and maintain. It applies to new APIs, refactoring existing ones, setting team standards, reviewing specs before they are built, moving between REST and GraphQL, writing developer documentation and shaping APIs for mobile or third-party clients, but not to framework-specific code or infrastructure work. The agent defines consumers and constraints, picks a style and models resources or types, specifies errors, versioning, pagination and authentication, and checks the design with examples. A playbook file holds the detailed patterns and checklists. Its metadata gives the source only as community.
Capabilities
- Choose an API style and model resources
- Specify errors, versioning and pagination
- Review an API spec before implementation
About
- Publisher
- sickn33
- Tool
- Code review
Install
The project doesn't document install steps that we could confirm. See the project's own instructions
What's inside
- assets/api-design-checklist.md
- assets/rest-api-template.py
- references/graphql-schema-design.md
- references/rest-best-practices.md
- resources/implementation-playbook.md
MCP servers and skills can run code on your computer and act on your data. Review the source before installing.
Details
| Fact | Value | Source |
|---|---|---|
| Type | Skill | |
| Tool | Code review | |
| Publisher | sickn33 | source |
| Official status | Not stated in its documentation | |
| Needs an API key or sign-in | Not stated in its documentation | |
| Includes scripts | No | source |
| Platforms | Not stated in its documentation | |
| AI clients | Not stated in its documentation | |
| Licence | MIT | source |
| Pricing | Not stated in its documentation | |
| Activity | Last commit Nov 10, 202649,466 GitHub starsDownload data not available (not on npm or PyPI) | source |
| Links | Repository Website |
Copies of this skill in other repositories (1)
These differ from this skill's text. They may be adapted copies or older versions.
- api-design-principlesaicodedecode/awesome-muse-skills
More from sickn33
24 skills
- googlesheets-automation (Skill)
- airtable-automation (Skill)
- shopify-automation (Skill)
- playwright-skill (Skill)
- hugging-face-evaluation (Skill)
- stripe-integration (Skill)
Also listed under: Code review
Sources
- Skill file (SKILL.md)github.com/sickn33/agentic-awesome-skills · Backs: Includes scriptsNov 16, 2026
- GitHub repositorygithub.com/sickn33/agentic-awesome-skills · Backs: Publisher, Activity, LicenceNov 10, 2026
- Skill file (SKILL.md)github.com/sickn33/agentic-awesome-skillsNov 14, 2026
- Folder in the repository (api-design-principles)github.com/sickn33/agentic-awesome-skills · Backs: Includes scriptsNov 14, 2026