SkillInstalls cleanly

Design pages, compare looks on request

Oil UI

A design skill that recommends one look for your website or app and polishes it. Ask it to compare, and it puts a few different looks side by side.

Works with
Claude Code, Codex CLI
Good for
Graphic designers, Web developers

What it does

Oil UI is a design skill for AI assistants. A skill is a folder of instructions that tells your assistant how to do one kind of job. Before Oil UI draws anything, it names the kind of product you have and looks at two or three well-designed products of the same kind. It then turns vague words like "clean" or "premium" into concrete choices: fonts, white space and how much of the page uses colour.

Since version 0.27.0 (28 October 2026), it recommends one design direction by default. It describes that direction in a few lines, says why it fits, and waits for you to confirm. Then it builds only that one. If you say "you decide" or "just build it", it goes ahead with that one direction without asking.

To see several options, ask it to compare. It then writes three directions that really differ, or the number you ask for. Of layout, typography, colour and key imagery, any two directions may share at most one. You pick a direction from the text, or ask to see first screens of all of them on one comparison page. On that page you can switch between desktop and phone sizes and move through the options with the arrow keys. You click "Select" on the one you like, paste the copied sentence back to your assistant, and it refines that direction.

When a page is done, the skill checks real screenshots at desktop and mobile sizes. It also does screenshot recreation and design reviews. From version 0.23.2, it skips routine edits where you already said exactly what to change, such as a new label. Since 0.24.0, when a page has a main user flow, a separate sub-agent tries that flow before delivery and reports up to 3 problems. The release notes say this is not real user research.

Since 0.25.0, work files such as design candidates, screenshots and logs go into a .oil-ui folder in your project, unless your project already has a place for them. That folder has its own .gitignore, so git does not save those files. Final code still goes into your project.

Since 0.24.1 the skill can also make or edit images with oiloil credits, a paid balance you top up in the author's oiloil account. The README does not state a price. It uses credits only when your assistant cannot make images itself and your task clearly allows credits. If you are not signed in, it asks once and gives the sign-in command. Signed in does not mean allowed: without clear permission it uses no credits.

Each time the skill is used, it checks ui.oiloil.org for a newer version, at most once every 10 minutes. The README says it reads only the public version list and uploads nothing from your project. It updates only when you ask. In Claude Code the check runs by itself when the skill loads, and the skill pre-approves that check script.

The skill's own instructions are mostly in Chinese. They tell the assistant to answer in your language, so you can work in English. Since version 0.23.8 (18 October 2026), the skill's short description is in Chinese only. Your assistant uses that description to decide when to use the skill, so a request in English may not start it (our reading, not tested). Name the skill in your request, for example: Use oil-ui to design this page. The skill has an MIT licence and works on its own. On first use it adds a one-time note that recommends the paid Oil UI Pro ($9.99 one-time, per the README).

Who it is for

People who ask an assistant to design a website, app screen or dashboard and want one well-argued design, or a few clearly different options to choose from, instead of one page that looks like every other AI page.

Example prompts

  • "Use oil-ui to explore a few design directions for this course booking product and build pages I can preview."
  • "Create three designs with different typography, colors, and compositions. Put them on a comparison page so I can choose."
  • "Review this homepage and explain what to change and how. Leave the files untouched."
  • "Recreate this page from the screenshot and add a mobile layout too."

How to install

npx skills add oil-oil/oil-ui

How to use it

Ask: Use oil-ui to explore a few design directions for this booking page and build pages I can preview.

Other assistants

The project description names Claude Code and Codex. For Codex CLI, use the skills CLI and pick the Codex target:

  1. Open a terminal in your project folder.
  2. Run the install command:
npx skills add oil-oil/oil-ui -a codex
  1. Start Codex and ask it which skills it has.

The skills CLI also supports Gemini CLI, but Oil UI does not name Gemini CLI. Support there is not confirmed.

Check it works

  1. List the skills that the skills CLI installed:
npx skills ls
  1. Look for oil-ui in the list.
  2. Ask your assistant: "Which skills do you have?" The README says the skill is ready right after installation, with nothing to configure.

Common problems

  • Two design skills fight over the same request — the wrong skill answers — do not install Oil UI and Oil UI Pro together. Remove one with npx skills remove oil-ui.
  • The skill does not start — you asked in English and the assistant answered without it — since 0.23.8 the skill's description is in Chinese only — say "Use oil-ui" in your request (our reading, not tested).
  • The skill takes over small, exact edits — it opens a browser for a label change — update to 0.23.2 or later with npx skills update.
  • You see "Version checks need Python 3" — the update check did not run — install Python 3, or ignore the note. The comparison page builder needs Python 3.10 or newer.
  • Screenshots do not work — the screenshot tool needs Node.js 22 and Chrome, Chromium or Edge — install them, or let the skill use your assistant's own browser tool.
  • You do not want any network check — for example in a locked-down folder — set OIL_NO_UPDATE_CHECK=1 before you start your assistant.

What to watch out for

  • Checks ui.oiloil.org for a newer version at most once every 10 minutes; the README says it uploads nothing from your project
  • The README advertises a paid Pro version ($9.99 one-time, per the README); the open-source version is MIT and works on its own
  • Runs a version-check script each time it loads (needs Python 3); set OIL_NO_UPDATE_CHECK=1 to turn it off
  • Takes screenshots with Node.js 22 and Chrome, Chromium or Edge on your computer to check its work
  • Can search and download stock images and video from public archives when you ask for media
  • May show a one-time suggestion to buy Pro
  • In Claude Code the version check runs by itself when the skill loads, and the skill pre-approves that command
  • An update you ask for runs Oil's update tool from GitHub through npx (pinned to one commit; needs Node.js 18+)
  • The skills CLI sends anonymous install data; set DISABLE_TELEMETRY=1 or DO_NOT_TRACK=1 to turn it off
  • Since 0.24.1 it can make images with oiloil credits, which you top up in the author's oiloil account. It does this only when your assistant cannot make images and your task clearly allows credits. The README does not state a price
  • To use credits it asks you once to sign in with npx github:oil-oil/oil-cli login, which is not pinned to one version
  • Since 0.25.0 it keeps work files (design candidates, screenshots, logs) in a .oil-ui folder in your project, with its own .gitignore
  • Since 0.29.1 it includes a Python script, scripts/measure_reference.py, that measures colours and boxes in a reference image you give it. It uses only standard Python and, if installed, Pillow. It makes no network calls and starts no other programs. It writes a measurements file, an outline drawing and cropped images to the folder you name, or to the current folder

Licence and author

Licence
MIT
Author
oil-oil
Source code
github.com/oil-oil/oil-ui

How we tested it

We installed it on an empty test computer on 15 Oct 2026. Installed and started in a clean test system. Not yet used in a real AI session.

Test level

Not yet used on real work.

Technical details of the test
Date
15 Oct 2026
Method
Intake sandbox run on 2026-10-15 in a clean container with no account: cloned the repository and checked its skill files, ran "npx -y skills --help".

Checked again on 4 Nov 2026

Alternatives

  • brand-identity-skill: Logos, fonts and colours for a brand, not page layouts.
  • UI UX Pro Max: A large rule book of styles and palettes, not side-by-side options that you pick from.
  • Modern Web Guidance: Teaches current browser features and accessibility. It does not explore visual styles.

FAQ

Is it free? The open-source version has an MIT licence, and the README lists no price for it. Oil UI Pro costs $9.99 one-time. You do not need Pro.

Does it update itself? No. It tells you when a new version exists. When you ask it to update, it runs Oil's own update tool from GitHub with npx, pinned to one fixed version of that tool. This needs Node.js 18 or later.

Does the skills installer collect data? Yes. The skills CLI sends anonymous usage data by default. Set DISABLE_TELEMETRY=1 or DO_NOT_TRACK=1 to turn it off.

Will it change my files when I only want a review? Not if you say so. The README example "Leave the files untouched" asks for a review only. Since 0.27.0 a review has its own read-only flow: it reports problems and suggestions, changes no files and makes no new designs, then stops.

Sources