Tutorial

Oil UI open-source hands-on guide

Chapter 1 free: install the OSS pack and run one direction exploration. Later: style explorer picks, screenshot polish, failures (paid). Does not cover Oil UI Pro.

Open the free related Skill package

Chapter 1 · Half an hour: one real direction exploration

Plain talk: “Make a nice homepage” often yields the same gray rounded default — the cafeteria always scoops the same stew first. Open-source Oil UI wants the agent to name the dish (category / tone), then plate truly different samples for you to pick.

This chapter does one job: install the OSS pack → paste one prompt → get at least two previewable directions.

The zip is free (MIT). SkillBazaar ships the open-source edition only — not Oil UI Pro. Paid chapters sell explanation and debugging, not upstream copyright. Keep LICENSE / NOTICE.


Where people get stuck

  1. Treating Pro marketing copy as OSS capabilities (no full “usability / legacy / glow” track in this zip);
  2. Unpacking so the folder is not named oil-ui, so SKILL.md is never found;
  3. Asking for a full site when this chapter only needs hero direction samples.

1. Install into Cursor (~5 min)

  1. Sign in to SkillBazaar, open free Skill “Oil UI interface design (open source)”, download the zip.

  2. Unpack into your skills folder; top-level directory must be oil-ui, e.g.:

    ~/.cursor/skills/oil-ui

    You should see SKILL.md, references/, scripts/.

  3. Confirm you are not also running oil-ui-pro — upstream says they fight over the same UI requests.

  4. Start a new chat. @oil-ui if needed, or: “Please read the oil-ui skill.”

Smoke check: ask “What’s the difference between oil-ui OSS and Pro?” — if it mentions direction explorer in OSS and usability/effects in Pro, you’re good.


2. Paste this prompt

Add one crude product sentence, then send:

Use oil-ui (open-source): explore three design directions for my “weekend city hike booking” product.
Name the category and tone first, then ship previewable hero samples (HTML is fine).
The three directions must diverge in layout / type / color / hero visual — not just recolor.
Put them on a style comparison page (or clear side-by-side) for me to pick. No backend. Do not pretend Pro features exist.

If it misbehaves

  • Three skins of the same layout → “Per oil-ui: among layout, type, color, hero visual, any two directions may share at most one; rebuild layout if they look alike.”
  • Starts scaffolding the whole app → “This chapter is hero samples + comparison only.”
  • Pitches glow / form state machines → “Stay in OSS scope; note Pro ideas in the handoff, don’t block the task.”

3. Checklist

  • oil-ui/SKILL.md and references/ exist under skills
  • You have ≥2 openable previews and can say how they differ
  • You know this pack is OSS; Pro is bought upstream
  • Next time you’ll change at least: what the product is / hero subject / how many directions

All four checked → Chapter 1 done. Next: picking on the style explorer, screenshot polish, and failure recovery.

Unlock later chapters

Chapter 1 is fully free. Pay to continue with layout rules and advanced steps. (¥1.90)

  • Coming up
  • Chapter 2 · Style explorer: how to pick and tighten
  • Chapter 3 · Screenshot polish and failure garage