verify-run

Verifies autonomous implementation runs by detecting uncommitted work, unproven test suites, and scattered commits.

5|Updated Sep 9, 2017
One-click install
npx skills add https://github.com/hpcsc/dotfiles --skill verify-run-hpcsc
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: verify-run
Source: https://github.com/hpcsc/dotfiles/tree/main/link/common/claude/.claude/skills/verify-run
Command: npx skills add https://github.com/hpcsc/dotfiles --skill verify-run-hpcsc

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Autonomous implementation runs report tasks as done based on executed evidence, but a passing test is neither necessary nor sufficient proof that a feature works. Work can be left uncommitted, a suite can be green but broken, and tasks can be scattered across commits — failure modes the evidence gate cannot see. This Skill independently verifies what a run produced before you trust its result or open the PR. ## Core Features & Use Cases - Independent run verification: Spawns the read-only run-verifier agent against the run's worktree to return a structured verdict of { clean, findings, learnings_path }. - Severity-ranked findings: Distinguishes blocking findings (uncommitted-work, unproven-suite) from cosmetic warnings (scattered-task), each with the exact file, symbol, or commit and the fix. - Optional remediation with --fix: Commits uncommitted work using repo conventions, re-runs the suite and records a fresh receipt, or re-splits a collapsed commit, then re-verifies. - Use Case: After an unattended implement run reports all tasks closed, run verification on the same worktree to confirm the commits actually contain the work and the suite genuinely passes before opening the pull request. ## Quick Start Ask the assistant to verify the autonomous implementation run on the current worktree, optionally passing a branch name or --fix to remediate mechanical findings.

Frequently Asked Questions about verify-run

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

FAQPage Schema
How do I verify an autonomous implementation run before opening a PR?▼

Run the verify-run skill from the same worktree the run used. It spawns the run-verifier agent, which resolves the run's commits, executes its checks, and returns a structured verdict of clean status, findings, and a learnings path.

What failure modes does run verification catch?▼

It catches work left uncommitted, test suites reported green but not genuinely proven, and tasks scattered across multiple commits. Blocking findings like uncommitted-work and unproven-suite mean the run's done claim does not hold.

Does verify-run work with Go, JavaScript, and Elixir projects?▼

Yes, the skill is general across Go, JS/TS, and Elixir. The run-verifier agent carries the per-language recipes, so the same verification applies regardless of the repository's language.

When should I use the --fix flag with run verification?▼

Use --fix only when you want the skill to remediate mechanical findings itself, such as committing uncommitted work, re-running the suite for a fresh receipt, or re-splitting a collapsed commit. By default the skill is advisory only.

What are the limitations of automated run verification?▼

Repo-specific cross-boundary invariants that cannot execute locally, such as SNS-to-SQS filter wiring, do not belong in this verification. Those should be encoded as hermetic tests in the repository so they run in CI for everyone.