Skip to content
Oil UI

Oil UI Skill

Interface-design skill that explores several distinct visual directions side by side, then refines the chosen one against real screenshots.

GitHub Docs

Install

Install with the skills CLI

One command for Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf and dozens of other agents. Needs Node.js; the skill is fetched straight from oil-oil/oil-ui.

$ npx skills add oil-oil/oil-ui --skill oil-ui

Run it in a terminal. The CLI finds the agents installed on your machine, asks which ones to add the skill to, and whether to install it into the folder you ran it from or for all your projects.

Other ways to install

  1. Open the skill on GitHub and download the folder that holds its SKILL.md.
  2. Put it at ~/.claude/skills/oil-ui/, where Claude Code picks it up in every project.

No scripts or references next to it? Saving the SKILL.md alone as ~/.claude/skills/oil-ui/SKILL.md works too.

Using another agent? Its personal skills folder
Codex
~/.agents/skills/
Cursor
~/.cursor/skills/
GitHub Copilot
~/.copilot/skills/
Gemini CLI
~/.gemini/skills/
Windsurf
~/.codeium/windsurf/skills/
OpenCode
~/.config/opencode/skills/

About

  • Three distinct design directions compared side by side
  • Competitor research before designing
  • Desktop and mobile screenshot-based refinement
  • Screenshot recreation and interface review
  • MIT licensed, no configuration needed

Oil UI is an open-source (MIT) interface-design skill for AI coding agents. Instead of producing one generic layout, it first identifies the product category and studies its most distinctive competitors, then turns vague style words into concrete choices about typography, whitespace and colour density.

For a new interface it builds three visually different first-screen directions in a built-in comparison page, requiring any two directions to share at most one of layout, typography, colour or hero visual. You pick a direction, give feedback, and the agent builds the full page, concentrating polish on one or two memorable moments and keeping the rest restrained.

The result is verified with desktop and mobile screenshots, an optional independent review, and a final reduction pass that strips anything unnecessary. It also handles screenshot recreation, visual polish and interface review. It covers design judgment only; business logic, APIs and builds are out of scope. Works with Claude Code, Codex and other agents that support the SKILL.md format. A separate paid Pro edition exists; the open-source version is fully usable on its own.

Try it

Once installed, ask your agent something like:

Design a landing page for a developer-tools startup: show me three distinct directions first.

SKILL.md

The instructions your agent loads, as published by oil-oil.

SKILL.md
name
oil-ui
description
Design, improve and review interfaces for websites, apps, dashboards and components. Explore distinct design directions, compare styles side by side, and refine visual hierarchy against real screenshots.

Oil UI (summary)

Use for new interface design, style comparison, visual polish, screenshot recreation and interface review. Not for business logic, APIs, builds or code cleanup without visible UI changes.

Workflow
  1. Set a design north star from the product category, first-screen focus and brand, not from default templates.
  2. For new interfaces, build three visually distinct first-screen directions in a comparison page; the user picks one.
  3. Build the full visual and interaction structure.
  4. Capture desktop and mobile screenshots of key states.
  5. Run an independent review where available, then a reduction pass that removes unnecessary elements.
  6. Deliver design notes: direction, changes, evidence.

Full skill: https://github.com/oil-oil/oil-ui

Install

Skill: Big Arrow on the Screen

by Franz Enzenhofer

macOS CLI plus agent skill that lets Claude Code or Codex draw a big click-through arrow and sign on your screen to show you exactly what to click.

Skill: Logo Design

by kaankiziltug

Agent skill that walks Claude and other coding agents from discovery brief to production-ready SVG logos, with audit tools and a 1,400+ logo reference library.

Skill: Stitch: Generate Design

by Google Labs (Stitch)

Featured

Google's official Stitch skill for generating and editing UI screens from text or images — with a mandatory prompt-enhancement pipeline before every call.

Browse all skills →