API Design Principles
SkillMediaGuidelines for designing robust, scalable, and intuitive APIs.
Instructions available. Your AI can read the instructions. Execution depends on the setup they require.
Account requirements not reviewed. Check the skill instructions before use; ahel provides instructions and does not run this skill.
Add ahel to your AI once: Claude, ChatGPT, Cursor, Claude Code or Codex. Then ask it to use this.
Then ask your AI: use the API Design Principles skill
What this skill tells your AI
The instructions your AI receives, as published by myths-labs/muse in skills/toolkit/api-design-principles/SKILL.md and read by ahel’s review.
Design APIs that are easy to use and hard to misuse.
RESTful Standards
- Resources: Nouns, plural (e.g.,
/users,/articles). - Methods: GET (read), POST (create), PUT/PATCH (update), DELETE (remove).
- Status Codes:
- 200 OK, 201 Created
- 400 Bad Request, 401 Unauthorized, 403 Forbidden, 404 Not Found
- 500 Server Error
Data Format
- JSON: Standard response format.
- Snake Case:
user_id,created_at(or camelCase if project standard). - Pagination:
page,limitor cursor-based. - Filtering/Sorting: Query parameters.
Signals
- GitHub stars
- 35
- Forks
- 4
- Last commit
- Sep 2026
Advanced
- Item type
- skill
- Key
api-design-principles-myths-labs- Source
- github.com/myths-labs/muse