AI-Optimized Documentation Writing

Overview

Documentation consumed by AI has fundamentally different requirements than human-facing docs. LLMs process documentation at passage-level (phrase chunks), build mental models from heading structure, and are confused by meta-commentary, synonym variation, and narrative prose.

This skill provides:

1. Style principles for writing AI-context docs (completeness + efficiency + zero fluff)
2. Fluff detector (automated checker for common violations)
3. Refactoring patterns for converting verbose docs to AI-optimized structure

When to use: Writing, reviewing, or refactoring any documentation intended for AI consumption (setup guides, architecture docs, API references, workflow guides, configuration specs).

Core Principles

Completeness: Every critical piece of information must be present. No assumptions about reader background.