api-design
A reference skill from the ECC collection for designing or reviewing REST APIs.
What the skill teaches
A reference skill from the ECC collection for designing or reviewing REST APIs. It covers naming resources as plural, lowercase nouns, which HTTP methods are safe or idempotent, which status codes to return, and the shape of single, list and error responses. It compares offset and cursor pagination, shows filtering, sorting, search and sparse field selection, and covers bearer tokens and API keys, ownership and role checks, rate-limit headers and versioning in the URL path with a deprecation policy. Example handlers are given in TypeScript, Python and Go, and it ends with a checklist to go through before an API ships.
Capabilities
- Name REST resources and choose HTTP methods and status codes
- Design pagination, filtering and sorting
- Plan rate limiting and API versioning
- Check an API against a pre-release list
About
- Publisher
- affaan-m
Install
The project doesn't document install steps that we could confirm. See the project's own instructions
What's inside
- agents/openai.yaml
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 | Not stated in its documentation | |
| Publisher | affaan-m | 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 9, 2026300,529 GitHub starsDownload data not available (not on npm or PyPI) | source |
| Links | Repository Website |
Sources
- Skill file (SKILL.md)github.com/affaan-m/ecc · Backs: Licence, Includes scriptsNov 15, 2026
- GitHub repositorygithub.com/affaan-m/ecc · Backs: Publisher, Activity, LicenceNov 10, 2026
- Skill file (SKILL.md)github.com/affaan-m/ECCNov 10, 2026
- Folder in the repository (api-design)github.com/affaan-m/ECC · Backs: Includes scriptsNov 10, 2026