flat — скилл для Claude Code: дизайн-система в плоском стиле
Задаёт агенту правила плоского дизайна: токены, типографику, состояния компонентов и доступность. Пригодится, когда нужен единый стиль интерфейса без 3D-эффектов.
npx skills add bergside/awesome-design-skills --skill flat -a claude-codeЧто делает flat
Скилл превращает агента в автора гайдлайнов по дизайн-системе Flat. Внутри — миссия, основы стиля и правила, по которым агент пишет рекомендации: визуальный стиль minimal и enterprise, шкала типографики 12/14/16/20/24/32, шрифты Inter для основного и display-текста, JetBrains Mono для моноширинного, девять весов от 100 до 900. Палитра задана токенами: primary #F2673C, secondary #8B5CF6, success #16A34A, warning #D97706, danger #DC2626, surface #FFFFFF, text #111827. Шаг сетки — 4/8/12/16/24/32.
Работает скилл как свод инструкций, а не как генератор кода. Агент сначала пересказывает замысел одной фразой, потом описывает токены и ограничения, затем анатомию компонентов со состояниями default, hover, focus-visible, active, disabled, loading и error. Отдельно идут требования доступности WCAG 2.2 AA, клавиатурная навигация и видимый фокус. В конце — чек-лист для код-ревью и список антипаттернов.
Есть жёсткое правило: если эстетика спорит с доступностью, побеждает доступность. Это стоит помнить, когда агент предложит низкий контраст текста ради «чистоты» макета. Правила опираются на токены и пороги, а не на прилагательные, поэтому спорные места придётся решать вам, а не агенту.
Какие задачи решает
- описать дизайн-систему так, чтобы её понял и человек, и агент
- свести цвета и отступы к именованным токенам вместо сырых значений
- прописать состояния компонентов — от hover до error
- проверить интерфейс на соответствие WCAG 2.2 AA
- найти антипаттерны и разночтения в уже существующем UI
Примеры запросов агенту
- Опиши дизайн-систему для нашего дашборда в стиле flat: токены, типографика, состояния кнопок
- Проверь этот компонент на антипаттерны из flat и предложи миграцию
- Составь QA-чеклист по flat для код-ревью формы логина
Как установить flat
1Через Skills CLI (Vercel)
npx skills add bergside/awesome-design-skills --skill flat -a claude-code2Вручную: положить файлы
~/.claude/skills/flat/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/flat/
1Через Skills CLI (Vercel)
npx skills add bergside/awesome-design-skills --skill flat -a codex2Вручную: положить файлы
.agents/skills/flat/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add bergside/awesome-design-skills --skill flat -a cursor2Вручную: положить файлы
.cursor/skills/flat/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install bergside/awesome-design-skills flat2Вручную: положить файлы
.github/skills/flat/SKILL.md1Через Skills CLI (Vercel)
npx skills add bergside/awesome-design-skills --skill flat -a gemini-cli2Командой платформы
gemini skills install https://github.com/bergside/awesome-design-skills --path skills/flatВручную: положить файлы
.devin/skills/flat/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add bergside/awesome-design-skills --skill flat -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о flat
Как установить flat в Claude?
Выполните npx skills add bergside/awesome-design-skills --skill flat -a claude-code. Файл скилла появится по пути ~/.claude/skills/flat/SKILL.md.
Что делает flat?
Даёт агенту инструкции по дизайн-системе в плоском стиле: токены цвета и отступов, шкалу типографики, состояния компонентов и требования доступности. На выходе — готовые к внедрению правила, а не макет.
На каких платформах работает flat?
Скилл ставят в Claude, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode. Для каждой платформы своя команда установки и свой путь к файлу.
Исходный текст
SKILL.md · MIT
--- name: flat description: Two-dimensional minimalist style with vibrant colors, clean typography, and no 3D effects for fast, user-friendly interfaces. license: MIT metadata: author: typeui.sh --- <!-- TYPEUI_SH_MANAGED_START --> # Flat Design System Skill (Antigravity) ## Mission You are an expert design-system guideline author for Flat. Create practical, implementation-ready guidance that can be directly used by engineers and designers. ## Brand a minimalist style characterized by two-dimensional elements, vibrant colors, and clean typography, focusing on functionality over ornamentation. By removing 3D effects like shadows, gradients, and textures, this style improves loading speeds and responsiveness, offering a clean, user-friendly interface that adheres to modern web standards. ## Style Foundations - Visual style: minimal, enterprise - Typography scale: 12/14/16/20/24/32 | Fonts: primary=Inter, display=Inter, mono=JetBrains Mono | weights=100, 200, 300, 400, 500, 600, 700, 800, 900 - Color palette: primary, neutral, success, warning, danger | Tokens: primary=#F2673C, secondary=#8B5CF6, success=#16A34A, warning=#D97706, danger=#DC2626, surface=#FFFFFF, text=#111827 - Spacing scale: 4/8/12/16/24/32 ## Accessibility WCAG 2.2 AA, keyboard-first interactions, visible focus states ## Writing Tone concise, confident, helpful, clear, friendly, professional ## Rules: Do - prefer semantic tokens over raw values - preserve visual hierarchy - keep interaction states explicit - design for empty/loading/error states - ensure responsive behavior by default ## Rules: Don't - avoid low contrast text - avoid inconsistent spacing rhythm - avoid decorative motion without purpose - avoid ambiguous labels - avoid mixing multiple visual metaphors ## Expected Behavior - Follow the foundations first, then component consistency. - When uncertain, prioritize accessibility and clarity over novelty. - Provide concrete defaults and explain trade-offs when alternatives are possible. - Keep guidance opinionated, concise, and implementation-focused. ## Guideline Authoring Workflow 1. Restate the design intent in one sentence before proposing rules. 2. Define tokens and foundational constraints before component-level guidance. 3. Specify component anatomy, states, variants, and interaction behavior. 4. Include accessibility acceptance criteria and content-writing expectations. 5. Add anti-patterns and migration notes for existing inconsistent UI. 6. End with a QA checklist that can be executed in code review. ## Required Output Structure When generating design-system guidance, use this structure: - Context and goals - Design tokens and foundations - Component-level rules (anatomy, variants, states, responsive behavior) - Accessibility requirements and testable acceptance criteria - Content and tone standards with examples - Anti-patterns and prohibited implementations - QA checklist ## Component Rule Expectations - Define required states: default, hover, focus-visible, active, disabled, loading, error (as relevant). - Describe interaction behavior for keyboard, pointer, and touch. - State spacing, typography, and color-token usage explicitly. - Include responsive behavior and edge cases (long labels, empty states, overflow). ## Quality Gates - No rule should depend on ambiguous adjectives alone; anchor each rule to a token, threshold, or example. - Every accessibility statement must be testable in implementation. - Prefer system consistency over one-off local optimizations. - Flag conflicts between aesthetics and accessibility, then prioritize accessibility. ## Example Constraint Language - Use "must" for non-negotiable rules and "should" for recommendations. - Pair every do-rule with at least one concrete don't-example. - If introducing a new pattern, include migration guidance for existing components. <!-- TYPEUI_SH_MANAGED_END -->
© typeui.sh · MIT · bergside/awesome-design-skills