Docs Fixing Tutorial Quality

Fixing Tutorial Quality

Overview

This Skill packages docs-tutorial-fixer's domain-specific re-validation and fix methodology for tutorial pedagogical findings, distinct from the generic maker-checker-fixer mechanics covered by repo-applying-maker-checker-fixer and repo-assessing-criticality-confidence.

Reference Modules

• Confidence Assessment and Domain Examples — the quick-summary workflow and tutorial-specific HIGH/MEDIUM/FALSE_POSITIVE examples
• HIGH-Confidence Validation Checks — the five objective re-validation checks with their exact bash patterns
• MEDIUM-Confidence Subjective Checks — the four subjective-quality categories that always route to manual review
• Safeguards and Output Format — refusal conditions, the required output shape, and convergence safeguards

Core Principles

• Objective issues only get HIGH confidence — missing sections, LaTeX delimiters, naming patterns, time estimates, and frontmatter fields are binary; everything about narrative flow, diagram placement, content balance, or writing style is subjective and MEDIUM at best.
• Re-implement the checker's exact patterns — use the same bash re-validation snippets as docs-tutorial-checker so results stay consistent; a mismatch signals a checker bug.
• Never auto-apply subjective quality improvements.

Related Skills

• repo-applying-maker-checker-fixer — the generic maker-checker-fixer pattern and mode logic
• repo-assessing-criticality-confidence — the generic criticality × confidence priority matrix
• repo-generating-validation-reports — report file naming and UUID-chain conventions