geometric — Claude Code skill: what it does, how to install
Defines structured design system guidelines using Inter typography and neutral colors. Helpful when building accessible UI components under WCAG 2.2 AA.
npx skills add bergside/awesome-design-skills --skill geometric -a claude-codeWhat geometric does
The skill configures the coding agent to author practical design system guidelines in a clean, geometric style. It enforces a strict typography scale based on Inter and JetBrains Mono, a spacing scale from 4 to 32, and explicit color tokens such as primary #3B82F6 and surface #FFFFFF. The agent provides concrete defaults instead of vague stylistic advice.
Every component definition follows a fixed workflow. It requires token mapping, responsive behavior, edge-case handling for overflow, and interaction states across keyboard, pointer, and touch inputs.
Because the skill prioritizes WCAG 2.2 AA compliance over visual novelty, it actively rejects low-contrast combinations and missing focus indicators.
What it helps with
- generate component guidelines using fixed spacing and token scales
- define keyboard-first interaction states and visible focus styles
- produce QA review checklists for interface accessibility under WCAG 2.2 AA
- standardize typography rules around Inter and JetBrains Mono
Example prompts for the agent
- Generate a modal dialog specification following geometric design tokens
- Create interaction states and keyboard navigation rules for a dropdown menu
- Draft a design system QA checklist for primary and secondary action buttons
How to install geometric
1Skills CLI (Vercel)
npx skills add bergside/awesome-design-skills --skill geometric -a claude-code2Manually: put the files in place
~/.claude/skills/geometric/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/geometric/
1Skills CLI (Vercel)
npx skills add bergside/awesome-design-skills --skill geometric -a codex2Manually: put the files in place
.agents/skills/geometric/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add bergside/awesome-design-skills --skill geometric -a cursor2Manually: put the files in place
.cursor/skills/geometric/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install bergside/awesome-design-skills geometric2Manually: put the files in place
.github/skills/geometric/SKILL.md1Skills CLI (Vercel)
npx skills add bergside/awesome-design-skills --skill geometric -a gemini-cli2Platform CLI
gemini skills install https://github.com/bergside/awesome-design-skills --path skills/geometricManually: put the files in place
.devin/skills/geometric/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add bergside/awesome-design-skills --skill geometric -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 geometric
How to install geometric in Claude Code?
Run npx skills add bergside/awesome-design-skills --skill geometric -a claude-code in your terminal. It stores the specification directly in ~/.claude/skills/geometric/SKILL.md.
What does the geometric skill do?
It provides the agent with structured design system foundations, including color tokens, typography scales, and a standardized component authoring workflow.
Which fonts and tokens does geometric enforce?
The skill uses Inter for primary and display text, JetBrains Mono for monospace, and fixed hex tokens such as #3B82F6 for primary actions and #111827 for body text.
Source text
SKILL.md · MIT
--- name: geometric description: Geometric, structured design with clean typography, neutral colors, precise shapes, and intuitive layouts that stay out of the way. license: MIT metadata: author: typeui.sh --- <!-- TYPEUI_SH_MANAGED_START --> # Geometric Design System Skill (Universal) ## Mission You are an expert design-system guideline author for Geometric design. Create practical, implementation-ready guidance that can be directly used by engineers and designers. ## Brand ## Style Foundations - Visual style: geometric, structured, clean - 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=#3B82F6, 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 ## 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