agentsclimarketplace

Frontend design system

Skill xuniversity/plugins-marketplace/plugins/frontend-project-starter/skills/frontend-design-system

Use when working on frontend design systems, themes, design tokens, tenant or brand overlays, visual consistency, runtime token boundaries, or token-backed Vue/CSS styling in enterprise frontend projects.From its SKILL.md

Install
npx -y skills add xuniversity/plugins-marketplace --skill frontend-design-system

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

2 things to look at

  • no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
  • 1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

4.5 KB, as published. Nobody here has run it

Frontend Design System

Use this skill before design-sensitive frontend changes, especially dashboards, workflow surfaces, portal pages, theme variables, tenant overlays, and design-token updates.

Workflow

  1. Classify the surface as System Mode, Workflow Mode, or Portal Mode.
  2. Read the relevant shared docs when present:
    • docs/design-system/ai-ui-rules.md
    • docs/design-system/component-recipes.md
    • docs/design-system/design-tokens.yaml
    • docs/design-system/runtime-token-map.md
  3. If the change is tenant or brand-specific, read docs/design-system/tenant-overrides/.
  4. Check whether each token is runtime-capable, portal-derived, or documentation-first before using it in code.
  5. For component selection in Vben projects, switch to $vben-component-rules.
  6. If design-tokens.yaml changed, run scripts/validate_design_tokens.py against the target project.
  7. Before finalizing design-sensitive Vue/CSS changes, run scripts/audit_design_tokens.py against touched runtime files and either replace drift with semantic tokens or record why the value is an allowed exception.

Non-Negotiable Rules

  • Use hsl(var(--...)), Tailwind semantic classes, or scoped brand tokens only within the correct surface.
  • Do not treat portal or brand-only tokens as global admin-page tokens.
  • Do not assume design-tokens.yaml generates CSS. The target project's runtime theme chain is the source of truth; fix the runtime bridge before relying on a new runtime token.
  • For System Mode and Workflow Mode, do not add literal hex, rgb, rgba, white, or black UI colors in runtime Vue/CSS. Use runtime-capable tokens such as --primary, --foreground, --muted-foreground, --border, --card, --success, --warning, and --destructive.
  • Treat --info as a low-emphasis information surface unless the runtime map explicitly defines it as a readable accent. Do not pass hsl(var(--info)) directly as CustomTag.color; use --primary, --success, --warning, --destructive, --foreground, or a component-supported foreground pair instead.
  • Color props on shared components are still UI colors. Pass token expressions or approved semantic names, not raw palette values, unless the value comes from persisted business data or an official brand asset.
  • Use --radius, --radius-sm, --radius-md, --radius-lg, --radius-xl, or semantic Tailwind radius utilities for corners. Fixed px radii are exceptions, not defaults.
  • For System Mode and Workflow Mode page shells, prefer the shared page/list component shell or a compact p-2/token-backed padding variable. Do not generate broad p-5 page containers unless an existing local page pattern explicitly requires it.
  • Keep governance rationale in docs or code comments, not visible UI copy. Do not surface explanatory lines such as why a list is sorted unless the user requirement explicitly asks for that on-screen message.
  • Do not add subtitles, helper copy, slogans, decorative gradients, or hardcoded brand colors unless the requirement or existing design explicitly calls for them.
  • When runtime behavior and design docs disagree, obey the current runtime chain first and update docs deliberately.
  • When using derived variables such as --radius-lg, verify that the target runtime defines them. If not, add a runtime bridge from --radius before relying on them.
  • If a runtime CSS variable is added, update design-tokens.yaml and runtime-token-map.md together when those files exist.

Token Self-Check

For changed runtime Vue/CSS/TSX files, run the audit script before final response:

python .agents/skills/frontend-design-system/scripts/audit_design_tokens.py . --paths <changed-runtime-files>

For changed design token docs, validate the YAML contract:

python .agents/skills/frontend-design-system/scripts/validate_design_tokens.py . --all

If running from this skill directory, use:

python scripts/audit_design_tokens.py <project-root> --paths <changed-runtime-files>
python scripts/validate_design_tokens.py <project-root> --all

Treat findings in docs, generated assets, charts, official brand media, and third-party embedded UI as possible exceptions; treat findings in system or workflow page styling as issues to fix. Allowed exceptions must use a nearby design-token-audit: ignore comment with a short reason.

Keep looking

Skills are one crate of 608,475. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.