Oil UI
คู่มือ Agent · Claude Code

การออกแบบ UI ด้วย Claude Code: ติดตั้ง Oil UI, เขียน Prompt และทำ Visual Review

Claude Code ถนัดการอ่านโครงสร้าง Repository แยกงานเป็นหลายขั้นตอน และเรียกใช้ Subagent แต่หากไม่มีแนวทางการออกแบบ คำสั่งอย่าง "build a modern landing page" ก็มักจบลงด้วยพื้นหลัง Gradient สีม่วง การ์ดซ้อนหลายชั้น และป้าย KPI ที่แต่งขึ้นเอง การติดตั้ง Oil UI ช่วยให้ Claude Code มีเวิร์กโฟลว์การออกแบบที่เป็นระบบ: ศึกษาหมวดหมู่สินค้า เปรียบเทียบแนวทางที่แตกต่างกันแบบเคียงข้างกัน และตรวจสอบหน้าเว็บที่เรนเดอร์จริงในขนาดหน้าจอจริง

สรุปประเด็นสำคัญ

ประเด็นสำคัญ 1

รัน npx skills add oil-oil/oil-ui เพื่อติดตั้ง Skill โอเพนซอร์สฟรีใน Claude Code โดยไม่ผูกมัดโปรเจกต์เข้ากับ Component Library ตัวใดตัวหนึ่ง

ประเด็นสำคัญ 2

เริ่มต้น Prompt ด้วยตัวโปรดักต์ กลุ่มเป้าหมาย ภารกิจหลักของผู้ใช้ เนื้อหาจริง และ Viewport เป้าหมาย (เช่น 1440×900 หรือ 390×844) แทนคำคุณศัพท์บอกสไตล์ที่คลุมเครือ

ประเด็นสำคัญ 3

สำหรับหน้าเว็บใหม่หรือการออกแบบใหม่ ให้สั่ง Claude Code สร้างบอร์ดเปรียบเทียบ HTML ที่มี 3 ถึง 4 แนวทางที่ต่างกันแบบเคียงข้างกัน ก่อนเขียน State สำหรับใช้งานจริง

ประเด็นสำคัญ 4

ใช้ Subagent ของ Claude Code ทำ Blind Visual Review แบบไร้บริบทที่ระยะซูม 100% และ 200% เพื่อแก้ปัญหาเรื่องระยะห่าง คอนทราสต์ และลำดับชั้นข้อมูลก่อนส่งมอบงาน

Oil UIPROพิพิธภัณฑ์ชิงหย่า · แสงและภาชนะ

ช่วยให้ผู้เข้าชมค้นพบกำหนดการ ห้องจัดแสดง และภาชนะในนิทรรศการ แสงและภาชนะ จากนั้นจองรอบเข้าชม

ภาชนะศิลาดลริมสระน้ำยามสนธยา
พิพิธภัณฑ์ชิงหย่านิทรรศการฤดูใบไม้ร่วง

แสง
และภาชนะ

2026.11.14 — 2027.02.28ห้องจัดแสดง 02
เลือกแล้วคลิกเพื่อดูเดี่ยว · ขนาดจริง
01

แสงสนธยาเหนือผืนน้ำ

ให้แสงสนธยาเต็มเฟรม วางภาชนะไว้ใกล้จุดโฟกัส และให้พาดหัว serif อยู่มุมหนึ่งอย่างสงบ

พิพิธภัณฑ์ชิงหย่าแสงและภาชนะ · ฤดูใบไม้ร่วง

วารสารแสงเช้า

ศิลาดลและผ้าลินินใต้แสงที่ลอดผ่านกิ่งหลิว

แสงบนผิวน้ำ
แสงบนดินปั้น

นิทรรศการว่าด้วยภาชนะในชีวิตประจำวันและแสงธรรมชาติ

11.14 — 02.28ห้องจัดแสดง 02
เลือกแล้วคลิกเพื่อดูเดี่ยว · ขนาดจริง
02

วารสารยามเช้า

เปิดวารสารนิทรรศการ: กริดแบบหนังสือพิมพ์รวบรวมแสงยามเช้า ภาชนะ และรายละเอียดการเข้าชม

พิพิธภัณฑ์ชิงหย่า

หมอกยามเช้า
แสงอันสงบ

ชุดชาศิลาดลข้างหน้าต่างที่มีหมอกบาง
11.14 — 02.28ห้องจัดแสดง 02
เลือกแล้วคลิกเพื่อดูเดี่ยว · ขนาดจริง
03

หน้าต่างหมอกจาง

จัดวางภาพวาดไว้ในกรอบหน้าต่างกระดาษ ให้เครื่องเคลือบศิลาดลและผืนน้ำสีอ่อนมีพื้นที่หายใจ

ติดตั้ง Oil UI Skill โอเพนซอร์สฟรีสำหรับ Claude Code
npx skills add oil-oil/oil-ui

หรือส่งข้อความนี้ให้ Claude Code โดยตรง: "Install this skill for me: run npx skills add oil-oil/oil-ui"

เหตุใด Claude Code จึงได้ประโยชน์จาก Design Skill เฉพาะทาง

เมื่อคุณสั่งให้ Claude Code สร้าง "clean, modern SaaS interface" โดยไม่มีกระบวนการกำกับ โมเดลจะดึงค่าเฉลี่ยทางสถิติจากข้อมูลฝึกสอนมาใช้: หัวข้ออยู่ตรงกลางพร้อมป้ายแคปซูลด้านบน การ์ดความกว้างเท่ากันสามใบด้านล่าง และกราฟเส้นตกแต่งหรือตัวเลข "+24%" ที่มุมการ์ด โค้ดคอมไพล์ผ่าน แต่อินเทอร์เฟซที่ได้กลับดูเหมือนเดโม AI อื่นๆ จนแยกไม่ออก

Oil UI เข้ามาเปลี่ยนลำดับการทำงาน แทนที่จะกระโดดจาก Prompt ไปเขียน Markup สุดท้ายทันที Claude Code จะศึกษาว่าหมวดหมู่โปรดักต์นั้นสื่อสารให้เข้าใจง่ายได้อย่างไร วางทิศทางภาพที่แตกต่างกันไว้บนบอร์ดเปรียบเทียบหน้าเดียว และตรวจสอบการเรนเดอร์จริงบนเบราว์เซอร์ก่อนปิดงาน

การสั่งครั้งเดียว (One-shot) เทียบกับ Claude Code ที่ใช้ Oil UI Skill
ขั้นตอนOne-shot Prompt ใน Claude Codeเวิร์กโฟลว์ Claude Code + Oil UI
จุดเริ่มต้นมักตกไปใช้กริดการ์ด SaaS สำเร็จรูปและโทนสีกลางๆ ที่ปลอดภัยเริ่มจากหมวดหมู่โปรดักต์ ภารกิจของผู้ใช้ และเนื้อหาจริง
การเลือกแนวทางได้ผลลัพธ์เดียว ถ้าไม่ตรงใจต้องเขียน Prompt เริ่มใหม่ตั้งแต่ต้นมีหน้าเปรียบเทียบแนวทางแบบเคียงข้างกันที่ 1440px หรือ 390px ในตัว
ข้อมูลและข้อความมักแต่งตัวเลขเปอร์เซ็นต์และป้ายข้อความเติมพื้นที่ขึ้นเองจัดลำดับชั้นจากฟิลด์ข้อมูลจริงในธุรกิจและตัดสิ่งรบกวนออก
การตรวจคุณภาพหยุดทันทีเมื่อโค้ดคอมไพล์ผ่านเรียก Subagent แบบ Blind Review มาตรวจวิจารณ์ทั้งหน้าและภาพครอป 200%

ติดตั้งและตั้งค่าใน 3 ขั้นตอน

คุณสามารถติดตั้ง Oil UI แบบ Global สำหรับบัญชีผู้ใช้ของคุณ หรือติดตั้งแบบ Local ภายใน Repository เพื่อให้ทั้งทีมใช้เวิร์กโฟลว์เดียวกัน

  1. รันตัวติดตั้ง Skill แล้วเลือก Claude Code

    รันคำสั่งด้านล่างใน Terminal แล้วทำตามหน้าโต้ตอบเพื่อเลือก Claude Code และขอบเขตการติดตั้งที่ต้องการ

    npx skills add oil-oil/oil-ui
  2. ตรวจสอบให้แน่ใจว่าเบราว์เซอร์บนเครื่องสามารถเรนเดอร์และแคปภาพหน้าเว็บได้

    การตรวจเช็กด้วยตาต้องอาศัยภาพหน้าจอจริงไม่ใช่การเดาจากซอร์สโค้ด ควรตรวจสอบให้ Playwright หรือระบบอัตโนมัติของเบราว์เซอร์เปิด Dev Server ที่ขนาด 1440×900 (เดสก์ท็อป) และ 390×844 (มือถือ) ได้

  3. อัปเกรดเป็น Oil UI Pro เมื่อต้องการเวิร์กโฟลว์ฉบับสมบูรณ์

    หากคุณซื้อ Oil UI Pro แล้ว ให้ติดตั้งผ่าน CLI และเมื่อติดตั้ง Pro แล้ว ไม่จำเป็นต้องติดตั้งเวอร์ชันโอเพนซอร์สควบคู่กัน

    npx github:oil-oil/oil-cli install oil-ui-pro

วิธีเขียน UI Prompt ที่ชัดเจนและได้ผลดีสำหรับ Claude Code

ลองดูผลงานที่สร้างด้วย Claude ในแกลเลอรี เช่น Margins (แอปอ่านอีบุ๊กบนแท็บเล็ตโดย Claude Opus 5.5), Echo (ผู้ช่วยเสียงโดย Claude Opus 5.5), Pickup (แอปเรียกรถโดย Claude Sonnet 5.5) และ Pinch Checkout (โมดูลชำระเงินโดย Claude Sonnet 5.5) แต่ละ Prompt ระบุชัดเจนว่าผู้ใช้คือใคร การโต้ตอบใดเป็นหัวใจของงาน และต้องรองรับสถานะใดบ้าง

ระบุผู้ใช้และภารกิจด้วยภาษาตรงไปตรงมา
แทนที่จะขอ "แอปเรียกรถที่ดูโฉบเฉี่ยว" ให้ระบุเป็น "Flow เรียกรถขนาด 390×844 ครอบคลุมการปักหมุดจุดรับ สถานะคนขับกำลังเดินทางมาแบบเรียลไทม์ และการเปลี่ยนจุดหมายกลางทาง"
ชี้ชัดการโต้ตอบจุดสำคัญ
บอก Claude Code ว่าปุ่มควบคุมหรือจังหวะเปลี่ยนผ่านใดสำคัญที่สุด เช่น การคำนวณราคาสดเมื่อกรอกโค้ดส่วนลด ลิ้นชักจดโน้ตในแอปอ่านบทความยาว หรือแอนิเมชันคลื่นเสียงตอบสนองในผู้ช่วยเสียง
กำหนด Viewport และสถานะที่เป็นรูปธรรม
ระบุขนาด Viewport และสถานะ 3–4 รูปแบบที่ต้องการให้เรนเดอร์ เพื่อให้ Agent ตรวจสอบแต่ละสถานะบนเบราว์เซอร์จริงได้
เทมเพลต UI Prompt สำหรับใช้ซ้ำใน Claude Code
ใช้ Oil UI ออกแบบอินเทอร์เฟซสำหรับ [ประเภทโปรดักต์ เช่น โมดูลชำระเงินของร้านหนังสืออิสระ]
- กลุ่มผู้ใช้และภารกิจหลัก: [เช่น นักอ่านตรวจสอบสินค้าในตะกร้า เลือกระหว่างรับที่ร้านหรือจัดส่ง ใส่โค้ดส่วนลด และชำระเงินให้เสร็จสมบูรณ์]
- การโต้ตอบหลักและสถานะ: โฟกัสที่ [การโต้ตอบหลัก] ครอบคลุม [สถานะที่ 1: ฟอร์มเริ่มต้น], [สถานะที่ 2: การคำนวณค่าจัดส่งและส่วนลดแบบเรียลไทม์] และ [สถานะที่ 3: ข้อผิดพลาดการตรวจสอบบัตรแบบ Inline พร้อมวิธีกู้คืน]
- ข้อจำกัด: ใช้ Tech Stack เดิมของโปรเจกต์ เป้าหมาย 1440×900 บนเดสก์ท็อป และ Responsive ลงมาถึงความกว้าง 390px
เสนอแนวทางการออกแบบที่แตกต่างกันก่อนเพื่อให้เราเปรียบเทียบได้ ก่อนขัดเกลาแนวทางที่เลือก

แทนที่ข้อความในวงเล็บเหลี่ยมด้วยข้อมูลจริงของธุรกิจคุณ แล้ววางลงใน Claude Code

การรัน Blind Subagent Review บนภาพหน้าจอจริง

Agent ที่เพิ่งเขียน CSS ไป 600 บรรทัดมักมองไม่เห็นเมื่อ Label สองตัวซ้อนทับกันหรือข้อความรองมีคอนทราสต์ต่ำเกินไป Oil UI แก้ปัญหานี้โดยให้ Agent หลักแคปภาพหน้าจอจากหน้าเว็บจริง แล้วส่งต่อให้ Claude Code Subagent ตัวใหม่ที่ไม่เคยเห็นโค้ดเบื้องหลังเลยมาตรวจงาน

ผู้ตรวจจะตรวจสอบทั้งภาพเต็มหน้าจอที่ 100%, ภาพครอป 200% ในส่วนควบคุมที่หนาแน่น และภาพเบลอโครงสร้างบล็อกเพื่อจับอาการส่วนบนหนักเกินไปหรือเลย์เอาต์จืดชืด จากนั้น Agent หลักจะแก้ไขจุดบกพร่องที่ได้รับรายงานก่อนส่งงานให้คุณ

ตัวอย่างจริงและ Prompt จากแกลเลอรี

ดูคอลเลกชันทั้งหมด →
Oil UI Pro

เมื่อไรควรขยับจาก Skill ฟรีไปใช้ Oil UI Pro

Skill ฟรีช่วยสร้างหน้าเว็บใหม่จากศูนย์ให้ได้งานดีไซน์ที่คมชัด ส่วน Oil UI Pro ($19.99 จ่ายครั้งเดียว) เหมาะเมื่อคุณใช้ Claude Code ปรับปรุงแอปที่รันอยู่บนโปรดักชัน สร้างพื้นที่ทำงานเดสก์ท็อปที่ข้อมูลหนาแน่น หรือต้องการรัน Blind Deep Polish สูงสุด 3 รอบพร้อมการเดินตรวจ Task แบบนับจำนวนคลิก

ดู Oil UI Pro →
คัดลอก Prompt ติดตั้ง Pro
npx github:oil-oil/oil-cli install oil-ui-pro

คำถามที่พบบ่อย

Oil UI บังคับให้ Claude Code ใช้ React, Tailwind หรือ UI Library ตัวใดตัวหนึ่งไหม?

ไม่บังคับ Oil UI ให้แนวทางการออกแบบ หลักการตัดสินเลย์เอาต์ และขั้นตอนตรวจงานด้วยภาพ Claude Code จะเขียน Markup และสไตล์ตาม Stack เดิมของคุณ ไม่ว่าจะเป็น Next.js, Vue, Svelte, HTML/CSS ล้วน หรือ Design System ภายในองค์กร

Claude Opus กับ Claude Sonnet ต่างกันอย่างไรเมื่อใช้ร่วมกับ Oil UI?

Opus มักตัดสินใจเรื่องสัดส่วนตัวอักษร จังหวะการวางหน้า และลำดับชั้นแบบ Editorial ทั้งหน้าได้เฉียบคมกว่า ส่วน Sonnet ทำงานเร็วกว่าและเหมาะกับโมดูลเฉพาะจุด การเก็บสถานะให้ครบ และการขยายงานจากแนวทางที่กำหนดไว้แล้ว

ส่งภาพหน้าจออ้างอิงให้ Claude Code ทำตามหรือดัดแปลงได้หรือไม่?

ได้ ส่งพาธของไฟล์ภาพแล้วระบุว่าต้องการถอดแบบให้ตรงระดับ Pixel-diff หรือขอยืมบรรยากาศตัวอักษรและจังหวะช่องว่างมาปรับใช้กับเนื้อหาโปรดักต์ของคุณเอง Oil UI มีเวิร์กโฟลว์แยกสำหรับทั้งสองกรณี

จะรู้ได้อย่างไรว่า Claude Code กำลังใช้ Oil UI อยู่จริง?

ใส่คำว่า "Use Oil UI" ใน Prompt แทนที่จะเทโค้ดโครงร่างแบบไม่แต่งสไตล์ออกมาทันที Claude Code จะวางกรอบ Task ของผู้ใช้ เสนอทิศทางภาพที่แตกต่างกันหรือเปิดบอร์ดเปรียบเทียบ และตรวจสอบภาพหน้าจอที่เรนเดอร์จริงก่อนจบงาน

คู่มือที่เกี่ยวข้อง

คู่มือออกแบบ UI ด้วย Codex ↗การเทียบแนวทางแบบคู่ขนาน ↗Blind Review บนหน้าจอจริง ↗