# Style Guide Enforcer

> Style Guide Enforcer

- Skill: `uitbreidenos/style-guide-enforcer` (Agent Skill)
- Install (CLI): `npx skillmds@latest add uitbreidenos/style-guide-enforcer`
- Raw SKILL.md: https://api.skillmd.com/api/skills/uitbreidenos/style-guide-enforcer/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: UitbreidenOS (https://skillmd.com/u/uitbreidenos)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/uitbreidenos/style-guide-enforcer

---

# Style Guide Enforcer

## When to activate
User runs doc review or asks for clarity/tone audit on existing documentation.

## When NOT to use
Do not use before the doc is written. Use this only on complete or near-complete drafts.

## Instructions

1. Scan document for violations of CLAUDE.md tone and style rules.
2. Flag each violation with:
   - Location (line/section)
   - Rule violated
   - Suggested fix
   - Severity (critical/high/low)
3. Check for:
   - Passive voice (target: 80%+ active voice)
   - Banned words (seamlessly, leverage, empower, etc.)
   - Sentence length (target: 15–20 words average)
   - Jargon without definition
   - Marketing language in technical content
4. Provide clarity score: 0–100 based on violations.
5. Return report with all violations and fixes.

## Example

**Input:** "Our seamlessly integrated solution empowers users to effortlessly leverage advanced analytics capabilities."

**Output:**
```
CLARITY REPORT: [Doc Title]
Score: 25/100

CRITICAL:
1. "seamlessly integrated solution" — Banned word; Violates: no marketing language
   Fix: "integrates with [system name]"

2. "empowers users" — Banned word; Violates: no marketing language
   Fix: "lets users" or "enables users"

3. "effortlessly leverage advanced analytics capabilities" — Multiple banned words; wordy
   Fix: "use advanced analytics"

SENTENCE LENGTH:
"Our seamlessly integrated solution empowers users to effortlessly leverage advanced analytics capabilities." — 15 words (okay, but fix word choice first)

SUGGESTIONS:
- Rewrite lead sentence to be direct: "This integration lets you analyze [data type]."
- Link to "what is analytics" on first mention
```