api-docs

Apply Sun Lab conventions to Sphinx documentation files and configurations.

3|Updated Feb 5, 2026
One-click install
npx skills add https://github.com/Sun-Lab-NBB/ataraxis --skill api-docs-sun-lab-nbb
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: api-docs
Source: https://github.com/Sun-Lab-NBB/ataraxis/tree/main/plugins/automation/skills/api-docs
Command: npx skills add https://github.com/Sun-Lab-NBB/ataraxis --skill api-docs-sun-lab-nbb

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill ensures that API documentation for Sun Lab projects adheres to established conventions, making it consistent, discoverable, and easy to maintain across different projects.

Core Features & Use Cases

  • Sphinx Configuration: Sets up conf.py for Python-only, C++-only, and hybrid projects.
  • RST Structure: Defines standard index.rst, welcome.rst, and api.rst files.
  • Doxygen/Breathe Integration: Configures C++ documentation generation.
  • Use Case: When starting a new Python project that needs API documentation, this Skill will set up all the necessary Sphinx configuration files and structure according to Sun Lab standards.

Quick Start

Apply Sun Lab API documentation conventions to the current project's Sphinx files.

Frequently Asked Questions about api-docs

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

FAQPage Schema
How do I set up Sphinx documentation for a hybrid Python and C++ project?

Sphinx documentation for hybrid projects requires configuring conf.py to integrate Doxygen and Breathe, defining standard RST structures like index.rst and api.rst, and setting up tox build environments to generate consistent API docs.

How does Doxygen integration with Sphinx work using Breathe?

Doxygen integration with Sphinx using Breathe works by configuring Breathe in conf.py to parse Doxygen XML output, allowing C++ API documentation to be rendered directly within standard Sphinx RST documentation files.

What is the standard RST structure for Sphinx API documentation?

The standard RST structure for Sphinx API documentation includes defining root index.rst files alongside dedicated welcome.rst and api.rst files to organize project overviews and reference documentation hierarchically.

Can I use this Sphinx configuration for Python-only projects without Doxygen?

Yes, this Sphinx configuration supports Python-only project archetypes by setting up conf.py and standard RST files without requiring Doxygen or Breathe integration, ensuring consistent documentation generation across different project types.

What's the best way to standardize API documentation across multiple projects?

Standardizing API documentation across multiple projects involves applying consistent Sphinx conventions for conf.py, RST structure, Doxygen/Breathe integration, and tox build environments to make docs discoverable and easy to maintain.

Do I need a Makefile wrapper to build Sphinx documentation with tox?

A Makefile wrapper is used to standardize Sphinx documentation builds with tox environments, providing a consistent entry point for generating documentation across Python-only, C++-only, and hybrid project archetypes.