Menu
Sub-skill of sphinx: Common Issues (+1).
The review-first prompt is selected by default. You can switch to a direct command or download a local copy.
Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
A direct command skips the review prompt. Inspect the source before running it.
npx skills add https://github.com/vamseeachanta/workspace-hub --skill sphinx-common-issuesThe command stays on one line. Scroll horizontally to inspect it before copying.
Prefer a local copy? Download the files currently available to SkillsMP.
Showing SKILL.md
Based on SOC occupation classification
| name | sphinx-common-issues |
| description | Sub-skill of sphinx: Common Issues (+1). |
| version | 1.0.0 |
| category | development |
| type | reference |
| scripts_exempt | true |
# conf.py - Add source to path
import sys
from pathlib import Path
sys.path.insert(0, str(Path(__file__).parents[2] / 'src'))
# conf.py - Use local inventory file
intersphinx_mapping = {
'python': ('https://docs.python.org/3', 'python-objects.inv'),
}
# Download inventory manually
# curl -O https://docs.python.org/3/objects.inv
# Build without -W flag for debugging
sphinx-build -b html docs/source docs/build/html
# Then fix warnings before re-enabling
sphinx-build -b html docs/source docs/build/html -W
# conf.py - Ensure napoleon is configured
napoleon_google_docstring = True
napoleon_numpy_docstring = True
# Check docstring format - must have proper indentation
def func():
"""
Summary line.
Args:
param: Description. # Note: proper indentation
"""
# Install full LaTeX distribution
# Ubuntu
sudo apt-get install texlive-full
# macOS
brew install --cask mactex
# Check LaTeX installation
pdflatex --version
latexmk --version
# Verbose build
sphinx-build -b html docs/source docs/build/html -v
# Very verbose
sphinx-build -b html docs/source docs/build/html -vvv
# Show traceback on errors
sphinx-build -b html docs/source docs/build/html -T
# Keep going on errors
sphinx-build -b html docs/source docs/build/html --keep-going