A comprehensive design operating system and language for AI coding agents based on pbakaus/impeccable. Provides a structured 24-verb design vocabulary, dual-truth artifact separation (PRODUCT.md for business truth, DESIGN.md for visual truth), 4 surface archetypes (Persuade, Operate, Read, Experience), and a deterministic Craft Floor that eliminates generic AI slop, cards-inside-cards, unearned gradients, and un-tinted grays.
Overview
Most AI models were trained on the same corporate SaaS templates, resulting in repetitive failure modes: Inter for every font, saturated purple-to-cyan gradients, centered three-card hero sections, gray text on colored backgrounds, and rounded-square icon tiles above every heading.
impeccable breaks this convergence by introducing:
Durable Context Separation: Captures durable audience, purpose, and constraints in PRODUCT.md, while isolating visual rules, tokens, and font pairings in DESIGN.md.
4 Surface Modes: Tailors visual ambition to the user's intent—Persuade (marketing/landing), Operate (dense web apps/dashboards), Read (documentation/articles), and Experience (portfolios/showcases).
The Craft Floor: Strict mechanical invariants enforced before any code is committed.
Visitor is immersed inside the work itself (portfolios, interactive showcases, media galleries).
Artifact leads from the first viewport; interface chrome recedes into the background.
Dual-Truth Artifact System: PRODUCT.md vs DESIGN.md
Impeccable strictly isolates product business truth from visual execution:
1. PRODUCT.md (Durable Context)
Created via /impeccable init. Contains:
Audience: Who uses the product, their mental model, and domain expectations.
Purpose: What core problem the surface solves.
Constraints: Hard technical limits (frameworks, browser support, compliance).
Voice: Tone and communication register (direct, authoritative, playful).
Invariants: Business rules that must never break regardless of visual styling.
2. DESIGN.md (Visual System)
Created or updated via /impeccable document. Contains:
Tokens: :root CSS custom properties for color, spacing, radius, and elevation.
Typography Scale: Display, heading, body, and monospace font pairings with explicit line heights and tracking.
Color System: Canvas, surface, borders, primary brand accents, and functional states (error, warning, success).
Component Rules: Button ergonomics, card constraints, form field states, and motion parameters.
The 24 Impeccable Design Commands
Command
Category
Objective & Actionable Playbook
Reference
craft [feature]
Build
Full shape-then-build flow with iterative visual feedback.
references/craft.md
shape [feature]
Build
Plan UX architecture, user journeys, and component boundaries before code.
references/shape.md
init
Build
Capture durable product truth and invariants in PRODUCT.md.
references/init.md
document
Build
Extract and document existing CSS tokens and component rules into DESIGN.md.
references/document.md
extract [target]
Build
Pull reusable tokens, utilities, and components into the design system.
references/extract.md
critique [target]
Evaluate
Heuristic UX design review: cognitive load, hierarchy, and clarity.
references/critique.md
audit [target]
Evaluate
Technical audit: text contrast (>=4.5:1), touch targets (>=44px), CLS, a11y.
references/audit.md
polish [target]
Refine
Final shipping pass: alignment, micro-spacings, hover/active states, borders.
references/polish.md
bolder [target]
Refine
Amplify safe, corporate, or timid designs with strong typographic scale and color.
references/bolder.md
quieter [target]
Refine
Tone down overstimulating, cluttered, or excessively saturated UIs.
references/quieter.md
distill [target]
Refine
Strip unnecessary visual noise, nested wrappers, and redundant containers.
references/distill.md
harden [target]
Refine
Robust edge-case engineering: error boundaries, empty states, text overflow, i18n.
references/harden.md
onboard [target]
Refine
Design activation flows, first-run empty states, and progressive disclosure.
references/onboard.md
animate [target]
Enhance
Add purposeful motion using physics springs and cubic-bezier curves.
references/animate.md
colorize [target]
Enhance
Introduce intentional, strategic accent hues to monochrome layouts.
references/colorize.md
typeset [target]
Enhance
Upgrade font pairings, measure (65-75ch), line height, and tracking.
references/typeset.md
layout [target]
Enhance
Fix grid rhythm, vertical cadence, flex alignments, and responsive wrapping.
references/layout.md
delight [target]
Enhance
Add memorable signature micro-interactions and tactile feedback moments.
references/delight.md
overdrive [target]
Enhance
Implement advanced shader, canvas, WebGL, or complex geometric effects.
references/overdrive.md
clarify [target]
Fix
Rewrite ambiguous microcopy, form field labels, tooltips, and error alerts.
references/clarify.md
adapt [target]
Fix
Optimize responsive behavior across mobile, tablet, desktop, and foldables.
references/adapt.md
optimize [target]
Fix
Improve rendering performance, reduce DOM depth, eliminate repaints.
references/optimize.md
live
Iterate
Visual variant mode: select live DOM nodes in browser for iterative styling.
references/live.md
generate [target]
Iterate
Autonomously generate distinct design alternatives for named elements.
references/generate.md
The Craft Floor (Strict Anti-Patterns & Refusals)
Every generated UI must satisfy the Craft Floor before completion:
[VERIFY]
- Contrast: Body text >= 4.5:1, large display >= 3:1 against computed background.
- Typography: Body measure 65-75ch, tracking >= -0.04em, no raw un-tinted gray text.
- States: Every interactive element has Default, Hover, Active, Focus-Visible, Disabled, Loading.
- Motion: Never transition: all. Never animate width, height, top, or left. Use transform and opacity.
- Browser Surfaces: Style custom scrollbars, selection highlight (::selection), and focus rings.
[REFUSE / BANNED]
- No cards nested inside cards. Cards are not a substitute for spatial hierarchy.
- No purple-to-cyan or violet-to-blue linear gradients on text, buttons, or card borders.
- No unearned blur or floating decorative glowing orbs.
- No kicker / eyebrow tags floating above headings (headings must carry their own weight).
- No pure black (#000000) or pure gray (#808080); always tint darks and neutrals from palette.
- No unicode emoji in UI copy, badges, buttons, or navigation; use clean SVG icons.
Process
Context Ingestion: Run or read PRODUCT.md to establish audience, purpose, and constraints.
Surface Archetype: Commit explicitly to Persuade, Operate, Read, or Experience.
Design System Tokenization: Declare all color, typography, spacing, and radius tokens in :root (DESIGN.md).
Execution via Command Playbook: Select and execute the matching Impeccable command (shape, craft, critique, polish, etc.).
Craft Floor Audit: Verify contrast ratios, button ergonomics, focus rings, state coverage, and ban compliance.
Delivery & Evidence: Capture rendered DOM telemetry or visual screenshots verifying zero slop and complete state coverage.
def verify_craft_floor(css_content: str) -> list[str]:
violations = []
if "transition: all" in css_content:
violations.append("Banned: 'transition: all' detected. Use explicit properties.")
if "#000000" in css_content or "#808080" in css_content:
violations.append("Banned: Untinted pure black/gray detected. Tint with palette.")
if "linear-gradient(to right, rgb(139, 92, 246)" in css_content or "from-violet" in css_content and "to-cyan" in css_content:
violations.append("Banned: Generic purple-to-cyan gradient detected.")
return violations
Verification
PRODUCT.md exists or durable business context (audience, purpose, invariants) is established.
Surface archetype is explicitly classified: Persuade, Operate, Read, or Experience.
Design tokens declared at :root for color, typography, spacing, and radius.
Zero unearned cards-in-cards or centered 3-card hero sections.
Text contrast meets WCAG AA (>= 4.5:1 for body, >= 3:1 for display).
Motion adheres to physics easing (cubic-bezier or spring); zero transition: all.
Interactive controls provide default, hover, active press, focus-visible, and disabled states.
Zero emojis in UI components; SVG vector iconography used exclusively.
Anti-Rationalization Table
Rationalization
Reality
"A centered 3-card layout looks standard for SaaS."
It is the ultimate generic AI trope. Ground the layout in the surface mode (Persuade/Operate) with authentic visual hierarchy.
"Purple-to-cyan gradient makes the hero button pop."
Saturated tech gradients look dated and amateur. Use high-contrast solid brand fills or subtle dark glass with crisp 1px borders.
"I'll use Inter because it's clean and safe."
Defaulting to Inter for every project signals lack of intent. Pick a deliberate display and body pairing that reflects the product voice.
"Cards inside cards help group related settings."
Nested cards create claustrophobic visual clutter. Use typography scale, hairline dividers, and intentional whitespace for grouping.
"We can add focus rings and keyboard states later."
Accessible focus states (:focus-visible) are foundational. Without them, keyboard navigation is completely broken.
"Emoji make the buttons feel friendly and modern."
Emojis break enterprise brand integrity and render inconsistently across OS platforms. Always use crisp SVG vector icons.
Sub-Skills & Specialized Playbooks
Sub-Skill
Trigger / Kasus Penggunaan
Berkas Referensi
emil-design-skills
Refining interface motion, UI craft, animation standards, and prototyping decisions
Run npx get-skill add oyi77/impeccable in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.
Use when designing, redesigning, shaping, critiquing, auditing, polishing, animating, or hardening frontend interfaces: websites, dashboards, SaaS apps, mobile screens. Enforces 24 design commands, PRODUCT.md/DESIGN.md artifacts, 4 surface modes (Persuade, Operate, Read, Experience), and strict craft floor against generic AI slop. It is listed under Web & Frontend on SkillMD.
This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.
This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.
Yes. Installing skills from SkillMD is free. This skill is licensed under Apache-2.
oyi77 (@oyi77) published this skill. Their other Agent Skills are listed on their SkillMD profile.