AI tools for Sphinx development

Instructions, skills, and an agent to assist with Sphinx extension development.

Skills

This workspace includes specialized skills for Sphinx extension development:

Planning and Design

• plan-sphinx-extension - UX-first planning workflow for new extensions or features

Implementation

• create-directive - Add a directive to an extension with workflow guidance and code patterns
• create-role - Add a role to an extension with workflow guidance and code patterns

Quality Assurance

• fetch-sphinx-docs - Fetch and cache official Sphinx/Docutils documentation to prevent API hallucination
• lint-python - Run ruff and ty to lint and type-check Python code
• verify-build - Build test documentation and verify extension functionality

Agent

The Sphinx Developer agent orchestrates these skills to ensure high-quality extension development without API hallucination.

Key Principles

• UX-first design - Plan user experience before implementation
• Documentation-driven - Never guess APIs, always fetch official docs
• Quality-enforced - All code must pass linting and type checking
• Build-verified - Extensions must build cleanly before completion