skills.rest
ab300819
ab300819COMMUNITY
Explore all skills by this author →
GitHub

test-run

Execute layered test suites and generate traceability-verified test reports.

Updated Jan 12, 2026
Search Tags:#unit tests#traceability#coverage#e2e testing#test execution#git diff#test report
One-click install
npx skills add https://github.com/ab300819/keel-workflow --skill test-run-ab300819
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: test-run
Source: https://github.com/ab300819/keel-workflow/tree/main/skills/test-run
Command: npx skills add https://github.com/ab300819/keel-workflow --skill test-run-ab300819

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Running tests across unit, integration, and E2E layers while manually verifying that every acceptance criterion is covered by passing tests is tedious and error-prone. This Skill automates test execution, result collection, and traceability validation, producing a structured test report. ## Core Features & Use Cases - Layered Test Execution: Runs UT, IT, and E2E suites in order, auto-detecting frameworks like Jest, Vitest, pytest, and Go test. - Traceability Verification (--trace): Maps test results back to acceptance criteria from the test-case documents, flagging uncovered ACs and orphan tests. - Affected-Test Selection (--affected): Uses git diff to identify changed files and runs only the tests associated with them. - Use Case: After a batch development run, invoke the skill with --trace to execute the full suite and generate docs/devdocs/05-test-report.md showing pass rates, coverage, and AC traceability status. ## Quick Start Ask the AI to run the full test suite with traceability verification and generate the test report.

Frequently Asked Questions about test-run

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

FAQPage Schema
How do I run only the tests affected by my code changes?▼

Use the --affected flag, which runs git diff against a base reference to identify changed files, then matches them to related test cases in the test-case and dev-task documents. If no matches are found, it suggests running the full suite instead.

How do I verify that every acceptance criterion has passing tests?▼

Run the skill with the --trace flag. It executes the full suite and validates the traceability matrix, marking each AC as covered, test-failed, or uncovered, and warns about documented test IDs with no matching real test case.

Which test frameworks are supported for automatic detection?▼

The skill detects Jest, Vitest, and Mocha via package.json, pytest via pyproject.toml or pytest.ini, and Go test via go.mod, with Makefile and Cargo conventions as fallbacks. If detection fails, it asks the user for the correct command.

What happens when all unit tests fail during a run?▼

When invoked directly by a user, the skill asks whether to continue with integration and E2E tests. When called by the dev-workflow skill, it continues executing all layers and collects complete results for the report.

Does the test run modify my traceability matrix or source documents?▼

No. Traceability verification is report-only; results are written to docs/devdocs/05-test-report.md. Updating the traceability matrix itself is handled separately by the sync skill.

Related Skills

Explore More Software Engineering Skills→
ArtemioPadillaArtemioPadilla
3

traceability

Generate a bi-directional traceability matrix linking acceptance criteria to code, tests, and reviews.

Community
Advanced
ab300819ab300819

devdocs-bugfix

Automate a test-first bug fixing workflow with regression tests and traceability.

Community
Advanced
VitorAndTxrVitorAndTxr

qa

Guide structured testing across planning, design, review, and execution phases.

Community
Advanced
ZTE-AICloudZTE-AICloud
52

e2e-specify

Generate test-analysis.md and e2e-test.md from specifications using MFQ&PPDCS and TCON.

Official
Advanced