verify-claims

Convert claims about changes, findings, and test results into documented evidence with confidence levels.

1|Updated Jul 27, 2023
One-click install
npx skills add https://github.com/AlexTheGuitarGuy/.dotfiles --skill verify-claims-alextheguitarguy
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: verify-claims
Source: https://github.com/AlexTheGuitarGuy/.dotfiles/tree/main/claude/.claude/skills/verify-claims
Command: npx skills add https://github.com/AlexTheGuitarGuy/.dotfiles --skill verify-claims-alextheguitarguy

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Engineers and reviewers often assert that a change works, a diagnosis is correct, or a test passed without concrete proof, leading to unverified assumptions propagating through a project. This Skill structures every material claim into evidence, scope, and confidence so conclusions are grounded in observable facts. ## Core Features & Use Cases - Claim-to-Evidence Mapping: For each claim, capture the belief, the supporting path, command output, test result, or direct observation. - Scope and Confidence Tracking: Record what the evidence does and does not cover, plus a high, medium, or low confidence rating with reasoning. - Use Case: After fixing a bug, instead of stating "the fix works", document the exact test command run, its output, which code paths it exercised, and a confidence level so reviewers can judge the claim independently. ## Quick Start Ask the AI to verify the claim that your recent change fixes the reported bug and record the evidence, scope, and confidence for it.

Frequently Asked Questions about verify-claims

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

FAQPage Schema
How do I verify that a code change actually works?▼

Verify a code change by converting the claim into concrete evidence: run the relevant test or command, record its output, note which code paths it exercised, and assign a confidence level. A passing command only proves what it actually covered.

How to document evidence for a code review finding?▼

Document a review finding by capturing four elements: the claim itself, the evidence such as a file path or command output, the scope of what the evidence covers, and a confidence rating of high, medium, or low with the reason.

Does a passing test prove my fix is correct?▼

A passing test is not proof beyond what it exercised. It only validates the specific scenarios and code paths it ran, so you should record the scope of coverage and assign an appropriate confidence level rather than assuming full correctness.

When should I use claim verification in my workflow?▼

Use claim verification before asserting that a change, diagnosis, plan, or test result is correct. It is emitted as evidence for later work rather than acting as a blocking stage or prerequisite in your process.

What are the limitations of evidence-based claim verification?▼

Evidence-based verification is limited by the freshness and locality of evidence and by what the evidence actually covers. Stale or indirect observations lower confidence, and no single command output can prove claims outside its exercised scope.