What does design-studio do?
<studio> is the folder that contains this SKILL.md. On Windows use python if python3 is missing, and modules/impeccable/scripts/impeccable.cmd instead of the uncooked launcher.
Load
- This file.
- Doctrine for the route: doctrine/workflow.md, doctrine/principles.md, doctrine/gate.md; doctrine/conflicts.md when modules disagree.
- Only the routed
MODULE.mdfile(s) below, then the references they point at.
Never load every module. Vendored MODULE.md files are not standalone skills.
Precedence
- The user's explicit instruction and real brand assets
- The project's
DESIGN.md/PRODUCT.md - design-studio doctrine
- The active module's rules
- ui-ux-pro-max database picks — inputs, never decisions; every pick must pass the slop floor
Route
/design-studio <route> [target]. If no route, infer from the ask.
| Intent / arg | Load | Notes |
|---|---|---|
build — landing, marketing, portfolio, public page | modules/taste/MODULE.md + modules/impeccable/MODULE.md (persuade) | ui-ux-pro-max only for stack guidelines |
app — dashboard, settings, forms, product UI, native screens | impeccable (operate) + taste references/app-screens.md | ui-ux-pro-max stack + UX guidelines |
direction — palette, fonts, style | taste library first; modules/ui-ux-pro-max/MODULE.md search second, slop-filtered | writes DESIGN.md |
review / audit / roast | modules/ai-design-review/MODULE.md and its report format | scanners below; dedupe into IDs |
polish bolder quieter typeset colorize animate harden clarify distill delight adapt onboard optimize layout overdrive shape init document extract critique audit live generate | impeccable command reference | pin/unpin disabled |
slides / deck / presentation | modules/slides/MODULE.md | template-library/ last resort; .pptx → pptx skill |
diagram (+ import mermaid|drawio|excalidraw, export) | modules/diagrams/MODULE.md + commands/ | |
| charts in an app | dataviz skill if installed, else ui-ux-pro-max charts domain | |
| long-form copy | ai-design-review copy tells; unslop skill if installed | |
hooks on|off|status | impeccable reference/hooks.md | hook policy below |
Workflow
Brief (PRODUCT.md) → Direction (DESIGN.md) → Build → Look → Gate → Report. Details: doctrine/workflow.md.
Taste working files stay in .taste-skill/. Summarize the chosen direction into DESIGN.md so every module reads one file.
Gate
Done when: looked at shipping sizes; relevant scanners ran; zero P0; every P1 justified by the brief; genericness ≤ 3/10 for new UI; SD1–SD5 pass; nothing invented; app UI has empty/loading/error; report names tiers that ran. Full table: doctrine/gate.md.
Review scanners (dedupe onto catalog IDs):
node <studio>/modules/ai-design-review/scripts/scan.mjs <target> --json
<studio>/modules/impeccable/scripts/impeccable detect <target>
node <studio>/modules/taste/scripts/lint.mjs <target>
Windows detect: <studio>\modules\impeccable\scripts\impeccable.cmd detect <target>.
Hook policy
Off by default. Never enable silently.
At the start of a build or app route in a real project, run:
<studio>/modules/impeccable/scripts/impeccable hooks status
Propose opt-in, one sentence of reason, when any of: the task will touch ≥3 UI files or span sessions; a review found ≥2 mechanical P0/P1 (contrast, gradient text, glow, overflow, design-system drift); the user asks for ongoing enforcement.
Explain: per-edit scan via .claude/settings.local.json (Claude Code) or .cursor/hooks.json (Cursor). Cursor gets per-edit checks only, no Stop deep pass. Point at <studio>/modules/impeccable/scripts/impeccable.
Respect hook.consent in .impeccable/config.local.json. Do not re-ask in that project.
If they accept: impeccable hooks on. If they decline: hooks off and do not ask again there.
Environment
| Need | Used by | If missing |
|---|---|---|
| Node 18+ | scan.mjs | skip scanner, say so |
| Node 22+ | taste draw / lint / inspect | skip taste scripts |
| Python 3 | ui-ux-pro-max, diagram verify-geometry | skip those |
| Chrome / Edge | taste inspect, impeccable URL detect | skip visual browser tier |
| Playwright | slide PDF export | skip PDF |
| python-pptx | PPT import | skip import |
Module map
| Path | Role |
|---|---|
modules/taste/ | Art direction (draw.mjs), lint/inspect |
modules/impeccable/ | Craft commands, detect, hooks |
modules/ui-ux-pro-max/ | Searchable styles / palettes / stacks |
modules/ai-design-review/ | Tells catalog, scan, review report |
modules/slides/ | HTML decks; template-library/ is implementation reference |
modules/diagrams/ | HTML/SVG diagrams |