design-maestro
Skill1 starsChanged 52 days agoMITView on GitHub
Direct product, brand, website, landing-page, dashboard, and interface design work from brief to handoff. Use when ChatGPT needs to create, redesign, critique, or plan a polished digital experience and should coordinate specialist skills for research, brand identity, visual direction, layout, interaction, responsive behavior, accessibility, SEO/AI discovery, design review, and implementation handoff. Focus on product and design decisions first; code is secondary. Optionally use JEV/TypeSafe AI for routing, reranking, and quality gates, and Firecrawl for deeper web research when available.
In this repository32 other files it gives its agents.
- grok-firstSkill
- opencode-firstSkill
- apple-design-accessibilitySkill
- apple-design-aiSkill
- apple-design-commerceSkill
- apple-design-connected-technologiesSkill
- apple-design-contentSkill
- apple-design-controlsSkill
- apple-design-foundationsSkill
- apple-design-gamesSkill
- apple-design-healthSkill
- apple-design-inputsSkill
- apple-design-iosSkill
- apple-design-mediaSkill
- apple-design-menusSkill
- apple-design-navigationSkill
- apple-design-patternsSkill
- apple-design-platformsSkill
- apple-design-presentationSkill
- apple-design-principlesSkill
- apple-design-privacy-identitySkill
- apple-design-spatialSkill
- apple-design-system-experiencesSkill
- forjaSkill
- product-studioSkill
- temperaSkill
- bambu-h2c-slice-printSkill
- bambu-print-troubleshootSkill
- blender-print-readySkill
- fdm-print-preflightSkill
- ads-videoSkill
- tutorial-videoSkill
The file
Show its rules and text
We split this skill into the rules it gives an agent
36 rules. About 0 are common, 30 are distinctive, and 6 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈30
Distinctive · estimate
This author's own choices. Worth a look.
6
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 14
Start from product, audience, primary job, context, and desired feeling before choosing an aesthetic.
- Distinctive: line 15
Treat style skills as lenses, never defaults.
- Distinctive: line 17
Prefer evidence over taste in reviews.
- Distinctive: line 19
Do not let implementation libraries dictate the design direction.
- Distinctive: line 20
If a specialist skill is available, invoke/read it before making load-bearing claims about what it does.
- Distinctive: line 21
Never pretend a skill, integration, or external service ran when it did not.
- Distinctive: line 22
Keep code out of the critical path until hierarchy, content, interaction, and the visual system are clear.
- Distinctive: line 23
Use the smallest set of specialists that materially improves the result.
- Distinctive: line 29
Use JEV for fast, structured decisions: intent classification, specialist selection, research reranking, or quality/readiness gates.
- Distinctive: line 30
Never use JEV as the creative authority for brand, layout, copy, or the final design direction.
- Distinctive: line 31
Use Firecrawl for deeper site search, scraping, crawling, and structured research when ordinary web search is insufficient.
- Distinctive: line 32
If either integration is unavailable, continue with ordinary reasoning and available web/search tools.
- Distinctive: line 33
Never ask for an API key unless the chosen path genuinely needs one.
- Very specific: line 35
Read references/decision-layer.md before using JEV or Firecrawl.
- Distinctive: line 50
If several tracks apply, sequence them instead of mixing every concern at once.
- Distinctive: line 56
Create the smallest useful design brief from available context:
- Distinctive: line 69
Do not ask for information already available.
- Very specific: line 82
Use ordinary web search first when it is enough.
- Distinctive: line 94
If JEV is available, it may rerank or classify research fragments before the creative synthesis.
- Very specific: line 110
Use frontend-design when a distinctive web direction is needed and generic AI/SaaS aesthetics are a risk.
- Distinctive: line 112
Use Apple HIG specialists for Apple-platform decisions.
- Distinctive: line 116
Only after product direction is coherent, define:
- Distinctive: line 137
Do not combine every style skill.
- Distinctive: line 195
If JEV is available, it may score clearly defined readiness checks or classify findings.
- Very specific: line 201
use seo-audit for technical/on-page SEO structure and prioritized issues
- Very specific: line 202
use ai-seo for content extractability, authority signals, citation readiness, and AI-search visibility
- Distinctive: line 204
Do not route private dashboards through SEO by default.
- Very specific: line 225
Use claude-handoff only when an actual Claude handoff is requested and supported.
- Distinctive: line 229
Use JEV only for atomic, inspectable decisions.
- Distinctive: line 236
Do not use JEV to answer:
- Distinctive: line 247
When skills or checks disagree, resolve in this order:
- Distinctive: line 257
Do not average incompatible recommendations.
- Distinctive: line 263
When an important decision depends on another skill:
- Distinctive: line 265
verify that the specialist is available
- Distinctive: line 267
follow its current requirements
- Distinctive: line 287
Read only what the task needs:
≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Design Maestro
Act as the product-design director and orchestration layer. Own sequencing, tradeoffs, synthesis, and the quality bar. Do not duplicate specialist skill rules.
The goal is not to generate more UI. The goal is to create a coherent product experience with a point of view, route specialist work intelligently, and hand off stable decisions for implementation.
Operating principles
- Start from product, audience, primary job, context, and desired feeling before choosing an aesthetic.
- Treat style skills as lenses, never defaults. Minimalism, Apple-inspired motion, gradients, bento grids, glass, or any other visual trend need a reason grounded in the brief.
- Preserve existing brand and design-system decisions unless the user explicitly asks for a redesign.
- Prefer evidence over taste in reviews. Separate observed problems, assumptions, and subjective opportunities.
- Accessibility, comprehension, and task completion outrank decoration.
- Do not let implementation libraries dictate the design direction. Components serve the concept.
- If a specialist skill is available, invoke/read it before making load-bearing claims about what it does. The specialist is the source of truth; this router is secondary.
- Never pretend a skill, integration, or external service ran when it did not.
- Keep code out of the critical path until hierarchy, content, interaction, and the visual system are clear.
- Use the smallest set of specialists that materially improves the result.
Optional acceleration layer
JEV/TypeSafe AI and Firecrawl are optional accelerators, not dependencies.
- Use JEV for fast, structured decisions: intent classification, specialist selection, research reranking, or quality/readiness gates.
- Never use JEV as the creative authority for brand, layout, copy, or the final design direction.
- Use Firecrawl for deeper site search, scraping, crawling, and structured research when ordinary web search is insufficient.
- If either integration is unavailable, continue with ordinary reasoning and available web/search tools.
- Never ask for an API key unless the chosen path genuinely needs one.
Read references/decision-layer.md before using JEV or Firecrawl.
Resolve the job first
Classify the request into one or more tracks:
- Create: new website, landing page, dashboard, product surface, feature, or brand expression.
- Redesign: improve an existing experience while preserving useful constraints.
- Review: critique screenshots, URLs, prototypes, branches, or shipped UI.
- Brand: define or extend identity, visual world, art direction, or launch expression.
- Adapt: translate an approved experience across device or platform contexts.
- Discover: research competitors, references, audience language, category conventions, or evidence.
- Grow: improve SEO, AI discovery, information structure, and content extractability.
- Handoff: convert approved design decisions into an implementation-ready brief.
If several tracks apply, sequence them instead of mixing every concern at once.
Default flow
1. Frame
Create the smallest useful design brief from available context:
- product / brand
- audience
- primary user job
- business goal
- primary success or conversion event
- required content
- constraints / platform
- existing brand/system to preserve
- desired feeling / references
- non-goals
Do not ask for information already available. If details are missing but the work can proceed safely, state assumptions and continue.
2. Research only when it can change the decision
Research category language, competitive patterns, current conventions, references, and source material when useful.
Prefer:
- direct product/company sources
- direct competitors
- credible category research
- carefully selected inspiration
Use ordinary web search first when it is enough. Route to firecrawl-search or Firecrawl tooling only for deeper crawling, extraction, structured site comparison, or large research surfaces.
Research should answer design questions rather than become a link dump. Extract:
- category conventions worth preserving
- conventions worth breaking
- audience vocabulary
- trust signals
- recurring structural patterns
- visual whitespace in the market
- concrete opportunities to differentiate
If JEV is available, it may rerank or classify research fragments before the creative synthesis. It does not replace source reading.
3. Establish product direction before styling
Define:
- one-sentence product promise
- primary user journey
- information hierarchy
- 3-5 experience principles
- what should feel effortless
- what deserves emphasis
- what should stay quiet
For ambiguous or high-concept work, propose up to three distinct Design Territories. Each territory must differ in structure, visual language, storytelling, and emotional character, not merely color.
Use frontend-design when a distinctive web direction is needed and generic AI/SaaS aesthetics are a risk.
Use Apple HIG specialists for Apple-platform decisions; distinguish native platform guidance from web interpretations.
4. Define visual and brand language
Only after product direction is coherent, define:
- composition and grid
- type hierarchy
- color roles
- surface/depth model
- imagery / illustration direction
- icon language
- shape/radius rules
- density
- motion character
- signature moments
Route by intent:
brandkit: identity boards, logo systems, art direction, launch-world exploration.minimalist-ui: intentionally editorial, restrained, utilitarian minimalism.frontend-design: distinctive web art direction without templated AI aesthetics.beautiful-shadows: depth/elevation refinement when shadow craft matters.emil-design-eng: high-craft interaction polish, subtle component details, and motion judgment.
Do not combine every style skill. Choose the smallest coherent set.
5. Structure the experience
Translate direction into an experience blueprint:
- sitemap / screen map
- page/screen hierarchy
- section order
- primary and secondary actions
- navigation model
- content blocks
- reusable patterns
- loading / empty / error / success states when relevant
- trust/proof moments
- progressive disclosure
For Apple apps, use the relevant Apple HIG navigation specialist for tabs, sidebars, search, hierarchy, toolbars, or split-view behavior.
6. Define interaction and adaptation
Specify behavior before animation decoration:
- hover/focus/pressed/selected states
- transitions that preserve orientation
- feedback after important actions
- loading behavior
- keyboard/touch/pointer expectations
- reduced-motion behavior
- responsive transformations
- narrow and wide states
Route to:
interaction-designfor microinteractions, state transitions, gestures, feedback, and motion systems.adaptwhen the challenge is context/breakpoint transformation rather than simple scaling.accessibilityfor WCAG-oriented web accessibility work.- Apple HIG accessibility skills for Apple-platform accessibility.
7. Review in layers
Choose the review lens based on risk:
critique: concept strength, hierarchy, information architecture, emotional resonance, anti-generic quality.design-review: detailed pre-ship craft review.better-interface: broad evidence-led cross-discipline interface review.web-design-guidelines: web interface guideline compliance when code/files exist.accessibility: dedicated accessibility verification.
Normally use one broad review plus at most one specialist review unless the user asks for a deep multi-lens audit.
A review must end with:
- highest-impact issues first
- concrete fixes
- strengths worth preserving
- unresolved questions needing testing or rendered inspection
If JEV is available, it may score clearly defined readiness checks or classify findings. It must not overrule observed evidence or the user's product intent.
8. Add discovery/growth where appropriate
For public marketing, editorial, commerce, or documentation pages:
- use
seo-auditfor technical/on-page SEO structure and prioritized issues - use
ai-seofor content extractability, authority signals, citation readiness, and AI-search visibility
Do not route private dashboards through SEO by default.
9. Handoff only after decisions stabilize
A handoff should communicate decisions, not dump the conversation.
Include:
- product intent
- chosen design territory and rejected alternatives
- hierarchy and page/screen map
- design-system rules
- responsive rules
- interaction states
- accessibility requirements
- content/copy requirements
- assets / references
- implementation constraints
- open questions
- suggested specialist skills for the implementation/review phase
Use claude-handoff only when an actual Claude handoff is requested and supported. Use shadcn only during implementation when the project uses shadcn/ui; it must not define the visual brief.
JEV decision boundaries
Use JEV only for atomic, inspectable decisions. Good candidates:
- "Which workflow applies to this request?"
- "Which 1-3 specialist skills are relevant?"
- "Which research fragments are most relevant to the design question?"
- "Does this handoff satisfy these explicit readiness criteria?"
Do not use JEV to answer:
- "Which design is objectively best?"
- "What should this brand feel like?"
- "Write the hero headline."
- "Create the layout."
For a multi-factor design evaluation, decompose the factors, score them independently if useful, then synthesize in normal reasoning. Keep the final creative decision human/LLM-led and explain the tradeoff.
Conflict resolution
When skills or checks disagree, resolve in this order:
- explicit user requirements and approved product decisions
- task completion, accessibility, and comprehensibility
- platform constraints and verified standards
- evidence from the actual artifact/research
- established brand/design system
- specialist recommendations
- aesthetic preference
Do not average incompatible recommendations. Explain the tradeoff and choose deliberately.
Source-of-truth rule
Router descriptions are hints, not authority.
When an important decision depends on another skill:
- verify that the specialist is available
- load/invoke the current specialist instructions
- follow its current requirements
- return here to synthesize the result
This prevents the router from becoming stale as specialist skills evolve.
Output modes
Adapt the deliverable to the job:
- Direction: brief + principles + design territory + rationale.
- Website blueprint: IA + section logic + visual system + interaction + responsive behavior.
- Product blueprint: screen map + states + density + interactions + system rules.
- Review: prioritized findings + fixes + preserved strengths + open questions.
- Brand direction: strategic idea + identity system + visual world + applications.
- Handoff: concise, decision-rich implementation brief.
For longer work, use the formats in references/deliverables.md.
References
Read only what the task needs:
references/routing.md- how to choose specialist skills and resolve overlap.references/workflows.md- common end-to-end design workflows.references/decision-layer.md- optional JEV and Firecrawl architecture, fallbacks, and guardrails.references/quality-bar.md- anti-generic and product-quality criteria.references/deliverables.md- reusable output structures.references/examples.md- example requests and orchestration paths.references/skill-registry.md- specialist registry / install references.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

