CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

nodejs-backend

Node.js backend patterns with Express/Fastify, repositories

59

Quality

74%

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

Quality

Content

76%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 content is a strong, highly actionable pattern catalog: complete executable TypeScript examples cover each architectural concern with essentially zero padding. Its main gaps are the absence of a sequenced workflow for applying the patterns together and no validation checkpoints, plus an anti-patterns list that largely restates what Claude already knows.

Suggestions

Add a short 'Adding a new feature' workflow that sequences the patterns (define domain types -> service function -> repository method -> route + Zod schema -> unit and integration test) so the catalog becomes an applicable process.

Trim or remove the generic anti-patterns list (callback hell, secrets in code, SQL concatenation) since Claude already knows these, keeping only project-specific conventions.

DimensionReasoningScore

Conciseness

The body is code-first with almost no prose ('Project Structure', 'API Design', 'Database Patterns' sections are pure executable examples), matching 'Efficient; minor instances of over-explanation'. It is not 5 because the anti-patterns list ('Callback hell - use async/await', 'Secrets in code - use environment variables') restates knowledge Claude already has, and the empty top-level section after the title wastes tokens.

4 / 5

Actionability

Every section contains complete, copy-paste-ready TypeScript covering route handlers with Zod validation, dependency injection at the composition root, domain errors with a global error handler, Kysely repositories and transactions, validated config, and unit/integration tests, matching 'Fully executable; copy-paste ready code... specific examples cover the common cases'.

5 / 5

Workflow Clarity

The body is a topical pattern catalog with clear sections but no sequenced process for applying the patterns together (e.g., add service function -> add repository method -> add route -> add test) and no validation checkpoints, matching 'Steps listed but validation gaps; sequence present but checkpoints missing or implicit'. It is not 4 because there is no explicit order of operations at all, only parallel examples.

3 / 5

Progressive Disclosure

No bundle files exist and the single-file body is organized into clear, navigable sections (Project Structure, API Design, Error Handling, Database Patterns, Configuration, Testing, Anti-Patterns) with no dangling references, matching 'Good structure; most content is appropriately placed'. It is not 5 because ~290 lines of full code examples (e.g., complete test files, transaction examples) are all inlined and could be split into reference files to keep SKILL.md a leaner overview.

4 / 5

Total

16

/

20

Passed

Description

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

The description names a distinct technical niche with concrete framework keywords, but it lists no actions or capabilities and provides no 'when to use' trigger guidance, leaving it incomplete and less activating than it could be. It reads as a topic label rather than a capability-plus-trigger statement.

Suggestions

Add an explicit 'Use when...' clause with concrete triggers, e.g., 'Use when working on Node.js backend code, API routes, middleware, or server setup' (the when-to-use frontmatter content already exists and could be folded into the description).

State concrete actions instead of the generic word 'patterns', e.g., 'Structure Express/Fastify backends with repository-based data access, validated config, and centralized error handling'.

Add natural trigger terms users would say such as 'API routes', 'REST', 'middleware', and 'server setup' to improve trigger-term coverage.

DimensionReasoningScore

Specificity

Names the domain ('Node.js backend patterns') plus concrete specifics ('Express/Fastify', 'repositories'), comparable to 'Names domain and 1-2 concrete actions'. It falls below anchor 4 because no actual actions or capabilities (e.g., 'build API routes', 'structure repositories') are stated, and above anchor 2 because it is more concrete than 'Processes PDF files'.

3 / 5

Completeness

A clear 'what' is present ('Node.js backend patterns with Express/Fastify, repositories') but 'when to use it' is entirely missing from the description, matching anchor 3 and capped there by the missing 'Use when...' guideline. It is not 4 since no trigger guidance exists even weakly in the description itself.

3 / 5

Trigger Term Quality

Includes natural terms users would say ('Node.js', 'backend', 'Express', 'Fastify', 'repositories'), matching 'Good keyword coverage; a few natural terms missing'. Not 5 because common phrasings like 'API', 'REST', 'routes', or 'server' are absent; not 3 because the framework names go beyond generic keywords.

4 / 5

Distinctiveness Conflict Risk

The Node.js-backend/Express/Fastify niche is mostly distinct with only minor overlap risk against sibling backend skills (e.g., a generic TypeScript or database skill), matching anchor 4. Not 5 because 'backend patterns' without explicit trigger phrases leaves some ambiguity versus other server-side skills.

4 / 5

Total

14

/

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

alinaqi/maggy

Path

skills/nodejs-backend/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.