fix-sphix-docs

To automatically fix Sphinx documentation build errors, use this Skill to scan your docs directory and apply safe fixes to reST or MyST sources. It targets build-time warnings, missing references, and broken cross-links within a controlled timeout.

Sphinx builds often fail with missing references and broken cross-links due to inconsistencies in source files. This Skill identifies these common warnings and applies automated fixes to stabilize the documentation deployment.

Yes, you can use this Skill to fix MyST and reST source files in Python projects. It specifically parses and modifies these formats while avoiding autogenerated content to safely resolve build warnings.

The best way to resolve Sphinx warnings without touching autogenerated content is to apply targeted fixes to manually written reST and MyST sources. This Skill runs sphinx-build within a timeout and safely patches only the relevant files.

To stabilize Sphinx documentation builds in CI/CD pipelines, automatically detect and address common build-time warnings before deployment. This Skill scans sources and applies safe fixes within a controlled timeout to improve reliability.