modern — Claude Code skill: what it does, how to install
Generates editorial design system specs with IBM Plex Serif typography and minimal color tokens. Helps build WCAG 2.2 AA compliant UI rules and review checklists.
npx skills add bergside/awesome-design-skills --skill modern -a claude-codeWhat modern does
The skill instructs the coding assistant to act as a design system guideline author in a clean editorial aesthetic. It locks in specific foundations: IBM Plex Serif for body and display text, JetBrains Mono for monospace snippets, a font scale from 12 to 32, and a spacing scale of 4, 8, 12, 16, 24, and 32. The color palette centers on #553F83 for primary and surface layers, alongside #111111 and white.
Outputs follow a structured workflow. The agent defines component anatomy, responsive variations, and states: default, hover, focus-visible, active, disabled, loading, and error. It covers pointer, touch, and keyboard interactions.
The skill strictly enforces WCAG 2.2 AA and explicitly prioritizes accessibility over decorative visual choices whenever a conflict arises. Each generated guideline finishes with a QA checklist suitable for pull request reviews.
What it helps with
- define component anatomy and interaction states for keyboard and touch
- standardize typography around IBM Plex Serif and JetBrains Mono
- generate WCAG 2.2 AA accessibility acceptance criteria
- draft migration notes for inconsistent legacy interface elements
Example prompts for the agent
- Create a button specification using the modern design system with focus-visible and loading states.
- Generate a WCAG 2.2 AA QA checklist for our modal dialog using modern tokens.
- Define the spacing and color token hierarchy for a content card under modern rules.
How to install modern
1Skills CLI (Vercel)
npx skills add bergside/awesome-design-skills --skill modern -a claude-code2Manually: put the files in place
~/.claude/skills/modern/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/modern/
1Skills CLI (Vercel)
npx skills add bergside/awesome-design-skills --skill modern -a codex2Manually: put the files in place
.agents/skills/modern/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add bergside/awesome-design-skills --skill modern -a cursor2Manually: put the files in place
.cursor/skills/modern/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install bergside/awesome-design-skills modern2Manually: put the files in place
.github/skills/modern/SKILL.md1Skills CLI (Vercel)
npx skills add bergside/awesome-design-skills --skill modern -a gemini-cli2Platform CLI
gemini skills install https://github.com/bergside/awesome-design-skills --path skills/modernManually: put the files in place
.devin/skills/modern/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add bergside/awesome-design-skills --skill modern -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about modern
How to install modern in Claude Code?
Run npx skills add bergside/awesome-design-skills --skill modern -a claude-code in your terminal.
What does the modern skill do?
It provides instructions for generating design system documentation in an editorial aesthetic. It specifies typography scales, spacing tokens, and accessibility rules for interface components.
Which fonts and color tokens are defined in modern?
The foundation requires IBM Plex Serif for display and body text, and JetBrains Mono for monospace blocks. It sets primary and surface tokens to #553F83, secondary to #111111, and text to #ffffff.
Source text
SKILL.md · MIT
--- name: modern description: Contemporary editorial style with serif typography, minimal palettes, and clean layouts for polished digital products. license: MIT metadata: author: typeui.sh --- <!-- TYPEUI_SH_MANAGED_START --> # Modern Design System Skill (Universal) ## Mission You are an expert design-system guideline author for Modern . Create practical, implementation-ready guidance that can be directly used by engineers and designers. ## Brand Ship software peacefully ## Style Foundations - Visual style: modern, minimal, clean, editorial - Typography scale: 12/14/16/20/24/32 | Fonts: primary=IBM Plex Serif, display=IBM Plex Serif, mono=JetBrains Mono | weights=100, 200, 300, 400, 500, 600, 700, 800, 900 - Color palette: primary, secondary | Tokens: primary=#553F83, secondary=#111111, success=#16A34A, warning=#D97706, danger=#DC2626, surface=#553F83, text=#ffffff - Spacing scale: 4/8/12/16/24/32 ## Accessibility WCAG 2.2 AA, keyboard-first interactions, visible focus states ## Writing Tone concise, confident, helpful ## Rules: Do - prefer semantic tokens over raw values - preserve visual hierarchy - keep interaction states explicit ## Rules: Don't - avoid low contrast text - avoid inconsistent spacing rhythm - avoid ambiguous labels ## 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