Skip to content
cccskills
FreePublished on GitHub

ui-design

Use when creating or modifying any visible UI element, adjusting spacing or typography, reviewing visual consistency, or when Lighthouse Performance drops below 90.

The English summary is being prepared. Showing the original description.

holger1411/astrodeck80 stars(GitHub 80 + cccskills 0)

Run score Not tested

See how to install

Files included (2)

  • SKILL.md2.6 KB
  • LEARNINGS.md845 B

SKILL.md (original)

Review the instructions the agent will receive before you install.

UI/UX Design Skill

Canonical Sources

This skill references the following globals — read them BEFORE starting work:

  • system/globals/typography.md — Font stack, heading scale, weights
  • system/globals/spacing.md — Section padding, grids, container widths
  • system/globals/effects.md — Border radius, shadows, card pattern
  • system/globals/imagery.md — Image formats, alt text, optimization
  • system/globals/responsiveness.md — Breakpoints, mobile-first rules

Domain

Visual Hierarchy, Spacing, Typography, OKLCH Color Theory, Layout Patterns

KPIs

MetricTargetMeasurement
Lighthouse Performance>90Lighthouse JSON → categories.performance.score * 100
First Contentful Paint<1.8sLighthouse JSON → audits.first-contentful-paint
Largest Contentful Paint<2.5sLighthouse JSON → audits.largest-contentful-paint
Cumulative Layout Shift<0.1Lighthouse JSON → audits.cumulative-layout-shift
Total Blocking Time<200msLighthouse JSON → audits.total-blocking-time

Design Consistency Checklist

  • Heading hierarchy maintained (h1 → h2 → h3, no skipping)
  • Consistent section paddings (py-20 px-6)
  • Colors only via CSS variables (text-primary, not text-blue-500)
  • Consistent border radius (rounded-xl)
  • Mobile-first responsive (all breakpoints checked: 375px, 768px, 1024px, 1280px)
  • Mobile navigation present (no hidden lg:block without mobile alternative)
  • No horizontal overflow on mobile
  • Dark mode tested

Non-Negotiable

These rules always apply — even under time pressure, even for "just a quick prototype":

  • No commit without responsive check. "We'll make it responsive later" never works — it gets forgotten and users see a broken mobile version.
  • Section padding is py-20 px-6. "A bit more room with py-32" destroys visual consistency across sections.
  • Colors only via CSS variables. "Just bg-white here" breaks dark mode immediately — without anyone noticing until they toggle.
  • No rounded-lg or rounded-md. The design system uses rounded-xl. Inconsistency is noticeable, even if individual deviations "look better."
  • Mobile-first is mandatory. Desktop-first "and then adjust" produces overflow, undersized touch targets, and missing mobile navigation.

Before Applying

Read LEARNINGS.md in this directory to avoid known anti-patterns.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Use when creating or modifying any UI element visible to the user, reviewing HTML markup, adding interactive elements, or when Lighthouse Accessibility drops below 90.

The English summary is being prepared. Showing the original description.

holger1411/astrodeck80Updated Sep 5, 2026

astro

Free

Use when creating or modifying .astro/.tsx files, configuring astro.config.mjs, working with Content Collections, or when TypeScript or build errors occur.

The English summary is being prepared. Showing the original description.

holger1411/astrodeck80Updated Sep 5, 2026

Use when creating or editing pages, blog posts, or content files, adding meta tags, or when Lighthouse SEO drops below 90.

The English summary is being prepared. Showing the original description.

holger1411/astrodeck80Updated Sep 5, 2026

qa

Free

Use when completing any task (final validation step), running audits, preparing for deployment, or when ESLint/TypeScript/build errors occur.

The English summary is being prepared. Showing the original description.

holger1411/astrodeck80Updated Sep 5, 2026

readme

Free

Use when starting work on an AstroDeck project, needing to understand the project structure, or looking up available components, sections, and layouts.

The English summary is being prepared. Showing the original description.

holger1411/astrodeck80Updated Sep 5, 2026

Use when writing or reviewing any CSS class, changing colors, modifying globals.css, or when hardcoded colors or inline styles are detected.

The English summary is being prepared. Showing the original description.

holger1411/astrodeck80Updated Sep 5, 2026

See all skills by holger1411

Report a problem with this skill