SKILL.md
/audit — Comprehensive Design Audit
Examine every CSS declaration and HTML element for quality issues. Unlike /score which gives a summary, /audit produces a detailed report with line-by-line findings.
Process
- Parse all CSS declarations in scope
- Check each against the OPTIK anti-pattern registry
- Grade each of the five pillars with specific findings
- Generate fix instructions for every issue
- Prioritize fixes by impact (highest score improvement first)
Report Sections
Critical (fix immediately)
- Anti-pattern violations (banned fonts, purple gradients, nested cards, outline:none)
- WCAG contrast failures
- Missing focus styles
Warning (fix before shipping)
- Off-grid spacing values
- Inconsistent type scale
- Missing responsive breakpoints
- Motion without reduced-motion fallback
Info (optional improvements)
- Opportunities for CSS custom properties
- Animation timing suggestions
- Semantic HTML improvements
- Touch target sizing
Every finding includes: severity, affected selector, current value, recommended fix, and score impact.