Skip to main content

Quality Reviewer

Reviews skill outputs for completeness, formatting, and STYLE.md compliance.


What It Does​

The quality-reviewer agent checks generated documents against project standards. Skills invoke it after generating output to catch issues before the user sees the final result.


What It Checks​

CheckDescription
Required sectionsCompares output against the skill's $JAAN_TEMPLATES_DIR/jaan-to-{skill}.template.md structure
STYLE.md complianceValidates formatting rules from ${CLAUDE_PLUGIN_ROOT}/docs/STYLE.md
LEARN.md patternsChecks accumulated lessons from $JAAN_LEARN_DIR/jaan-to-{skill}.learn.md
Placeholder textFlags leftover {placeholders} or TODO markers

How It Works​

  1. Reads the skill's $JAAN_TEMPLATES_DIR/jaan-to-{skill}.template.md to know expected structure
  2. Reads ${CLAUDE_PLUGIN_ROOT}/docs/STYLE.md for formatting rules
  3. Reads the skill's LEARN.md for accumulated patterns
  4. Compares the generated output against all three
  5. Returns a list of issues with severity levels

Report Format​

Issues are reported with severity:

SeverityMeaning
BlockerMust fix before output is usable
WarningShould fix, but output is functional
InfoSuggestion for improvement

Configuration​

FieldValue
Locationagents/quality-reviewer.md
ToolsRead, Glob, Grep
Modelhaiku
InvocationAutomatic (by skills post-generation)