CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

api-endpoint-builder

Builds production-ready REST API endpoints with validation, error handling, authentication, and documentation. Follows best practices for security and scalability.

Quality

71%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./plugins/AI-Agents-Safe-Coding-Skills-claude/skills/api-endpoint-builder/SKILL.md

The canonical home for this skill is api-endpoint-builder in sickn33/agentic-awesome-skills

SKILL.md
Quality
Evals
Security

Quality

Content

65%Weight 40%Scale 1-5

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

A strong actionability story — complete, executable code for validation, handlers, pagination, documentation, and tests — undermined by a monolithic 310-line layout with no reference files, and by sections (status-code tables, CRUD patterns, 'Key Principles') that restate knowledge Claude already has. Adding a verification checkpoint to the endpoint workflow would raise workflow clarity materially.

Suggestions

Split stable reference material (testing example, documentation template, CRUD/pattern catalog) into one-level-deep files under references/ and link them from concise sections in SKILL.md.

Replace the HTTP status-code list and 'Key Principles' sections with only the non-obvious project-specific conventions, trusting Claude's existing knowledge of REST basics.

Add an explicit validation step to the workflow (e.g., 'after implementing an endpoint, run the route tests and verify each error branch returns the documented status code') to close the workflow-clarity gap.

DimensionReasoningScore

Conciseness

The body is mostly tight code, but several sections re-teach basic programming knowledge Claude already has: the HTTP status code list ('200 - Success (GET, PUT, PATCH)' ... '500 - Internal Server Error'), the generic CRUD routes section, and the 'Key Principles' list ('Validate all inputs before processing', 'Never expose sensitive data'). This matches anchor 3 ('mostly efficient but includes some unnecessary explanation or could be tightened') — not 2 because there is no padded prose or introductory filler, and not 4 because the unnecessary sections are substantive enough that trimming would meaningfully reduce token load.

3 / 5

Actionability

The guidance is fully executable and copy-paste ready: a complete validation middleware, a working Express createUser handler with bcrypt hashing and duplicate checks, pagination/filtering handlers with real Mongoose-style calls, a documentation comment template, and runnable Jest/supertest examples covering the common create-and-validate cases. This matches anchor 5 ('fully executable; copy-paste ready code; specific examples cover the common cases') — the examples are complete with error branches rather than pseudocode or high-level hints.

5 / 5

Workflow Clarity

The sequence is present ('Endpoint Structure' walks Route Definition → Input Validation → Handler Implementation, and 'What You'll Build' enumerates the components per endpoint), and the Security Checklist adds some checkpoints. However there are no explicit validation/verification steps — nothing instructs running the tests, hitting the endpoint, or verifying behavior before finishing, and testing is merely 'Tests (if requested)'. This matches anchor 3 ('steps listed but validation gaps; sequence present but checkpoints missing or implicit') rather than 4, which requires most checkpoints to be present.

3 / 5

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ are all absent), and the ~310-line body inlines several bodies of content that would sit better in one-level-deep references — the testing example, the documentation template, and the CRUD/pattern catalog. Section headers give it real structure, so it is above anchor 2 ('content that clearly belongs in separate files is inlined' with no structure), but it does not reach anchor 4 because nothing is split out and there are no signaled reference files at all.

3 / 5

Total

14

/

20

Passed

Description

66%Weight 40%Scale 1-5

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

A solid description with a concrete, multi-action 'what' and natural trigger terms, but it is missing the explicit 'when to use' clause the rubric requires for full completeness, and the trailing 'Follows best practices for security and scalability' sentence adds fluff without information. It sits comfortably in the upper-middle of the scale.

Suggestions

Add an explicit trigger clause, e.g. 'Use when the user asks to create or modify API endpoints, routes, or CRUD operations, or mentions REST, backend, or Express/Fastify.'

Drop or replace the vague 'Follows best practices for security and scalability' sentence with concrete capabilities (e.g., pagination, filtering, response formatting) so every token carries information.

Include user-natural synonyms such as 'endpoint', 'route', and 'CRUD' to strengthen trigger-term coverage.

DimensionReasoningScore

Specificity

The description names the domain ('REST API endpoints') and lists several concrete actions — 'validation, error handling, authentication, and documentation' — with only minor coverage gaps (e.g., no mention of CRUD or routing). This matches anchor 4 ('lists several specific actions; minor gaps'); it falls short of anchor 5 because coverage is not comprehensive, and above anchor 3 because more than 1-2 actions are enumerated.

4 / 5

Completeness

The 'what' is clear ('Builds production-ready REST API endpoints with validation, error handling, authentication, and documentation'), but there is no 'Use when...' clause or equivalent explicit trigger guidance — the judging guideline caps completeness at 3 in that case. It is not a 4 because the 'when' is entirely absent rather than merely implicit, and not a 2 because the 'what' half is concrete and multi-action.

3 / 5

Trigger Term Quality

'REST API', 'API endpoints', 'authentication', 'validation' are natural phrases users would say when needing this skill, giving good keyword coverage. It sits at anchor 4 rather than 5 because common synonyms users actually say — 'endpoint', 'route', 'CRUD', 'backend' — are absent, and above anchor 3 because the included terms go beyond a bare domain mention.

4 / 5

Distinctiveness Conflict Risk

The niche (building REST endpoints) is mostly distinct with minor overlap risk against closely related backend or security skills. It is not a 5 because terms like 'authentication' and 'validation' could also pull in security-audit or testing skills, and not a 3 because the core trigger (endpoint/route building) is specific enough to avoid broad conflicts.

4 / 5

Total

15

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

plugins/AI-Agents-Safe-Coding-Skills-claude/skills/api-endpoint-builder/SKILL.md

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.