dart-doc-validation

What problem does it solve? Broken documentation links, unresolved references, and undefined macros in Dart doc comments silently degrade package documentation quality and can block publishing to pub.dev. This Skill provides a repeatable workflow to detect and fix these issues before release. ## Core Features & Use Cases - Local Documentation Validation: Runs dart doc with a temporary output directory to surface warnings like unresolved doc references and undefined macros without cluttering the project workspace. - Warning Diagnosis Guidance: Explains how to fix unresolved [Identifier] references by pointing them to existing classes, methods, or parameters in scope. - Macro Troubleshooting: Shows how to resolve {@macro} errors by ensuring matching {@template} definitions exist in visible files. - Use Case: Before publishing a Dart package to pub.dev, run the validation command to catch all broken doc references, then fix each warning so the generated API documentation renders correctly. ## Quick Start Validate the Dart documentation comments in this package and report any unresolved references or undefined macros.