How does it verify that the documentation is technically accurate?

The skill reads the documentation source and then cross-references the corresponding application code—such as controllers, models, or library files—to ensure the descriptions match the implementation.

Does it check if the documentation site still builds after changes?

Yes, after making any documentation fixes, the skill automatically runs the build command to ensure there are no MDX or configuration errors.

Does this skill automatically fix documentation errors?

It can fix straightforward issues immediately. For more complex structural or narrative changes, it will describe the necessary modifications and ask for user confirmation before proceeding.

What documentation frameworks are supported by this skill?

This skill is specifically designed to work with Astro Starlight documentation sites using MDX and Markdown files.

Can I review only a specific part of my documentation?

Yes. You can instruct the skill to narrow its scope to a specific section, such as 'review only the authentication docs' or a specific subdirectory.

Documentation Quality Reviewer

Name: Documentation Quality Reviewer
Author: Grupo-AFAL

byGrupo-AFAL

•

Learning & Documentation

Audits Astro Starlight documentation for technical accuracy, structural integrity, and audience alignment by cross-referencing application source code.

The Documentation Quality Reviewer skill automates the maintenance of Astro Starlight documentation sites by ensuring content remains synchronized with the underlying codebase. It systematically inventories MDX pages, identifies discrepancies between technical guides and actual source files (like controllers or models), and evaluates content using a standardized review checklist. By categorizing findings into severity levels—from critical technical inaccuracies to minor formatting gaps—it provides actionable reports and can automatically apply or propose fixes to maintain a high-quality documentation experience.

Key Features

01Severity-based reporting for critical, important, and minor issues

021 GitHub stars

03Integrated MDX build validation via Bun to ensure zero-error deployments

04Source code cross-referencing to verify technical accuracy of docs

05Standardized quality auditing using project-specific review checklists

06Automated documentation inventory and sidebar structure mapping

Use Cases

01Auditing technical reference pages to ensure they reflect recent code refactors

02Validating documentation accuracy before a major production software release

03Standardizing documentation tone and structure across a large, multi-author project

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add grupo-afal/claude-plugins docs-review

For use in Claude.ai and ChatGPT

Key Features

01Severity-based reporting for critical, important, and minor issues

021 GitHub stars

03Integrated MDX build validation via Bun to ensure zero-error deployments

04Source code cross-referencing to verify technical accuracy of docs

05Standardized quality auditing using project-specific review checklists

06Automated documentation inventory and sidebar structure mapping

Use Cases

01Auditing technical reference pages to ensure they reflect recent code refactors

02Validating documentation accuracy before a major production software release

03Standardizing documentation tone and structure across a large, multi-author project