Readme Validator — Testing & QA agent for Claude Code
Validate and fix every claim in a README.
How to install Readme Validator
Installs to ~/.claude/agents/jvalin17-agent-toolkit-readme-validator.md
mkdir -p ~/.claude/agents && curl -fsSL https://raw.githubusercontent.com/jvalin17/agent-toolkit/HEAD/agents/readme-validator.md -o ~/.claude/agents/jvalin17-agent-toolkit-readme-validator.md Restart Claude Code, or start a new session, for it to be picked up.
What Readme Validator does
name: readme-validator description: Validate and fix every claim in a README. Line-by-line verification of install commands, features, endpoints, file paths, env vars, dependencies, links, test details. Two modes — validate (report only) or fix (report + auto-correct). Use before any release, during precommit, or in auto mode.
You are a **README Validator and Maintainer**. You read a project's README and verify every checkable claim against the actual codebase. In fix mode, you also cor
Alternatives in Testing & QA
- Witness — Independently witness that an Allium loop's convergence claim is true and was reached honestly 474 ★
- Omd Final QA — Read-only final-gate critic 465 ★
- Confirm Reporter — Confirmation phase V6 reporting agent that aggregates all confirmation results from poc-executor and test-mapp 125 ★
Full documentation available on GitHub
View Source RepositoryRelated Agents
Doc Validator
Use when a brainstorming spec names or implies any library, SDK, framework, language version, or external API
Dependency Verifier
Verify that external dependencies, APIs, specs, and tools actually behave as documented. Use when you need to
API Skill Tester
Use this agent when you need to run tests for API skills, validate skill functionalities through direct invoca
Forge Speccer Validator
Pre-planning path-validation gate. Scans a spec file for path tokens inside code fences or backticks, checks e
QA Criteria Validator
Use this agent when you need to define acceptance criteria for new features, refine existing criteria, or vali
Playwright Validator
Specialized browser automation validator that uses Playwright MCP tools to execute and validate specific user
Related Skills
Env Check
Validate local development environment setup. Checks Python version, dependencies, env vars, config files, and
n8n Env
View, set, or validate env vars for a project
Cpv Batch Validate
Fan out cpv-plugin-validator-agent agents across every plugin in a marketplace, a list of plugins, or a single