Skip to content
Skills Library
Design & UX · Review & audit

ui-foundations

/ui-foundations

Use when defining or reviewing massCode UI foundation rules such as typography, renderer styling consistency, TailwindCSS v4 usage, and when raw markup starts competing with established UI text patterns.

Repository
masscode ↗
Licence
AGPL-3.0
Last repository change
15.10.2026

Assessment and security

90/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content25 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 15.10.2026, without references to retired models or APIs.

Licence

AGPL-3.0, copyleft: przeróbki udostępniane innym muszą mieć tę samą licencję.

What it does and when to use it

Use when defining or reviewing massCode UI foundation rules such as typography, renderer styling consistency, TailwindCSS v4 usage, and when raw markup starts competing with established UI text patterns.

Original author description

Use when defining or reviewing massCode UI foundation rules such as typography, renderer styling consistency, TailwindCSS v4 usage, and when raw markup starts competing with established UI text patterns.

How it works

  1. Overview
  2. Core Rules
  3. Typography
  4. Spacing And Layout Rhythm
  5. Radius And Shadows
  6. Exceptions
  7. When To Prefer This Skill
  8. Common Mistakes
Original SKILL.md headings · 66 lines, 523 words
SKILL.md preview
---
name: ui-foundations
description: Use when defining or reviewing massCode UI foundation rules such as typography, renderer styling consistency, TailwindCSS v4 usage, and when raw markup starts competing with established UI text patterns.
---

# UI Foundations

## Overview

UI в massCode должен оставаться визуально консистентным. Этот skill отвечает за базовые styling decisions: как относиться к typography, когда использовать established text patterns и как не скатываться в разрозненный renderer styling.

## Core Rules

- Базовая styling system в renderer строится на TailwindCSS v4.
- Новые UI-экраны и состояния должны продолжать существующий visual language, а не вводить локальные правила “для одного места”.
- Для стандартного app UI предпочитай семантические токены вроде `bg-background`, `text-muted-foreground`, `border-border`, `border-destructive/*` вместо raw palette-классов вроде `bg-white`, `text-black`, `text-green-500`, `bg-slate-900`.
- Typography по умолчанию строится через `UiText`.
- Не заменяй `UiText` на произвольный набор `text-*`, `font-*`, `text-muted-foreground`, если подходящий variant уже существует.
- Если `UiText` почти подходит, лучше добавить точечные классы поверх него, чем уходить в raw typography markup.

## Typography

- `UiText` — базовый источник правды для текстовых размеров и muted-state.
- `caption` и `xs` — подписи, helper text, secondary labels.
- `sm` и `base` — основной интерфейсный текст.
- `lg` и `xl` — усиленные title/value cases, когда это действительно нужно по hierarchy.
- `font-mono` — только для code-like content, IDs, counts with alignment needs, readonly generated output и подобных случаев.
- Для uppercase labels используй существующий pattern через `UiText` или согласованный tracking/uppercase стиль, а не случайную смесь utility classes в каждом месте.

## Spacing And Layout Rhythm

- Корневые screen/container wrappers обычно живут в ритме `space-y-4` или `space-y-6`.
- Внутри компактных секций чаще всего `space-y-2` или `space-y-3`.
- Grid gaps по умолчанию: `gap-2`, `gap-3`, `gap-4` в зависимости от плотности.
- Не придумывай локальный spacing-scale для одного экрана, если существующие интервалы уже покрывают задачу.
- Повторяющиеся content blocks должны иметь одинаковый padding и vertical rhythm.

## Radius And Shadows

- `rounded-md` — controls, inline boxes, compact containers.
- `rounded-lg` — card-like blocks, dialogs, overlays, dashboard sections.
- `rounded-xl` — preview-heavy surfaces и крупные visual blocks.
- `rounded-full` — pills, badges, circular handles.
- `shadow-xs` — inputs, buttons, small controls.
- `shadow-md` и `shadow-lg` — overlays, popovers, previews, где elevation реально нужна.
- Не вводи произвольные `rounded-[...]` и `shadow-[...]`, если стандартные токены уже подходят.

## Exceptions

- Raw colors допустимы, если цвет является частью самих данных или preview:
  color pickers, contrast previews, code/image export backgrounds, diagram or visualizer nodes.
- Если цвет вычисляется из контента или нужен для корректного контраста на пользовательском фоне, raw class или inline style допустимы.
- Исключения не должны становиться поводом тащить raw palette в обычный application chrome.

## When To Prefer This Skill

- Нужно понять, как оформлять текст и подписи в новом UI.
- Есть соблазн писать raw Tailwind typography вместо существующего text pattern.
- В экране начинают появляться локальные styling rules, которые расходятся с остальным renderer UI.
- Нужно принять решение на уровне визуальной базы, а не конкретного button/input/dialog.

## Common Mistakes

- Размазывать локальные визуальные исключения по фичам.
- Тащить raw palette в обычный app UI без реальной причины.
- Писать текст напрямую через произвольные utility classes там, где подходит `UiText`.
- Делать новый экран со своим spacing rhythm вместо существующего scale.
- Случайно смешивать small-control radii и preview-surface radii в одном и том же UI слое.
- Считать Tailwind поводом делать каждый экран визуально “с нуля”.

Versions

The database has no other skills named ui-foundations.

Database snapshot: 13.11.2026 · package version 78ccbe2de9fe (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 90vue-renderer-standards
    Use when editing massCode renderer code in Vue 3, especially for script setup patterns, import rules, composables, shared state, and renderer-side conventions.
  • 85taste-tailwindcss
    Replicate the visual aesthetic, typography, color tokens, and component craftsmanship of tailwindcss.com (Tailwind CSS). Use when building or restyling UI pages, landing pages, dashboards, or components to match Tailwind CSS's exact design language.
  • 90critique-typography
    Critique a rendered screen's typography — scale usage, readability, consistency, and token compliance. Use when reviewing type on a screen. For defining the scale itself, use `typography-scale` (ui-design).
  • 90architecture-standards
    Use when working in massCode and you need repo-wide architecture rules, naming conventions, decomposition boundaries, or guidance on which massCode skill to load next.
  • 100renderer-styles
    Styling patterns of the renderer (CSS tokens and the styles/*.css files, codicons, VS Code-like density, themes for UI/CodeMirror/xterm). Use when writing or reviewing CSS, colors, icons, layout or themes.
  • 100forma-foundations
    Define or refine hierarchy, typography, color, layout, spacing and visual-system tokens. Use for composition or foundation inconsistencies; not to redesign product flows or reproduce a 3D mechanism.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.