Style Guide Patterns

What problem does it solve?

This Skill addresses the challenge of maintaining consistent and high-quality technical documentation by providing a framework for creating and enforcing style guides. It helps teams avoid common pitfalls like overly long guides or unenforced rules.

Core Features & Use Cases

• Rule Prioritization: Focuses on the 10 most impactful rules for maximum adoption.
• Do/Don't Pattern: Provides concrete, domain-specific examples for clarity.
• Terminology Governance: Ensures consistent use of key terms with automated enforcement.
• Voice vs. Tone Distinction: Clearly separates unchanging voice from context-dependent tone.
• Inclusive Language: Mandates specific, enforceable replacements for non-inclusive terms.
• Reading Level Enforcement: Integrates with linters to maintain target readability.
• Anti-Pattern Identification: Highlights common mistakes in style guide creation and maintenance.

Quick Start

Use the style guide patterns skill to generate a Vale rule for enforcing active voice.