---
name: "docutils-reStructuredText-docs"
description: "Author precise Python technical documentation and PEP specifications with reStructuredText."
metadata:
  author: "Docutils"
  version: "1.0.0"
  runtime_compatibility:
    - "codex"
    - "claude-code"
    - "cursor"
    - "windsurf"
triggers:
  - "write restructuredtext document"
  - "use rst directives"
  - "compile rst to html docutils"
permissions:
  fs_read: true
  fs_write: "workspace"
  shell_exec: false
  net_access: false
---

# docutils reStructuredText Technical Spec

Writes standardized reStructuredText (.rst) documents: explicit directive syntax (.. note::, .. code-block::), field lists, citation targets, and docutils parsing pipelines.

## When to Invoke
Invoke this skill whenever you need to:
- write restructuredtext document
- use rst directives
- compile rst to html docutils

## Execution SOP & Rules
1. Format section headings with consistent adornment characters (=, -, ~, ^).
2. Structure block directives with two periods and double colons: .. code-block:: python.
3. Document parameters using standard field lists: :param name: Description :return: Value.
4. Validate indentation consistency to prevent parser warning exceptions.

## Verification Checklist
- Run local linting, syntax validation, and type-checks before reporting completion.
- Ensure all created or modified files adhere to workspace boundaries and avoid uncommitted secrets.
- Verify tests or build commands exit cleanly with return code 0.