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
npx -y skills add xuniversity/plugins-marketplace --skill frontend-design-systemAssembled 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
- Classify the surface as
System Mode,Workflow Mode, orPortal Mode. - Read the relevant shared docs when present:
docs/design-system/ai-ui-rules.mddocs/design-system/component-recipes.mddocs/design-system/design-tokens.yamldocs/design-system/runtime-token-map.md
- If the change is tenant or brand-specific, read
docs/design-system/tenant-overrides/. - Check whether each token is runtime-capable, portal-derived, or documentation-first before using it in code.
- For component selection in Vben projects, switch to
$vben-component-rules. - If
design-tokens.yamlchanged, runscripts/validate_design_tokens.pyagainst the target project. - Before finalizing design-sensitive Vue/CSS changes, run
scripts/audit_design_tokens.pyagainst 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.yamlgenerates 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, orblackUI colors in runtime Vue/CSS. Use runtime-capable tokens such as--primary,--foreground,--muted-foreground,--border,--card,--success,--warning, and--destructive. - Treat
--infoas a low-emphasis information surface unless the runtime map explicitly defines it as a readable accent. Do not passhsl(var(--info))directly asCustomTag.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. Fixedpxradii 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 broadp-5page 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--radiusbefore relying on them. - If a runtime CSS variable is added, update
design-tokens.yamlandruntime-token-map.mdtogether 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.