reversa-quality

Audit requirements.md for clarity, completeness, and consistency, then write a structured audit file.

Updated Nov 4, 2025
One-click install
npx skills add https://github.com/Markson22/MKV-SYTEM --skill reversa-quality-markson22
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: reversa-quality
Source: https://github.com/Markson22/MKV-SYTEM/tree/main/.agents/skills/reversa-quality
Command: npx skills add https://github.com/Markson22/MKV-SYTEM --skill reversa-quality-markson22

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Checks the textual quality of requirements.md for a feature to ensure clarity and coherence before planning, avoiding rework.

Core Features & Use Cases

  • Text quality audit: evaluates clarity, completeness, and consistency of requirements to support reliable planning and implementation.
  • Guided review: follows the project's standard audit workflow, referencing .reversa state and templates.
  • Use Case: When a feature's requirements.md is ready for review, run this skill to generate a structured audit report detailing issues and suggested improvements.

Quick Start

Run the audit on the active feature's requirements.md to produce a comprehensive quality report.

Frequently Asked Questions about reversa-quality

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

FAQPage Schema
How do I audit the writing quality of requirements before planning a feature?

Auditing requirements writing quality involves evaluating the feature's requirements.md file for clarity, completeness, and consistency. The process produces a formatted audit file detailing issues and suggested improvements, indicating whether requirements are approved, need clarifications, or require rework.

What is a requirements consistency audit and when do I need to run it?

A requirements consistency audit checks the textual coherence and completeness of your requirements.md file against project principles. You need to run it when a feature's requirements are ready for review, ensuring reliable planning and avoiding rework before implementation begins.

How do I check if my requirements.md file meets clarity and completeness standards?

Checking requirements.md clarity and completeness standards requires applying a forward-quality process across the document. This generates a structured audit report with categories for clarity, completeness, consistency, and alignment, returning a rewritten formatted audit file for your feature directory.

Can I generate a structured review report for feature requirements without external dependencies?

Yes, you can generate a structured review report for feature requirements without external dependencies. The skill operates independently, referencing the project's .reversa state and templates to evaluate text quality and output an audit file at feature-dir/audit/requirements-audit.md.

What is the best way to format a requirements review to indicate approval or rework status?

The best way to format a requirements review is to apply a standard forward-quality process that outputs a rewritten audit file. This structured report explicitly indicates whether the requirements are approved, require clarifications, or need rework, streamlining the planning phase.

Why does my requirements review fail to catch inconsistencies before implementation?

Requirements reviews fail to catch inconsistencies when they lack a structured audit process evaluating alignment with principles. Applying a standardized quality audit to requirements.md identifies coherence and clarity issues early, producing a detailed report to prevent implementation rework.