needs-tests

Generates executable tests from spec.adoc verification descriptions within a feature package.

Updated Feb 19, 2026
One-click install
npx skills add https://github.com/provenimpact/proven-needs --skill needs-tests
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: needs-tests
Source: https://github.com/provenimpact/proven-needs/tree/main/skills/needs-tests
Command: npx skills add https://github.com/provenimpact/proven-needs --skill needs-tests

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Derive and generate executable tests from feature specifications to guarantee test coverage before implementation.

Core Features & Use Cases

  • Translates the verification descriptions in spec.adoc into concrete tests that fit the project's existing test framework.
  • Operates within a single feature package at docs/features/<slug>/ to scope test generation to the relevant feature.
  • Reports spec coverage gaps and guides incremental test generation as specs evolve.

Quick Start

Run the test-generation workflow for the current feature package using the orchestrator.

Frequently Asked Questions about needs-tests

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

FAQPage Schema
How do I generate executable tests directly from feature specifications?

To generate tests from feature specifications, this Skill translates verification descriptions in spec.adoc files into concrete test cases using the project's existing test framework. It scopes generation to a single feature package at docs/features/<slug>/ to ensure 100% spec coverage before implementation begins.

What is the best way to ensure 100% test coverage before writing implementation code?

Ensuring 100% test coverage before implementation involves deriving executable test cases from feature spec descriptions. This approach translates spec.adoc verification criteria into tests, proactively reporting any coverage gaps to the orchestrator for remediation so gaps are caught early.

Can I use this test generation workflow with my project's existing test framework?

Yes, you can use your existing test framework. The generation process detects and adapts to the project's current testing setup, translating the spec.adoc verification descriptions into concrete test cases that fit natively within your established quality-assurance environment.

How do I report and fix spec coverage gaps during test generation?

To report and fix spec coverage gaps, the test generation process analyzes the spec.adoc files and identifies missing verification descriptions. It then reports these gaps back to the proven-needs orchestrator for remediation, guiding incremental test generation as the feature specifications evolve.

Does this approach work for generating tests within a single feature package scope?

Yes, this approach works by operating exclusively within a single feature package located at docs/features/<slug>/. This scoping ensures that test generation is strictly isolated to the relevant feature, translating only that specific spec.adoc into executable tests without affecting unrelated project areas.

When should I not use automated test generation from feature specs?

You should not use automated test generation from feature specs if your project lacks structured spec.adoc files or a defined feature package directory. The process relies entirely on translating existing verification descriptions within docs/features/<slug>/ into concrete tests.