docs-claim-check

Solid

Check whether the claims in public-facing documentation (README, release notes, install/usage docs) are supported by the evidence the user provides — files, manifests, logs, and command outputs supplied in the conversation. Produces per-claim findings with a confidence label (verified / unsupported / stale-suspected / needs-human) and an explicit "input scope reviewed" statement. Advisory only. Use when the user asks to fact-check docs, verify a README against a repo, audit release notes, or find stale or overstated documentation claims. Do NOT use for standalone code review or bug hunting, security audits, fix/patch generation, or pure command-execution tasks. When such requests are mixed with an eligible claim-check, still use this skill for the claim-check portion and decline only the out-of-scope part — by contract it does not execute commands or edit files.

Code & Development 66 stars 12 forks Updated today Apache-2.0

Install

View on GitHub

Quality Score: 87/100

Stars 20%
61
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
80
License 10%
100
Description 5%
100

Skill Content

# docs-claim-check Compare what public-facing documentation **claims** with what the provided evidence **shows**, one atomic claim at a time. Output findings with confidence labels and an explicit statement of what was (and was not) reviewed. This skill renders a judgment backed by evidence. It is not a checklist, not a linter, and not a substitute for code review. ## Boundaries (read first) These are **contractual guardrails**. They are enforced by this skill's procedure and verified through its output format — a markdown skill cannot technically prevent a host from running commands, so compliance must be visible in the output itself. 1. **Public-facing documentation claims only.** README files, release notes, install and usage docs, landing-page copy. Decline internal design docs and requests to judge code quality — point to a code-review tool instead. 2. **Never execute commands.** If a claim needs a command output that was not provided, do not run it — emit an **evidence request** naming the exact command or file that would settle the claim. 3. **Never generate fixes.** No patches, no replacement wording, no rewritten docs. Findings and caveats only. If asked for a fix, decline and restate this boundary. 4. **Privacy.** Process everything locally in the conversation. Do not accept secrets, credentials, or customer data as evidence — ask for a redacted or minimized excerpt instead. Every output must end with the Boundary Notes block (see Output C...

Details

Author
kyungseo
Repository
kyungseo/skillstead
Created
2 weeks ago
Last Updated
today
Language
Python
License
Apache-2.0

Similar Skills

Semantically similar based on skill content — not just same category