Oil UI: A Design Skill That Forces AI Agents to Escape Default-Template Interfaces
AI-assisted frontend work keeps ending up with generic, inconsistent results that need heavy manual rework. Oil UI's concrete rules and mandatory review step offer a repeatable way to keep AI agents on a coherent visual track without sacrificing speed.
AI-generated interfaces tend to collapse into the same bland template: blue-purple gradients, left-right columns, English pill labels above headings, and nested rounded cards. Oil UI counters this by splitting design rules across landing pages, content pages, and admin workspaces, so the agent reads only the relevant spec for the current page type.
The skill also makes the agent generate three genuinely different layout directions for new products, with a rule that no two options share more than one of four dimensions: layout skeleton, font pairing, color, and key visual. A built-in comparison page lets developers pick a direction and copy the instruction to continue coding.
For existing projects, Oil UI consolidates conflicting design docs into a single DESIGN.md and prevents common AI mistakes like hardcoding pixel sizes or overriding shared component styles. It also forces a context-free sub-agent to review real browser screenshots, raising review dispatch from 0/6 to 5/6 in tests, at a cost of about 2.3x tokens and 25% more time per page.
Letting a model decide whether to run a review is a clear failure point; the 0/6 dispatch result shows that self-judgment is unreliable when it conflicts with saving effort.
Forcing dissimilar options across layout, font, color, and visual dimensions is a sharp way to break the model's tendency toward safe, template-like outputs.
Skill-based constraints raise the floor but cannot erase a model's intrinsic habits, so choice of model still matters for final quality.
Separating review context from generation context is effective because the generating agent's own context blinds it to obvious visual issues.