What problem does it solve?
Writing consistent, on-brand documentation for Home Assistant is hard because contributors must follow many style rules covering tone, grammar, UI terminology, list formatting, and integration page structure. This Skill encodes those rules so AI-assisted writing and editing of Home Assistant documentation stays consistent with the official style guide.
Core Features & Use Cases
- Style enforcement: Applies brand personality, tone, grammar, and terminology rules such as Oxford commas, sentence-style headings, UI breadcrumbs, and correct brand capitalization like "Z-Wave".
- Integration page structure: Guides creation of integration documentation using the standard template sections, reusable config flow snippets, and separate trigger, condition, and action files.
- Editorial guardrails: Handles deprecations, page redirects, blog author validation against people.yml, and restrictions on inventing new automation or dashboard examples.
- Use Case: When drafting a new integration page or editing an existing docs page, the Skill ensures the prose addresses readers as "you", presents the UI as the primary path, and follows the Microsoft Style Guide conventions.
Quick Start
Review and rewrite this Home Assistant integration documentation draft so it follows the official documentation writing style.
