skills/test-discovery/SKILL.md

---
name: test-discovery
description: "Walk a cloned repository, identify test files by framework and language, and report what was found in either a machine-readable JSON manifest or a human-readable Markdown report. Use when a repository has been cloned locally and you need to know what tests exist, what framework runs them, and what command executes them. The JSON output is consumed by programs (the testworkflow-author skill, cloud-api ingestion, CI); the Markdown output is meant for a person to read and opens cleanly in any plain-text editor. This skill does NOT execute tests, install dependencies, or write any TestWorkflow YAML — it observes and reports."
---

# test-discovery

Walk a cloned repository at the given path, identify the tests inside, and emit a structured JSON manifest describing
what was found. Output goes to stdout as a single JSON document. The consumer is typically the `testworkflow-author`
skill or the Testkube cloud-api discovery ingestion.

Scope:
- Read-only walk of the local filesystem
- Detect language and framework from marker files (config, manifest, lock files) and content signals
- Group findings into suites; a suite is one framework + one working directory
- Attach evidence + confidence to every suite
- Report ambiguity via `status: needs_input`; report failures via `status: error`

Out of scope: running tests, installing dependencies, writing TestWorkflow YAML, cloning repos, calling network APIs.