documentation

Build and preview Sphinx documentation locally with MyST parser.

13|1|Updated Feb 3, 2026
One-click install
npx skills add https://github.com/OliverSieweke/occhio --skill documentation-oliversieweke
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: documentation
Source: https://github.com/OliverSieweke/occhio/tree/main/skills/documentation
Command: npx skills add https://github.com/OliverSieweke/occhio --skill documentation-oliversieweke

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Sphinx documentation projects often require repetitive setup, configuration, and local validation. This Skill provides a concise, guided approach to building and previewing docs locally, reducing setup friction and ensuring consistency across environments.

Core Features & Use Cases

  • Install documentation dependencies and build HTML docs with the provided Make targets.
  • Start a live HTML preview server to iteratively edit and validate docs locally.
  • Manage common configuration aspects (conf.py, extensions, themes) and quick testing workflows.

Quick Start

Install the documentation dependencies and start a local live preview of the Sphinx docs.

Frequently Asked Questions about documentation

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I build and preview Sphinx documentation locally?

To build and preview Sphinx documentation locally, you can automate the process by installing project dependencies and running the live HTML preview server using the provided Make targets like make livehtml.

Does this approach support building Sphinx docs with MyST parser for Markdown?

Yes, this approach explicitly supports Sphinx projects using the MyST parser for Markdown, enabling local HTML preview and configuration management for Markdown-based documentation.

What is the best way to manage Sphinx documentation dependencies and configuration?

The best way to manage Sphinx configuration is by automating dependency installation and handling common configuration aspects like conf.py, extensions, and themes for consistent local validation.

Can I start a live HTML preview server for iterative editing of Sphinx docs?

Yes, you can start a live HTML preview server to iteratively edit and validate Sphinx docs locally, automatically reflecting changes as you modify your Markdown or reStructuredText files.

Why should I automate local Sphinx docs builds instead of manually running make html?

Automating local Sphinx docs builds reduces repetitive setup friction and ensures consistency across environments by handling dependency installation, configuration, and the make html process.

Do I need a conf.py file to manage and build local Sphinx documentation?

Yes, a conf.py file is required to define your project's extensions and themes, which the automation process reads to manage configuration and output to the docs build directory.