CtrlK
BlogDocsLog inGet started
Tessl Logo

tessl-labs/api-testing-first-steps

Get test coverage on an Express/Node API fast — the first 5 tests that catch

94

1.26x
Quality

90%

Does it follow best practices?

Impact

100%

1.26x

Average score across 5 eval scenarios

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 an excellent skill description that hits all the marks. It provides specific concrete actions (testing routes, database operations, validation), uses natural trigger terms developers would actually say, includes comprehensive 'Use when...' guidance with multiple realistic scenarios, and carves out a distinct niche around Express/Node API testing with specific tools.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: 'testing routes, database operations, and validation with Vitest and supertest', 'PATCH/status routes, query parameter filtering, error format consistency'. Names specific tools and patterns.

3 / 3

Completeness

Clearly answers both what ('testing routes, database operations, and validation with Vitest and supertest') AND when with explicit 'Use when...' clause covering multiple scenarios: 'zero tests', 'adding routes', 'code reviewer says where are the tests', 'Express app without __tests__'.

3 / 3

Trigger Term Quality

Excellent coverage of natural terms users would say: 'Express', 'Node API', 'tests', 'Vitest', 'supertest', 'routes', '__tests__', '*.test.ts', 'test coverage', 'code reviewer'. These match how developers naturally discuss testing needs.

3 / 3

Distinctiveness Conflict Risk

Highly distinctive with clear niche: Express/Node API testing specifically with Vitest and supertest. The combination of framework (Express), testing tools (Vitest, supertest), and specific use cases (PATCH routes, query filtering) makes it unlikely to conflict with general testing or other framework skills.

3 / 3

Total

12

/

12

Passed

Implementation

77%

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

This is a strong, highly actionable skill with excellent executable examples and clear workflow guidance. The 5-test discipline is a memorable, practical framework. Main weaknesses are verbosity in explanatory sections and a monolithic structure that could benefit from splitting advanced patterns into separate files.

Suggestions

Trim explanatory prose — remove phrases like 'Not test philosophy' and 'These are common mistakes. Follow them strictly' that don't add actionable value

Consider moving 'Patterns for Expanding Coverage' and 'Adding Tests to an Existing Project' to separate linked files to improve progressive disclosure

DimensionReasoningScore

Conciseness

The skill is mostly efficient with good code examples, but includes some unnecessary explanation (e.g., 'Not test philosophy — the specific tests' preamble, extended rationale sections). The 'What NOT to Test' section and strategy documentation guidance add bulk that could be trimmed.

2 / 3

Actionability

Excellent actionability with fully executable code examples throughout — complete Vitest config, package.json scripts, server setup, and all 5 test implementations are copy-paste ready. The PATCH and query filter patterns are equally concrete.

3 / 3

Workflow Clarity

Clear sequencing with explicit validation checkpoints: setup steps are numbered, the 5-test discipline provides a clear sequence, database isolation options are well-structured, and the checklist at the end serves as a verification step. The 'create resource first, then use ID' pattern is an explicit feedback loop.

3 / 3

Progressive Disclosure

Content is well-organized with clear sections, but it's a monolithic document that could benefit from splitting. The 'Expanding Coverage' and 'Adding Tests to Existing Project' sections could be separate files. References to verifiers at the end are good but the main content is dense.

2 / 3

Total

10

/

12

Passed

Validation

90%

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

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

10

/

11

Passed

Reviewed

Table of Contents