FreeSkills
Commits, branches and sync with the but CLI
- 361361 downloads
- 198198 likes
- 103103 saves
Works with
- Claude Code
- Codex
- Cursor
- and 3 more
REST API design: resources, errors and versioning v1.0.0
Use this resource to design or review a REST API: resources, errors, pagination and versions
New
- 453 downloads
- 158 likes
- 182 saves
Free
Install with the CLI
In a terminal, from the folder you want:
npx --yes palatekit@latest install rest-api-design-errors-versioningWith no option, the skill goes to ~/.agents/skills/; add --agent claude-code (or codex, cursor…) to target an agent.
First time: connect the CLI with
npx --yes palatekit@latest loginThe agent reviews endpoints against 38 rules: resource design, consistent errors with codes and meaningful messages, security, pagination and filtering, versioning, response format and documentation. It keeps stack traces out of responses. You get an API that is more predictable for its developers.
Mostly picked by
Updated November 2, 2026
Previews
Details
- Install guides
- Generates with
- Your agent's model
- Licence
- MIT
Similar resources
View all- Free
FreeSkills
Sentry CLI guide
- 525525 downloads
- 117117 likes
- 128128 saves
Works with- Claude Code
- Codex
- Cursor
- and 3 more
FreeSkills
Drizzle ORM best practices with PostgreSQL
- 407407 downloads
- 194194 likes
- 151151 saves
Works with- Claude Code
- Codex
- Cursor
- and 3 more
FreeSkills
SLO design wizard
- 537537 downloads
- 105105 likes
- 242242 saves
Works with- Claude Code
- Codex
- Cursor
- and 3 more
FreeSkills
User stories and sprint fit
- 451451 downloads
- 150150 likes
- 132132 saves
Works with- Claude Code
- Codex
- Cursor
- and 3 more
FreeSkills
Capacity-based sprint plan
- 423423 downloads
- 192192 likes
- 102102 saves
Works with- Claude Code
- Codex
- Cursor
- and 3 more
FreeSkills
Startup CTO advisor
- 580580 downloads
- 201201 likes
- 242242 saves
Works with- Claude Code
- Codex
- Cursor
- and 3 more
FreeSkills
Creating GitHub pull requests with quality checks
- 427427 downloads
- 230230 likes
- 196196 saves
Works with- Claude Code
- Codex
- Cursor
- and 3 more
What you get
- AGENTS.md: rule categories by priority and quick reference
- rules/: rules on errors, OpenAPI documentation, examples and changelog
Good fit for
- You are creating new endpoints and want a consistent structure
- Your API error messages are inconsistent
Not for
Tags
- rest api
- errors
- versioning
- openapi
About
You say
“Review the endpoints of this API and flag inconsistent error responses.”
Skill published by asyrafhussin under the MIT license, delivered in its original version.
Show moreShow less
How to use it
- Install the skill in your agent's skills folder
- Ask your agent to design or review a REST API: resources, errors, pagination and versions
- Review and adjust the result
Content preview
Files
- AGENTS.md197.5 KB
- LICENSE1.1 KB
- metadata.json1.8 KB
- NOTICE-PALATEKIT.md0.5 KB
- README.md1.8 KB
- rules/_sections.md2.4 KB
- rules/_template.md0.9 KB
- rules/doc-changelog.md4.9 KB
- rules/doc-examples.md5.1 KB
- rules/doc-openapi.md7.2 KB
- rules/error-consistent-format.md8.5 KB
- rules/error-error-codes.md8.5 KB
- rules/error-meaningful-messages.md8 KB
- rules/error-no-stack-traces.md7.7 KB
- rules/error-request-id.md7.2 KB
- rules/error-validation-details.md8.2 KB
- rules/filter-query-params.md2.5 KB
- rules/page-consistent-params.md2.2 KB
- rules/page-cursor-based.md2.1 KB
- rules/page-metadata.md2.3 KB
- rules/page-offset-based.md2.2 KB
- rules/resp-compression.md3.9 KB
- rules/resp-consistent-structure.md3.3 KB
- rules/resp-json-conventions.md3.5 KB
- rules/resp-partial-responses.md4 KB
- rules/rest-hateoas.md6.8 KB
- rules/rest-http-methods.md5.5 KB
- rules/rest-idempotency.md6.3 KB
- rules/rest-nested-resources.md5.1 KB
- rules/rest-nouns-not-verbs.md2.7 KB
- rules/rest-plural-resources.md3.5 KB
- rules/rest-resource-actions.md7.4 KB
- rules/rest-status-codes.md5.7 KB
- rules/sec-authentication.md8.7 KB
- rules/sec-authorization.md8.5 KB
- rules/sec-cors-config.md6.8 KB
- rules/sec-https-only.md7.3 KB
- rules/sec-input-validation.md8.3 KB
- rules/sec-rate-limiting.md7.6 KB
- rules/sec-sensitive-data.md7.4 KB
- rules/sort-flexible.md2.5 KB
- rules/ver-backward-compatible.md2.5 KB
- rules/ver-deprecation.md3 KB
- rules/ver-header-based.md2.7 KB
- rules/ver-url-path.md2.1 KB
- SKILL.md5.9 KB
Origin and licence
Listed unmodified
- Author
- asyrafhussin
- Source
- github.com/asyrafhussin/agent-skills/tree/1aa0ff717c10309226c9e678f00873976450fd76/skills/api-design-patterns
- Licence
- MIT
Notice
« api-design-patterns » (asyrafhussin, MIT) livré dans sa version d'origine : fiche en français et en anglais par PalateKit.
User reviews
–
No ratings yet
Loading reviews…