Summary
A solid reference for REST API conventions that covers the essentials: resource naming with plural nouns, proper HTTP method usage, status code selection, and response formatting. Shows good versus bad URL patterns, includes a clean table of when to use 200 versus 201 versus 204, and demonstrates pagination and filtering with query parameters. The JSON-API inspired response format with data, meta, and links is opinionated but clean. Use this when you're designing a new API from scratch or trying to get your team aligned on consistent conventions. It won't make architectural decisions for you, but it will keep you from reinventing basic patterns or mixing POST and GET semantics.
Install to Claude Code
npx -y skills add secondsky/claude-skills --skill rest-api-design --agent claude-codeInstalls into .claude/skills of the current project.
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →
Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →
Files
SKILL.md
Select a file.
Featured
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →
