CtrlK
BlogDocsLog inGet started
Tessl Logo

jbvc/nestjs-expert

Nest.js framework expert specializing in module architecture, dependency injection, middleware, guards, interceptors, testing with Jest/Supertest, TypeORM/Mongoose integration, and Passport.js authentication. Use PROACTIVELY for any Nest.js application issues including architecture decisions, testing strategies, performance optimization, or debugging complex dependency injection problems. If a specialized expert is a better fit, I will recommend switching and stop.

69

Quality

69%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Overview
Quality
Evals
Security
Files

Quality

Discovery

100%

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

This is a strong skill description that clearly identifies its domain (Nest.js), lists comprehensive specific capabilities, includes abundant natural trigger terms, and provides explicit guidance on when to use it. The main weakness is the use of first person ('I will recommend switching') in the last sentence, which violates the third-person voice guideline, though this is a minor issue in an otherwise excellent description.

DimensionReasoningScore

Specificity

Lists multiple specific concrete capabilities: module architecture, dependency injection, middleware, guards, interceptors, testing with Jest/Supertest, TypeORM/Mongoose integration, and Passport.js authentication. These are all concrete, identifiable actions/domains within Nest.js.

3 / 3

Completeness

Clearly answers both 'what' (Nest.js framework expertise across multiple specific areas) and 'when' ('Use PROACTIVELY for any Nest.js application issues including architecture decisions, testing strategies, performance optimization, or debugging complex dependency injection problems'). The explicit 'Use PROACTIVELY' clause serves as a clear trigger guidance.

3 / 3

Trigger Term Quality

Includes many natural keywords a user would mention: 'Nest.js', 'dependency injection', 'middleware', 'guards', 'interceptors', 'Jest', 'Supertest', 'TypeORM', 'Mongoose', 'Passport.js', 'authentication', 'architecture', 'testing', 'performance optimization', 'debugging'. These cover a wide range of terms users would naturally use.

3 / 3

Distinctiveness Conflict Risk

Clearly scoped to the Nest.js framework specifically, with distinct triggers like 'Nest.js', 'guards', 'interceptors', 'TypeORM/Mongoose integration', and 'Passport.js authentication'. Unlikely to conflict with generic Node.js or other framework skills due to the Nest.js-specific terminology.

3 / 3

Total

12

/

12

Passed

Implementation

27%

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

This skill is extremely comprehensive in breadth but suffers from severe verbosity and poor organization. It reads more like a NestJS encyclopedia than a focused skill file, with much content that Claude already knows or could infer. The monolithic structure wastes context window tokens and buries actionable guidance under layers of catalogued information that would be better served by progressive disclosure into separate files.

Suggestions

Reduce content by 60-70%: Remove domain coverage descriptions that restate NestJS docs, trim the 17 problem approaches to the top 5 with actual code solutions, and eliminate sections like External Resources and Success Metrics that add little unique value.

Split into multiple files: Move problem-specific approaches to PROBLEMS.md, decision trees to ARCHITECTURE.md, code review checklist to CHECKLIST.md, and reference them with one-line links from the main skill file.

Make problem solutions more actionable: For each common issue, provide a complete before/after code example rather than abstract numbered steps like 'Fix configuration' or 'Handle async properly'.

Remove explanations of concepts Claude already knows: The Domain Coverage section explaining what controllers, middleware, guards, and pipes are is unnecessary - focus only on project-specific patterns and non-obvious gotchas.

DimensionReasoningScore

Conciseness

Extremely verbose at 400+ lines. Explains many concepts Claude already knows (what middleware is, what guards do, basic module patterns). The 'Domain Coverage' section is largely a restatement of NestJS documentation table of contents. The 17 problem-specific approaches, decision trees, performance optimization, external resources, and success metrics sections add massive token cost with limited unique value. Much of this could be condensed to 1/4 the size.

1 / 3

Actionability

Contains some executable code examples (module pattern, testing pattern, custom decorator), but many sections are lists of vague guidance ('Fix configuration', 'Handle async properly') rather than concrete executable steps. The problem-specific approaches provide numbered steps but most are abstract instructions rather than copy-paste solutions with actual code.

2 / 3

Workflow Clarity

The validation order (typecheck → unit → integration → e2e) is clearly stated and repeated, which is good. However, the detection phase and adaptation strategies lack explicit validation checkpoints. The problem-specific approaches list steps but don't include verification/validation between steps. The step 0 delegation pattern is clear.

2 / 3

Progressive Disclosure

This is a monolithic wall of text with no references to external files. All content is inline in a single massive document. The decision trees, 17 problem approaches, code review checklists, performance optimization, and external resources could all be split into separate referenced files. There is no layered structure - everything is dumped at the same level.

1 / 3

Total

6

/

12

Passed

Validation

81%

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

Validation9 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (552 lines); consider splitting into references/ and linking

Warning

frontmatter_unknown_keys

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

Warning

Total

9

/

11

Passed

Reviewed

Table of Contents