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.

Quality

78%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./skills_all/nodejs-backend-patterns/SKILL.md

Quality

Content

57%Weight 40%Scale 1-3

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

The content is highly actionable with complete, executable TypeScript examples across many backend concerns, but it is a monolithic ~1000-line dump that largely restates patterns Claude already knows, has no progressive disclosure or supporting bundle files, and lacks sequenced workflows with validation checkpoints for its destructive operations.

Suggestions

Split the body into a concise overview plus one-level-deep reference files (e.g. references/middleware.md, references/database.md, references/auth.md) so SKILL.md points to rather than inlines each pattern.

Add a sequenced 'Building a service' workflow with explicit validation checkpoints (e.g. run tests, validate schema, verify DB migration) instead of presenting patterns as disconnected topical sections.

Trim boilerplate concepts Claude already knows (standard layered architecture explanations, generic DI container mechanics) and keep only the non-obvious project-specific decisions, reducing token cost.

Dimension	Reasoning	Score
Conciseness	Largely executable and well-organized, but the ~1000-line body inlines full implementations of standard patterns (layered architecture, DI container, caching, auth) that Claude already knows, repeating near-identical boilerplate rather than earning every token.	2 / 3
Actionability	Provides complete, copy-paste-ready TypeScript snippets for each pattern — Express/Fastify setup, repositories, middleware, error classes, transactions, JWT auth — with concrete imports and runnable structure.	3 / 3
Workflow Clarity	Sections are topical but not sequenced as a build workflow, and the destructive/batch operations it covers (database transactions, inventory updates in createOrder) lack validation checkpoints or rollback/feedback guidance beyond the inline try/ROLLBACK.	2 / 3
Progressive Disclosure	No bundle files exist (references/, scripts/, assets/ absent) and the body is a monolithic wall of inline code; the only external pointer is 'See javascript-testing-patterns skill' for an entire major topic (testing), leaving that section effectively empty.	1 / 3
	Total	8 / 12 Passed

Description

100%Weight 40%Scale 1-3

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, well-structured description: it states concrete capabilities, uses natural trigger terms, and includes an explicit 'Use when' clause scoped to Node.js backends. It is concise, third-person, and distinct from adjacent skills.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions — 'implementing middleware patterns, error handling, authentication, database integration, and API design best practices' — naming specific capabilities rather than vague language.	3 / 3
Completeness	Explicitly answers what ('Build production-ready Node.js backend services with Express/Fastify...') and when ('Use when creating Node.js servers, REST APIs, GraphQL backends, or microservices architectures').	3 / 3
Trigger Term Quality	Covers natural user terms 'REST APIs', 'GraphQL backends', 'microservices architectures', and 'Node.js servers' that a user would actually say when requesting this work.	3 / 3
Distinctiveness Conflict Risk	Scoped to Node.js backend services with Express/Fastify, a clear niche with distinct triggers unlikely to conflict with general or frontend skills.	3 / 3
	Total	12 / 12 Passed

Validation

93%

Warnings & errors only

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

Criteria	Description	Result
skill_md_line_count	SKILL.md is long (1021 lines); consider splitting into references/ and linking	Warning

	Total	15 / 16 Passed

Repository: Microck/ordinary-claude-skills
Path: skills_all/nodejs-backend-patterns/SKILL.md
Commit: 1056d29

Reviewed: ~1 month ago

Table of Contents

Discovery Implementation Validation

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.