Rest Endpoint Designer - Auto-activating skill for API Development. Triggers on: rest endpoint designer, rest endpoint designer Part of the API Development skill category.
36
3%
Does it follow best practices?
Impact
100%
1.00xAverage score across 3 eval scenarios
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./planned-skills/generated/15-api-development/rest-endpoint-designer/SKILL.mdRESTful conventions and HTTP semantics
Resource-based URLs
100%
100%
Correct HTTP methods
100%
100%
Appropriate 2xx status codes
100%
100%
4xx client error codes
100%
100%
Hierarchical resource paths
100%
100%
Query parameter filtering
100%
100%
Request body schema
100%
100%
Error response structure
100%
100%
Idempotency consideration
100%
100%
Production-ready concerns
100%
100%
Step-by-step design
100%
100%
OpenAPI specification and standards validation
OpenAPI version field
100%
100%
Info object present
100%
100%
Paths object defined
100%
100%
Operation objects
100%
100%
Response schemas
100%
100%
Components schemas
100%
100%
Schema $ref usage
100%
100%
Request body definition
100%
100%
Security scheme defined
100%
100%
Parameter definitions
100%
100%
Error response documented
100%
100%
YAML or JSON format
100%
100%
Authentication patterns and production-ready API design
Authentication scheme named
100%
100%
Auth header documented
100%
100%
Token or credential lifecycle
100%
100%
401 vs 403 distinction
100%
100%
Role or scope based access
100%
100%
Secure endpoint coverage
100%
100%
Step-by-step structure
100%
100%
Production error handling
100%
100%
Input validation mention
100%
100%
HTTPS or transport security
100%
100%
Token expiry or refresh
100%
100%
Versioning present
100%
100%
b8a3b3e
Table of Contents
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.