analysis-quality-review

What problem does it solve?

This Skill provides a structured, read-only review protocol that ensures analytical documents (briefs, decks, memos, ADRs, wiki pages, and daily notes) adhere to a consistent quality standard. It orchestrates a ghost-deck workflow that validates one document at a time using a two-pass process (structure review and readability review), returning a detailed violation report and a path to canonical fix patterns for safe edits by the calling skill.

Core Features & Use Cases

• Two-mode orchestration: spec (template retrieval), spec-judge (validation of the filled-in spec), and review (two gating passes on the final document).
• Pre-flight artifact loading via artifact-loader to build a load_bearing_index.yaml for traceable, cross-document references.
• Fresh-context reviewer agents: argument-structure-reviewer and readability-reviewer that grade against framework-specific rubrics.
• Output artifacts: a violation report, a summary, and a reference to references/fix-patterns.md for canonical edits.
• End-to-end use: from spec creation to final HTML/prose delivery with gated checks to reduce post-hoc rework.

Quick Start

Execute on a prepared spec or document to generate a violation report and a path to canonical fix patterns for safe edits.