documentation-claim-review

Verify documentation claims against repository evidence and report claim-by-claim findings.

Updated Jun 15, 2026
One-click install
npx skills add https://github.com/ravenslight2010/Production-run-calculator --skill documentation-claim-review-ravenslight2010
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: documentation-claim-review
Source: https://github.com/ravenslight2010/Production-run-calculator/tree/main/.agents/skills/documentation-claim-review
Command: npx skills add https://github.com/ravenslight2010/Production-run-calculator --skill documentation-claim-review-ravenslight2010

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Public-facing documentation such as READMEs, release notes, and setup guides often contains stale, overstated, or unsupported claims. This Skill fact-checks each claim against designated repository evidence so teams can publish accurate docs without silently rewriting unsupported statements. ## Core Features & Use Cases - Atomic Claim Splitting: Breaks compound prose into individual claims and classifies them by type (behavior, compatibility, performance, security, release status, and more). - Evidence-Ranked Verification: Applies a strict evidence hierarchy from revision-bound runtime proof down to comments, rejecting stale, development-only, or overly narrow evidence. - Labeled Findings Report: Assigns each claim a label (verified, partially verified, unsupported, stale-suspected, contradicted, needs-human) with confidence levels and next-step evidence requirements. - Use Case: Before a release, ask the Skill to verify that the release notes match the actual implementation; it returns a claim-by-claim assessment with publication blockers and evidence gaps instead of guessing. ## Quick Start Ask the assistant to fact-check the README's claims about supported platforms against the current repository implementation and report any unsupported statements.

Frequently Asked Questions about documentation-claim-review

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

FAQPage Schema
How do I fact-check README claims against my codebase?

Provide the exact document or section and the repository revision it describes. The Skill splits the text into atomic claims, checks each against ranked evidence sources, and reports verified, unsupported, or contradicted findings with confidence levels.

How to verify release notes match the actual implementation?

Point the Skill at the release notes and the corresponding revision. It prefers revision-bound runtime or release evidence over development artifacts, and flags claims proven only by development screenshots or tests as unsupported or needs-human.

What counts as valid evidence for a documentation claim?

Evidence is ranked from revision-bound runtime or release proof, to focused automated tests, implementation and configuration, manifests and schemas, then comments and historical reports. Stale, unrelated, or development-only evidence is rejected.

Can the Skill rewrite unsupported documentation claims automatically?

No. It performs the factual assessment first and does not silently rewrite claims. Editing requires separate user authorization, after which wording changes are routed through the writing-quality-editor skill while preserving quotations and identifiers.

What happens when evidence for a claim is unavailable?

The review continues with bounded scope and the claim is labeled needs-human or marked with an evidence gap. The report states exactly what evidence would be required to resolve the claim rather than inventing support.