sphinx-fix

sphinx-fix is a Docs quality & drift control skill for AI agents, published by ray-project in the ray repository on GitHub. Skillspace rates sphinx-fix B (81/100) and it passed the safety scan; a judge model has also reviewed it.

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.

Grade
B
Quality
81 / 100
Safety
Passed
GitHub stars
43,252

Placed #1 of 6 in the judged category final for Docs quality & drift control.

Not launch-quality. It is graded B with a clean safety verdict, but our quality filters exclude it: a model that read it found it written only for the repository it lives in. So it is not in our launch-quality set, the skills our MCP server searches and recommends. How launch-quality is decided

Our two independent classifiers differ on this skill's category, so treat the placement as provisional.

This rating describes the version of the repository we crawled; it may have changed since, so go by its current files.

Our review

Architecture
100 / 100
Maturity
Structured: ships references or scripts
Security scan
No issues found
License
Apache-2.0
Adoption
Adopted by 0 other repositories, in 0 collections
Scope
Repo-internal: written for the repository it lives in. Ray's own docs build, readthedocs config and suppressed warning classes

Judge review

Placed #1 of 6 in the judged category final for Docs quality & drift control.

  • Trigger8888
  • Instructions9393
  • Specificity9595
  • Safety9393
  • Disclosure8888
  • Maintenance9090
Deterministic, explicitly read-only warning classifier with a smart root-cause-collapsing algorithm that stops one broken autosummary stub from drowning the report in duplicate warnings.

Not checked yet

  • No blind task eval yet
  • Sibling files (scripts, references) not fetched; security scan covers SKILL.md only

Skillspace indexes and rates this skill; it does not host or endorse it. Run third-party skills at your own risk.