CtrlK
BlogDocsLog inGet started
Tessl Logo

rest-patterns

Quick reference for RESTful API design patterns, HTTP semantics, caching, and rate limiting. Triggers on: rest api, http methods, status codes, api design, endpoint design, api versioning, rate limiting, caching headers.

90

1.16x
Quality

87%

Does it follow best practices?

Impact

94%

1.16x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No known issues

SKILL.md
Quality
Evals
Security

Quality

Discovery

89%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

This is a solid skill description with excellent trigger term coverage and clear completeness. Its main weakness is that it describes itself as a 'quick reference' rather than listing specific concrete actions (e.g., 'recommends appropriate HTTP status codes, designs endpoint naming conventions, configures caching headers'). The explicit trigger list is a strong feature that aids skill selection.

Suggestions

Replace 'Quick reference for' with specific action verbs describing what the skill does, e.g., 'Recommends HTTP status codes, designs RESTful endpoint structures, configures caching headers, and implements rate limiting strategies.'

DimensionReasoningScore

Specificity

Names the domain (RESTful API design) and lists several topic areas (HTTP semantics, caching, rate limiting), but describes itself as a 'quick reference' rather than listing specific concrete actions it performs.

2 / 3

Completeness

Clearly answers both 'what' (quick reference for RESTful API design patterns, HTTP semantics, caching, rate limiting) and 'when' (explicit 'Triggers on:' clause with specific trigger terms), satisfying the requirement for explicit trigger guidance.

3 / 3

Trigger Term Quality

Excellent coverage of natural trigger terms users would say: 'rest api', 'http methods', 'status codes', 'api design', 'endpoint design', 'api versioning', 'rate limiting', 'caching headers' — these are all terms users would naturally use when seeking this kind of help.

3 / 3

Distinctiveness Conflict Risk

The combination of REST API design patterns, HTTP semantics, caching, and rate limiting creates a clear niche. The specific trigger terms like 'status codes', 'endpoint design', and 'api versioning' make it unlikely to conflict with other skills.

3 / 3

Total

11

/

12

Passed

Implementation

85%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This is a well-crafted reference skill that excels at conciseness and organization. Tables are used effectively for dense information delivery, and progressive disclosure to reference files is well-structured. The main weakness is that some topics mentioned in the description (caching headers, rate limiting implementation) lack concrete examples in the main file, relying entirely on external references for actionable detail.

Suggestions

Add a brief concrete example of Cache-Control and rate-limiting response headers (e.g., `Cache-Control: public, max-age=3600` and `X-RateLimit-Remaining: 99`) to make the main file more actionable on those topics.

DimensionReasoningScore

Conciseness

The content is lean and well-structured using tables for maximum information density. It avoids explaining what REST is or how HTTP works—concepts Claude already knows—and focuses purely on quick-reference patterns.

3 / 3

Actionability

The skill provides concrete patterns and examples (URL structures, query parameters, status codes) but lacks executable code examples for implementation. The caching headers and rate limiting mentioned in the description are not concretely demonstrated with actual header examples or implementation code.

2 / 3

Workflow Clarity

This is a reference/lookup skill rather than a multi-step workflow, so the single-task clarity standard applies. The information is clearly organized into logical sections with unambiguous guidance, and the security checklist provides a clear validation checkpoint.

3 / 3

Progressive Disclosure

Excellent progressive disclosure: the main file serves as a concise overview with well-signaled one-level-deep references to four specific detail files (status-codes.md, caching-patterns.md, rate-limiting.md, response-formats.md) for deeper content.

3 / 3

Total

11

/

12

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
NeverSight/skills_feed
Reviewed

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.