# Fix Sphix Docs

> Fix errors and warnings in Sphinx docs build

- Skill: `tradingstrategy-ai/fix-sphix-docs` (Agent Skill)
- Install (CLI): `npx skillmds@latest add tradingstrategy-ai/fix-sphix-docs`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tradingstrategy-ai/fix-sphix-docs/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tradingstrategy-ai (https://skillmd.com/u/tradingstrategy-ai)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/tradingstrategy-ai/fix-sphix-docs

---


# Fix errors and warnings in Sphinx docs build

This skill iterates over Sphinx docs build and attempt to fix easily addressable errors and warnings.

# Steps

1. Run Sphinx build: `(source ./.venv/bin/activate && cd ./docs/ && make html)`, but with a twist:  figure out how to abort after 60 second do not try to wait for the full build takes too long.
2. Check the output warnings and errors you could attempt to fix. DON'T TOUCH AUTO GENERATED RST FILES. These are in `_autosummary` folders like `_autosummary_d2`. These folders will be recreated by user with a special command you do not know.
3. Report made changes
4. Ask a permission to open a PR