CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

nodejs-backend-patterns

Build production-ready Node.js backend services with Express/Fastify, implementing middleware patterns, error handling, authentication, database integration, and API design best practices. Use when creating Node.js servers, REST APIs, GraphQL backends, or microservices architectures.

56

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/javascript-typescript/skills/nodejs-backend-patterns/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

43%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.

The body works as a lean overview with a real pointer to substantive worked examples, but it over-relies on delegation: the in-body content is either generic best-practice reminders Claude already knows or library name-drops without executable guidance, and there is no sequenced workflow. The reference chain (SKILL.md → details.md → advanced-patterns.md) also adds a nesting level beyond the ideal one-level-deep structure.

Suggestions

Add a sequenced workflow for the common case (e.g., scaffold service → define middleware/error handling → add auth → integrate database → verify), since workflow_clarity scored lowest and the body currently has no order of operations or validation checkpoints.

Replace or trim the 15-item Best Practices list of knowledge Claude already has (use HTTPS, write tests, env vars) and the padded intro sentence; surface one or two of the highest-value concrete patterns from references/details.md inline to raise actionability.

Flatten the reference chain: list both references/details.md and references/advanced-patterns.md as separate per-topic pointers directly in SKILL.md so navigation is one level deep and advanced-patterns.md is discoverable.

DimensionReasoningScore

Conciseness

The body is structurally terse, but the intro paragraph ('Comprehensive guidance for building scalable, maintainable, and production-ready...') is fluff, and the 15-item Best Practices list ('Use HTTPS: Always in production', 'Write tests', 'Use environment variables') largely restates knowledge Claude already has, matching the anchor for mostly efficient with some unnecessary content. Not a 2 because there is no wordy over-explanation or padded tutorial prose; not a 4 because the fluff intro and generic best-practices list are more than minor trimming.

3 / 5

Actionability

The body names concrete libraries ('Zod or Joi', 'Pino, Winston', 'helmet') but provides no executable code, commands, or pattern examples in SKILL.md itself — all concrete guidance is deferred to references/details.md, matching the anchor for some concrete guidance but incomplete. Not a 4 because nothing in the body is directly executable; not a 2 because specific library names and a real pointer to worked examples go beyond high-level hints.

3 / 5

Workflow Clarity

No multi-step process is sequenced anywhere — the body is a when-to-use bullet list, a pointer to details.md, and a generic best-practices catalog with no order of operations or validation checkpoints, fitting the low anchor for absent sequence and validation. Not a 1 because the sections are coherent and do define a minimal reading path (overview → details.md), but there is no rough sequence of actual work steps to justify a 3.

2 / 5

Progressive Disclosure

The body signals references/details.md (a real file) in a dedicated section, and per-topic bullets exist, but references are one unexplained pointer rather than per-topic navigation, and details.md itself chains into references/advanced-patterns.md — a two-level reference chain the rubric penalizes. This matches the anchor for some structure with references present but not clearly signaled; not a 4 because advanced-patterns.md is undiscoverable from SKILL.md and the nesting exceeds the one-level-deep ideal.

3 / 5

Total

11

/

20

Passed

Description

83%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 strong description: third-person, concrete, and compact, with an explicit 'Use when...' trigger clause covering natural terms. It sits just below top marks on specificity and trigger coverage due to a generic 'best practices' phrase and a few missing natural synonyms (Express, Fastify).

DimensionReasoningScore

Specificity

Names the domain ('Node.js backend services with Express/Fastify') and lists several concrete actions — 'middleware patterns, error handling, authentication, database integration' — matching the anchor for several specific actions. It falls short of the 5 anchor because 'API design best practices' is generic and coverage has minor gaps (e.g., testing, WebSockets appear in the body but not the description); it is clearly above the 3 anchor, which expects only 1-2 concrete actions.

4 / 5

Completeness

Both halves are explicit: the 'what' ('Build production-ready Node.js backend services... implementing middleware patterns, error handling, authentication, database integration') and the 'when' ('Use when creating Node.js servers, REST APIs, GraphQL backends, or microservices architectures') with concrete trigger phrases, matching the top anchor exactly. It is clearly above the 4 anchor, where the 'when' would only be loosely specified.

5 / 5

Trigger Term Quality

'Use when creating Node.js servers, REST APIs, GraphQL backends, or microservices architectures' gives good natural keyword coverage a user would actually say. Not a 5 because common variations are missing — 'Express', 'Fastify', 'Node backend', 'API development' — leaving a few natural terms uncovered.

4 / 5

Distinctiveness Conflict Risk

The Express/Fastify Node.js backend niche is mostly distinct with specific framework names anchoring it. Not a 5 because broad triggers like 'REST APIs' and 'microservices architectures' create minor overlap risk with generic API-design or architecture skills.

4 / 5

Total

17

/

20

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.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

wshobson/agents

Path

plugins/javascript-typescript/skills/nodejs-backend-patterns/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.