principle-prove-it-works

Validates completed tasks by directly inspecting real artifacts instead of proxies or self-reports.

1|Updated Aug 26, 2026
One-click install
npx skills add https://github.com/edivad1999/stuc-stack --skill principle-prove-it-works-edivad1999
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: principle-prove-it-works
Source: https://github.com/edivad1999/stuc-stack/tree/main/skills/principle-prove-it-works
Command: npx skills add https://github.com/edivad1999/stuc-stack --skill principle-prove-it-works-edivad1999

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Work declared done without direct verification has unknown correctness. This Skill prevents agents and developers from relying on proxies like file mtimes, cached screenshots, compile success, or delegate self-reports, enforcing direct observation of the real artifact before claiming completion. ## Core Features & Use Cases - Direct Verification Principle: After any task, check the real thing—run the feature, read the actual value, inspect the git diff—rather than inferring from indirect signals. - Android UI Verification Path: Routes Android UI and device checks through the android-verify skill (Gradle assemble, then android describe / run / layout / screen), with the P18 rule against claiming coverage that was not run. - Delegation Auditing: When verifying delegated work, inspect actual output artifacts (diffs, file contents, runtime behavior) instead of trusting the delegate's summary. - Scripted Proof: Encourages writing a deterministic re-runnable comparison script whose output serves as a reviewable artifact, committed only for large migrations or ports. ## Quick Start Apply the prove-it-works principle to verify the task just completed by running the actual feature and inspecting the real output before declaring it done.

Frequently Asked Questions about principle-prove-it-works

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

FAQPage Schema
How do I verify a coding task is actually done?▼

Verify by checking the real artifact directly: build the code, run it, and exercise the actual feature path end-to-end. Do not rely on compile success, file timestamps, or self-reports as proof of correctness.

How to verify Android UI changes on a device?▼

Use the android-verify skill: run a Gradle assemble, then use the android CLI commands describe, run, layout, and screen to observe the real UI. Never claim test coverage you did not actually execute.

Why is 'it compiles' not enough to declare a task done?▼

Compilation only proves syntax and type correctness, not runtime behavior. Data may fail to flow from input to output, integrations may break, and features may not work despite a successful build.

How do I verify work delegated to another agent?▼

Inspect the actual output artifact such as the git diff, file contents, or runtime behavior rather than the delegate's summary. Agents report what they intended to do, not always what actually happened.

When should verification scripts be committed to the repository?▼

Commit verification artifacts only for large or complex work where an auditable trail is needed later, such as a big port or migration. Most work only needs the artifact visible for the reviewer, not committed.