What problem does it solve? Inconsistent tone, bloated prose, broken links, and mixed document types make documentation hard to read and maintain. This Skill applies a fixed set of writing principles and markdown structural rules so every document you produce or edit stays clear, consistent, and portable. ## Core Features & Use Cases - Core Writing Principles: Enforces answer-first structure, active voice, sentence economy, terminology lock, scannable formatting, and bans filler phrases across all text output. - Divio Document Classification: Classifies documents as Tutorial, How-To, Reference, or Explanation and keeps each document to a single type with the correct tone and structure. - Markdown Audit Rules: Validates relative link portability, single-H1 header hierarchy, table alignment, consistent list symbols, and no trailing spaces, with an optional link-checking script. - Use Case: When editing a project README, the Skill flags preamble filler, fixes skipped header levels, converts absolute file paths to relative links, and confirms every cross-reference resolves. ## Quick Start Ask the agent to audit and rewrite the project README following the documentation skill's writing principles and markdown rules.