oiloil-ui-ux-guide

Runs structured UI/UX consultations to produce design specs, surface rules, and prioritized UI reviews.

Updated Aug 22, 2026
One-click install
npx skills add https://github.com/farslab/claude-skills --skill oiloil-ui-ux-guide-farslab
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: oiloil-ui-ux-guide
Source: https://github.com/farslab/claude-skills/tree/main/oiloil-ui-ux-guide
Command: npx skills add https://github.com/farslab/claude-skills --skill oiloil-ui-ux-guide-farslab

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Teams building interfaces often lack a coherent design system, consistent tokens, or a structured way to audit existing screens. This Skill guides an AI through a listening-first consultation that either co-designs a project-specific design system, generates compact do/don't rules for a surface, or reviews an existing UI with prioritized fixes. ## Core Features & Use Cases - Design mode: Scans the project's tokens and components, classifies its maturity stage, interviews the user, and outputs a design-spec.md validated against a business mockup HTML. - Guide mode: Emits compact do/don't rule lists for surfaces like dashboards, forms, settings, and marketing pages based on ten style-independent UX hard rules. - Review mode: Audits an existing screen and lists findings as P0/P1/P2 with evidence, diagnoses grounded in design psychology, and implementable fixes. - Use Case: A developer starting a new Next.js + Tailwind app invokes the skill, picks a style family and tokens through a visual preview, reviews a mockup of their actual product page, and receives a complete design-spec.md for the team. ## Quick Start Ask the AI to run a design consultation for your project, for example: help me define a design system for my dashboard app and produce a design spec.

Frequently Asked Questions about oiloil-ui-ux-guide

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a design system for my project with AI?▼

Invoke the design mode, which scans your existing tokens and components, interviews you about brand and references, presents style family options, and outputs a design-spec.md after you approve a business mockup of your actual product surface.

How to review a UI screen and get prioritized fixes?▼

Use review mode by sharing the screen or mockup. It states assumptions, lists findings as P0/P1/P2 with one line of evidence each, diagnoses issues using design psychology references, and proposes implementable fixes with a verification checklist.

What design tokens does the consultation cover?▼

It covers color palette, typography, radius, spacing density, shadows, and motion, plus four extended dimensions: container strategy, icon system, decoration policy, and locale. Each choice offers two to three neutral options without a starred recommendation.

Does it work with Tailwind and shadcn projects?▼

Yes. The initial scan reads tailwind.config, globals.css, theme files, and package.json to detect frameworks like shadcn, Radix, Chakra, Ant Design, or MUI, then classifies the project into one of five maturity stages before proceeding.

When should I not trigger this consultation flow?▼

Do not trigger it for narrow one-off questions like whether a single color works or a button should be larger. Those should be answered directly without invoking the full interview, preview, and spec-generation workflow.