Guide: Writing design prompts using OpenAI rules

If you build interfaces, make pet projects, or just love vibecoding in the browser — bookmark this. Plus an open-source skill that generates a design brief automatically.

Author: Michael Kokin ·

If you build interfaces, make pet projects, or just love vibecoding in the browser — this is awesome. Speaking from personal experience and pain from the janky layouts that models sometimes produce without proper context.

Bookmark this:
https://developers.openai.com/blog/designing-delightful-frontends-with-gpt-5-4

Below is my summary of the key rules. So you can skip the full read and start applying right away.

---

What is New in GPT-5.4 for Frontend

Three specific improvements that change the workflow:

---

4 Key Rules (Quick Start)

If you take just four things from the guide:

1. Start with low reasoning. For simple sites, less thinking means better results. The model does not overcomplicate.
2. Define your design system upfront. Typography, palette, layout — all before the first prompt.
3. Provide a visual reference. Screenshot, mood board, sketch — anything. The model reads rhythm, scale, and style.
4. Set the narrative. Not "make a landing page" but "tell a story: hero, proof, CTA."

---

Hard Rules: Strict Constraints

OpenAI recommends putting these in your system prompt:

---

Landing Page Structure

OpenAI suggests thinking about a page as a narrative:

1. Hero — identity and promise
2. Support — one concrete feature, offer, or proof point
3. Detail — atmosphere, workflow, product depth
4. Final CTA — conversion

Validation rule: if you remove the image from the hero and the page still works — the image is too weak.

---

Motion: 2-3 Intentional Movements

Not noise — hierarchy:

Rules: noticeable in a quick screen recording, smooth on mobile, fast, restrained, consistent. If the animation is decorative — remove it.

---

UI Copywriting

---

Pre-Ship Checklist

---

🛠 Open-Source Skill: Design Brief Generator

Based on this guide, I built an open-source skill that generates a design brief following OpenAI rules — with tokens, typography, anti-patterns, and structure. It asks 4 questions and outputs a ready-to-use 100+ line prompt (design.md).

Copy-paste it into Lovable (Stitch, v0, etc.) and you get design, not a template.

Still tweaking it. But already usable.

github.com/MichaelKokin/skillpack