# Test Readability And Clarity Check Approach > Use when working with the Test Readability and Clarity Check is a dual-agent validation approach that assesses whether a test suite effectively documents system behavior by reconstructing system understanding purely fro... - Skill: `tomevault-io/test-readability-and-clarity-check-approach` (Agent Skill, multi-file: 2 files) - Install (CLI): `npx skillmds@latest add tomevault-io/test-readability-and-clarity-check-approach` - Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/test-readability-and-clarity-check-approach/raw - Safety review: pending (external: skill-scanner PASS, skillspector PASS) - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: AI & ML - Author: tomevault-io (https://skillmd.com/u/tomevault-io) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/tomevault-io/test-readability-and-clarity-check-approach --- # Test Readability and Clarity Check Approach The Test Readability and Clarity Check is a dual-agent validation approach that assesses whether a test suite effectively documents system behavior by reconstructing system understanding purely fro... ## Instructions The Test Readability and Clarity Check is a dual-agent validation approach that assesses whether a test suite effectively documents system behavior by reconstructing system understanding purely from test code. This approach validates that tests serve as executable specifications and identifies gaps in architectural context documentation. **Key Insight: ** Tests that allow accurate system reconstruction without external documentation prove their quality as living specification documents. --- ## Principles 1. Test-as-Documentation 2. Separation of Concerns 3. Dual Perspective 4. Measurable Outcomes 5. Actionable Feedback ## When to Use - Major test suite refactoring completed (validate improvement) - New team members onboarding (generate system overview) - Architecture documentation audit needed (find alignment gaps) - Quality gate before major release (comprehensive validation) - Quarterly quality reviews (track test suite evolution) --- > Converted and distributed by [TomeVault](https://tomevault.io/claim/sddevelopment-be) — claim your Tome and manage your conversions.