empirical-validation

Validates completed work with empirical evidence before marking tasks done.

1|Updated Sep 3, 2026
One-click install
npx skills add https://github.com/amanpal3/SKILLs --skill empirical-validation-amanpal3
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: empirical-validation
Source: https://github.com/amanpal3/SKILLs/tree/main/.agent/plugins/gsd/.agents/skills/empirical-validation
Command: npx skills add https://github.com/amanpal3/SKILLs --skill empirical-validation-amanpal3

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? It prevents AI agents and developers from declaring tasks complete based on assumptions like "the code looks correct" by requiring concrete, observable proof for every change. ## Core Features & Use Cases - Validation by Change Type: Maps each change type (UI, API, build, data, file operations) to a required verification method and tool. - Structured Validation Protocol: Enforces a four-step process of identifying criteria, executing verification, documenting evidence, and confirming outcomes. - Failure Handling: Blocks task completion on failed verification, logs failures to .gsd/STATE.md, and triggers a context health monitor after repeated failures. - Use Case: After modifying a login API endpoint, run a curl request against it, capture the actual JSON response, and record it in .gsd/JOURNAL.md before marking the task done. ## Quick Start Ask the agent to verify the recent change with empirical evidence and record the actual output before marking the task complete.

Frequently Asked Questions about empirical-validation

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

FAQPage Schema
How do I verify a code change actually works before marking it done?▼

Identify what should be true after the change, run the appropriate command or action to observe it, capture the actual output, and confirm it matches the expected outcome. Record the evidence in the task journal rather than relying on code inspection.

How to validate UI changes made by an AI coding agent?▼

Use a browser subagent to navigate to the affected page and capture a screenshot showing the expected visual state. Confirm specific elements like headers, loaded data, and layout correctness instead of assuming the component renders properly.

What counts as valid evidence for task completion?▼

Valid evidence is actual captured output: API responses from curl commands, build success logs, screenshots of UI state, or query results showing expected data. Statements like "this should work" or "the code looks correct" are explicitly forbidden.

What happens when task verification fails?▼

The task is not marked complete, the failure is documented in the state file, and a fix task is created if the cause is known. After three or more failures, a context health monitor is triggered to reassess the approach.

When should empirical validation not block task completion?▼

It should always block completion when verification is possible; the protocol has no bypass for verifiable changes. It integrates with verification and execution workflows to ensure every completed task has documented evidence.