CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

nestjs-patterns

NestJS architecture patterns for modules, controllers, providers, DTO validation, guards, interceptors, config, and production-grade TypeScript backends. Use when building or reviewing a NestJS backend — modules, providers, DTO validation, guards, or interceptors.

Quality

84%

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

SKILL.md
Quality
Evals
Security

Quality

Content

75%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 well-organized, pattern-reference skill body: every section pairs executable NestJS code with terse opinionated guidance and avoids re-teaching framework basics. Its main limitations are minor — a few undefined helper types keep code from being fully copy-paste ready, the 'When to Activate' section duplicates the description, and the single-file layout is slightly long for its content. No multi-step validation loop is needed given the reference nature of the skill.

Suggestions

Trim the 'When to Activate' section or replace it with a pointer to the description's triggers, since it currently duplicates the frontmatter wording almost verbatim.

Define or link the helper symbols used in snippets (UsersRepository, AuthenticatedRequest, validateEnv, configuration) so code blocks are fully copy-paste ready.

Consider moving the testing harness and production-defaults sections into one-level-deep reference files (e.g., references/testing.md) to keep SKILL.md as a lean overview.

DimensionReasoningScore

Conciseness

The body is code-first with terse, high-value bullets ('Controllers should stay thin: parse HTTP input, call a provider, return response DTOs') and no explanation of concepts Claude already knows. It is not a 5 because the 'When to Activate' section largely repeats the frontmatter trigger list and the full project tree overlaps with the structure bullets beneath it. It is well above anchor 3 since nearly every token carries non-obvious guidance.

4 / 5

Actionability

Concrete, idiomatic code throughout — the bootstrap with ValidationPipe whitelist/forbidNonWhitelisted options, a full module/controller/service trio, a working HttpExceptionFilter implementation, and ConfigModule.forRoot({ validate: validateEnv }). It falls short of anchor 5's 'copy-paste ready' bar because several snippets depend on referenced-but-undefined helpers (UsersRepository, AuthenticatedRequest, validateEnv, configuration) that are never shown or linked.

4 / 5

Workflow Clarity

Sections progress logically from project structure and bootstrap through modules, DTOs, auth, errors, config, persistence, testing, and production defaults, with per-section guidance that is unambiguous per topic. It does not reach anchor 5 because there is no explicit build/verify feedback loop — the testing section shows harness setup but no example assertion or verify step. No destructive/batch operations are involved, so the workflow cap at 3 does not apply.

4 / 5

Progressive Disclosure

The skill has no bundle files and all ~230 lines live in SKILL.md with clean, scannable section headers, each topic self-contained. Structure matches anchor 4 ('good structure; most content appropriately placed') rather than 5, because at this length some material (the exception filter, testing harness, production defaults) could be offloaded to one-level-deep reference files; it is above anchor 3 since nothing is buried or clearly misplaced.

4 / 5

Total

16

/

20

Passed

Description

87%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: it names a specific framework niche, enumerates concrete capability areas, and includes an explicit 'Use when...' clause with natural trigger terms. The only weakness is that capabilities are listed as topics rather than action verbs, and a couple of domain topics (testing, exception filters) are missing from the capability list.

DimensionReasoningScore

Specificity

Lists many specific capability areas — 'modules, controllers, providers, DTO validation, guards, interceptors, config, and production-grade TypeScript backends' — but they are named as topics rather than concrete action verbs, leaving minor coverage gaps (e.g., testing and exception filters are absent from the description). This sits above anchor 3 (only 1-2 actions) and below anchor 5 (comprehensive verb-driven actions).

4 / 5

Completeness

Explicitly answers both questions: 'NestJS architecture patterns for modules, controllers, providers...' (what) and 'Use when building or reviewing a NestJS backend — modules, providers, DTO validation, guards, or interceptors' (when, with concrete trigger phrases). This matches the anchor-5 example structure exactly; neither what nor when is weak or implied.

5 / 5

Trigger Term Quality

Natural terms users would say when building a backend — 'NestJS backend', 'modules', 'providers', 'DTO validation', 'guards', 'interceptors' — are present in the trigger clause. A few natural variations are missing (e.g., 'Nest.js', 'TypeScript server', 'exception filters', 'API'), so it does not reach anchor 5's synonym/extension-level coverage but clearly exceeds anchor 3.

4 / 5

Distinctiveness Conflict Risk

'NestJS' names a specific framework niche with distinct triggers, so the risk of firing for an unrelated skill is minimal — matching anchor 5. It is above anchor 4 because no closely competing skill domain (e.g., generic TypeScript or Express skills) is invoked by its phrasing.

5 / 5

Total

18

/

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

metadata_version

'metadata.version' is missing

Warning

Total

15

/

16

Passed

Repository

affaan-m/ECC

Path

skills/nestjs-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.