sphinx-fix

Diagnose a failing Ray Sphinx / Read the Docs documentation build. Parses the Sphinx warning stream (an RtD build log, a local build, or pasted text), classifies each warning against a rules table, and proposes the canonical fix in severity-tier order. Detects a hard-broken build, segregates known-benign suppressed classes, and lists every unclassified warning. Use when a `docs/readthedocs.com:anyscale-ray` check fails, when asked "why is the docs build failing?" or "what warning is breaking this PR?", or to turn a Sphinx warning dump into an ordered fix list.

Install
npx skills add 'https://github.com/ray-project/ray/tree/master/doc/.claude/skills/sphinx-fix'
Download bundle ↓
master · 39882c6Scanned 2026-09-17

Contributors

GitHub-linked commit authors for this SKILL.md at the saved revision. Co-authors and history before file renames are not included.

File history ↗
View on GitHub
← Back to SKILL.md
Running Sphinx v8.2.32026-06-16 10:00:01,234	WARNING worker.py:123 -- Ray runtime noise, ignore mebuilding [html]: targets for 5 source files that are out of date{"levelname": "WARNING", "message": "json log line noise from a notebook"}/home/docs/checkouts/readthedocs.org/user_builds/anyscale-ray/checkouts/64240/doc/source/data/api.md:55: WARNING: image file not readable: images/missing.png [image.not_readable]build finished with problems, 1 warning.