test-quality

Generate spec-driven tests from documentation, designs, and contracts.

7|4|Updated Mar 2, 2026
One-click install
npx skills add https://github.com/nklisch/skills --skill test-quality-nklisch
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: test-quality
Source: https://github.com/nklisch/skills/tree/main/plugins/workflow/skills/test-quality
Command: npx skills add https://github.com/nklisch/skills --skill test-quality-nklisch

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Many projects rely on tests written from existing implementation code, which leads to tautological testing that fails to catch real bugs. This Skill addresses the lack of spec‑driven test coverage, helping teams discover gaps, edge cases, and contract violations.

Core Features & Use Cases

  • Contract discovery: Scans documentation, design files, and interface definitions to extract behavioral specifications.
  • Gap analysis: Compares existing test suites against extracted contracts to identify untested scenarios.
  • Spec‑driven test generation: Creates new tests that directly reference spec conditions, prioritizing invalid inputs, boundary values, and error paths.
  • Workflow orchestration: Uses task tools to track progress, create subtasks, and ensure systematic coverage.

Quick Start

Run the test-quality skill on a target module to generate missing spec‑driven tests.

Frequently Asked Questions about test-quality

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate spec-driven tests from design documents instead of implementation code?

To generate spec-driven tests, the skill scans documentation, design files, and interface definitions to extract behavioral contracts. It then creates new test cases referencing these specifications, prioritizing invalid inputs, boundary values, and error paths to avoid tautological testing.

Why does my test suite fail to catch real bugs in my codebase?

Your test suite likely fails because tests were written from existing implementation code, leading to tautological testing. Spec-driven test generation solves this by deriving tests from behavioral specifications and design contracts, actively uncovering coverage gaps and edge cases.

What is the best way to find coverage gaps in existing tests against design specifications?

The best way to find coverage gaps is through contract discovery and gap analysis. The skill compares your existing test suites against extracted behavioral specifications from documentation to systematically identify untested scenarios and contract violations.

Can I analyze interface definitions to generate tests for edge cases and error paths?

Yes, you can analyze interface definitions to generate tests for edge cases. The skill locates contracts using glob and grep tools, then applies spec-driven test generation to prioritize boundary values, invalid inputs, and error paths.

Do I need existing test suites to use spec-driven test generation for coverage analysis?

No, you do not need existing test suites. The skill is designed for codebases where behavior is described in documentation, applying contract discovery to generate new tests and analyze coverage gaps independently of existing tests.

Does spec-driven test generation work with documentation files to track testing progress?

Yes, spec-driven test generation works with documentation files. It leverages task tools to orchestrate the testing workflow, creating subtasks and tracking progress to ensure systematic coverage of extracted behavioral specifications.