documentation

Maintain Sphinx documentation with API references, guides, and changelog updates.

Updated Mar 26, 2026
One-click install
npx skills add https://github.com/christophevg/c3 --skill documentation-christophevg
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: documentation
Source: https://github.com/christophevg/c3/tree/main/skills/documentation
Command: npx skills add https://github.com/christophevg/c3 --skill documentation-christophevg

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Updating and publishing high-quality project documentation can stall development, especially when Sphinx configuration, API reference pages, and changelogs drift out of sync.

Core Features & Use Cases

  • Sphinx setup & validation: Ensures key docs assets exist (conf.py, Makefile, index, requirements) and creates standard scaffolding when missing.
  • API reference maintenance: Updates module-level pages in docs/api and wires them into the documentation navigation.
  • Release documentation hygiene: Adds structured changelog entries and refreshes guides like quickstart/installation to reflect feature changes.
  • Build verification: Runs the documentation build and checks for warnings/errors and broken links before publishing.

Quick Start

Use the documentation skill to update your Sphinx documentation for a readthedocs.org deployment.

Frequently Asked Questions about documentation

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

FAQPage Schema
How do I generate API documentation and update changelogs for a Sphinx project?

To generate API documentation and update changelogs for a Sphinx project, you can scaffold initial configurations, update module-level API reference pages, and add structured changelog entries. The process validates your docs structure and runs a build to ensure no broken links or warnings before publishing.

What is the best way to scaffold initial Sphinx documentation for readthedocs publishing?

Scaffolding initial Sphinx documentation for readthedocs involves creating standard assets like conf.py, Makefile, and index files. When key docs assets are missing, the documentation setup process creates the standard structure automatically and validates the configuration to prepare for readthedocs deployment.

How do I keep my Sphinx API reference pages synchronized after adding new features?

Keeping Sphinx API reference pages synchronized after adding features requires updating module-level pages in the docs/api directory. The documentation maintenance process wires updated API references into the existing documentation navigation and validates the changes through a successful documentation build.

Does this documentation build process work with uv-based sphinx-build environments?

Yes, the documentation build process works with uv-based sphinx-build environments. It runs the documentation build using the project's make targets or uv-based sphinx-build commands, checking for warnings, errors, and broken links to ensure the build is successful before publishing.

How do I add structured changelog entries during a release cycle for Sphinx docs?

Adding structured changelog entries during a release cycle involves editing the docs/development/changelog.md file. The documentation synchronization process also refreshes guides like quickstart and installation to reflect feature changes, ensuring release documentation hygiene is maintained across the project.

Why does my Sphinx documentation build fail with broken links during readthedocs deployment?

Sphinx documentation builds may fail with broken links if the docs structure is invalid or API references are not properly wired into navigation. Running a build verification checks for warnings, errors, and broken links, ensuring the documentation structure is validated before attempting readthedocs publishing.