rest-api-design
Designs RESTful APIs with proper resource naming, HTTP methods, status codes, and response formats. Use when building new APIs, establishing API conventions, or designing developer-friendly interfaces.
92
88%
Does it follow best practices?
Impact
100%
1.09xAverage score across 3 eval scenarios
Passed
No known issues
Evaluation results
100%
15%Library Book Management API
Resource naming and HTTP methods
Plural noun paths
100%
100%
No verb paths
100%
100%
Nested resource path
100%
100%
PATCH for partial update
0%
100%
DELETE method used
100%
100%
201 for creation
100%
100%
200 for GET/PATCH
50%
100%
204 for DELETE
100%
100%
404 for not found
100%
100%
400 for validation
100%
100%
100%
8%Product Search API for Online Marketplace
Collection response format and query params
Data array wrapper
100%
100%
Pagination object
100%
100%
Pagination page field
100%
100%
Pagination limit field
100%
100%
Pagination total field
100%
100%
Pagination totalPages field
100%
100%
Links object
0%
100%
Category filtering
100%
100%
Sort with direction prefix
100%
100%
Field selection
100%
100%
Correct filtered sample output
100%
100%
100%
2%Team Workspace API Documentation
API versioning, error codes, and OpenAPI docs
URL versioning
83%
100%
OpenAPI format
100%
100%
401 for missing auth
100%
100%
403 for permissions
100%
100%
404 for not found
100%
100%
429 for rate limiting
100%
100%
201 for resource creation
100%
100%
400 for validation
100%
100%
Nested message path
100%
100%
Plural nouns in paths
100%
100%
- Repository
- secondsky/claude-skills
- Commit
90d6bd7
- Evaluated
- Agent
- Claude Code
- Model
- Claude Sonnet 4.6
Table of Contents
Is this your skill?
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.