Skip to content
cccskills
FreePublished on GitHub

design-system

Load for global UI-system changes involving CSS `@layer`, primitive/semantic/component tokens, themes, reusable MudBlazor wrappers, or design-token governance; not for one component's isolated CSS.

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

See how to install

Files included (5)

  • SKILL.md2.1 KB
  • resources/appearance-builder.md2.9 KB
  • resources/layer-architecture.md2.0 KB
  • resources/token-system.md2.7 KB
  • resources/wrapper-components.md2.5 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

ABOUTME: CSS design system skill covering @layer architecture, design tokens, and wrapper components. ABOUTME: Enforces layer ordering, token usage, and MudBlazor wrapper patterns.

Design System

Non-Inferable Rules

  1. CSS layers order (lowest→highest): reset → base → tokens → mudblazor-overrides → components → utilities. Unlayered CSS (Blazor CSS isolation, MudThemeProvider) beats all layered — by design.
  2. MudBlazor .mud-* overrides are ONLY allowed in mudblazor-overrides.css. Each override must have a comment justifying it. No bare .mud-* selectors anywhere else.
  3. All wrapper components use display: contents to be transparent in layout, then ::deep to style MudBlazor internals via CSS isolation.
  4. Design tokens follow 3 tiers: Primitives (raw values), Semantic (contextual meaning from --mud-palette-*), Component (scoped to specific components).
  5. Spacing uses a 4px grid: --isl-space-1 (4px) through --isl-space-16 (64px).
  6. Typography is fluid: H1–H6 use clamp() between 320px and 1280px viewport widths.
  7. DialogOptionsFactory provides 4 standard presets: Small, Medium, Confirmation, Editor. Always use a preset — never create DialogOptions manually.
  8. AppearanceStyleBuilder has 4 background effects: None, SoftOverlay (0.24), StrongOverlay (0.40), Blur (0.18). Methods: BuildStyle, BuildHeroStyle, BuildBannerStyle.

Resources

  • resources/layer-architecture.md — 6 CSS layers, ordering rules, override policy
  • resources/token-system.md — 3-tier token definitions, naming conventions
  • resources/wrapper-components.md — 5 wrappers, parameters, styling patterns
  • resources/appearance-builder.md — AppearanceStyleBuilder, DialogOptionsFactory, effects

Related

  • docs/internal/DESIGN_SYSTEM.md
  • .agents/skills/blazor-ui-conventions/SKILL.md
  • .agents/skills/blazor-css-isolation/SKILL.md

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

Load for Blazor/MudBlazor UI changes involving forms, dialogs, focus, keyboard navigation, landmarks, ARIA, color contrast, RTL-safe styling, or WCAG 2.2 AA tests; not for backend-only changes.

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

islamu-ngo/Event8Updated Oct 21, 2026

Load when a task asks to research, verify, compare, or look up framework/package behavior, release notes, standards, RFCs, CVEs, or unfamiliar APIs; use repository evidence first, then official docs, and not for codebase navigation alone.

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

islamu-ngo/Event8Updated Oct 21, 2026

aspire

Free

Load for Aspire AppHost work: start/stop/wait resources, inspect dashboard/logs/traces, add integrations/resources, rebuild a service, run isolated worktrees, or diagnose Aspire orchestration; not for plain dotnet apps, container-only deployments, or cloud deployment.

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

islamu-ngo/Event8Updated Oct 21, 2026

Load for authentication or authorization changes involving BFF cookies/tokens, JWT validation, claims/user ID extraction, policies, handler access checks, impersonation, or 401/403 bugs; not for UI affordance gating alone.

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

islamu-ngo/Event8Updated Oct 21, 2026

Load for Blazor BFF server work involving YARP proxy routes, cookie sessions, access-token forwarding/refresh, downstream API calls, BFF handlers, or browser-to-API auth failures; not for client component rendering or API JWT validation alone.

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

islamu-ngo/Event8Updated Oct 21, 2026

Load when editing Blazor `.razor.css`, scoped selectors, `::deep`, BEM class names, RTL/logical CSS properties, or styling nested MudBlazor components; not for global design tokens or non-Blazor CSS.

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

islamu-ngo/Event8Updated Oct 21, 2026

See all skills by islamu-ngo

Report a problem with this skill