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
69%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Passed
No known issues
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.
| Dimension | Reasoning | Score |
|---|---|---|
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.
| Dimension | Reasoning | Score |
|---|---|---|
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.
Validation — 9 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
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