hs:contract-test

Validate live API and CLI contracts by running real probes and anchoring results as manual evidence.

Updated Jul 19, 2026
One-click install
npx skills add https://github.com/Dozyboy/VSF --skill hs-contract-test-dozyboy
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: hs:contract-test
Source: https://github.com/Dozyboy/VSF/tree/main/Day2_VSF/Demo1/harness/plugins/hs/disabled-skills/contract-test
Command: npx skills add https://github.com/Dozyboy/VSF --skill hs-contract-test-dozyboy

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? After building an endpoint or command, you need proof that its contract actually holds against the live target, not just a claim in a plan. This Skill runs a real probe against the API or CLI, checks status codes, exit codes, and payloads, and records the outcome as anchored manual evidence the DoD gate can re-read. ## Core Features & Use Cases - API Probe: Call a real HTTP endpoint and assert its contract via status code and payload fields. - CLI Probe: Run a target command and assert its contract via exit code and stdout/stderr pattern. - Anchored Evidence: Write each probe result as a manual check with evidence_tier: anchored and an anchor_id, reusing the existing manual-test admissibility tier. - Safety Model: Probes are never gate-driven, run only on deliberate invocation, and require human/agent review before any command hits the shell. - Use Case: After shipping a new REST endpoint, invoke the API probe to confirm it returns the expected status and payload fields, then anchor the passing result so the DoD gate accepts it as verified evidence. ## Quick Start Ask the agent to run a contract-test API probe against your new endpoint and anchor the passing result as manual evidence.

Frequently Asked Questions about hs:contract-test

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

FAQPage Schema
How do I validate an API contract after building an endpoint?▼

Run the API probe: build a reviewed HTTP request with method, URL, headers, and body, execute it with curl or httpx, then assert the expected status code and payload fields. Record the outcome as a manual check with evidence_tier anchored.

How do I test a CLI command's exit code and output?▼

Use the CLI probe to run the target command, capture its exit code and stdout/stderr, and assert the expected exit code and output pattern. The command must be reviewed before it runs, exactly like any Bash tool call.

Can contract probes run automatically in a CI gate?▼

No. Probes are never gate-driven and never appear in any stage-policy requires list. A gate that executes target code would turn every push into an RCE trigger, so probes run only on deliberate invocation.

Does the contract-test skill support browser or database testing?▼

Browser and DB probes are catalog stubs deferred to v2 because they need heavy dependencies like Playwright, xvfb, and live credentials. Version 1 ships only the API and CLI probes.

How are probe results recorded as evidence?▼

Each result is written as the manual check that hs:manual-test defines, carrying an anchor_id and evidence_tier anchored. Write it via write_verification.py with the --from flag, since flag-builder mode has no anchor fields.