Agent skill
cupertino-ui-consistency
Maintain Cupertino + Lumina visual consistency for the AERA frontend. Use when creating or modifying UI, CSS/tokens, layouts, components, menus/overlays, tables, charts, or interaction states in this repo.
Install this agent skill to your Project
npx add-skill https://github.com/CheekyCodexConjurer/quant-lab/tree/main/skills/cupertino-ui-consistency
SKILL.md
Cupertino Ui Consistency
Overview
Apply a consistent Cupertino-inspired layer on top of Lumina: clean, recessed surfaces, glass materials, soft shadows, and restrained hierarchy. Use the checklist to align typography, tokens, components, interactions, and accessibility.
Workflow
- Define and use tokens first (palette, type, spacing, radii, elevation, motion).
- Restyle components to match Cupertino + Lumina (materials, shapes, states).
- Validate interaction completeness and accessibility (keyboard, focus, reduced motion).
Checklist
- Typography: SF Pro Display/Inter system stack; avoid custom licensed fonts; set
font-variant-numeric: tabular-numsfor numbers. - Tokens: define palette (single blue, no purple), desaturated red, radii (squircle), shadows, elevation, spacing scale, type scale, icon sizes, and motion tokens.
- Materials: apply glass/blur for sidebar, popovers, dropdowns, sticky headers; keep soft ambient shadows.
- Components: ensure hover/active/focus-visible/disabled/loading/error states; keep weights light and rely on color/spacing.
- Overlay behavior: Esc closes, click-outside closes, focus returns to trigger, viewport-safe positioning.
- Keyboard nav: arrow keys for menus, enter/esc actions, tab order for all controls.
- Motion: Apple-like easing; 150-250ms; opacity/transform only; reduced-motion safe.
- Tables: text left, numbers right, dates centered; no vertical borders; subtle row hover and minimal sort indicators.
- Charts: minimal axes and grid; subtle hover tooltips; tabular numerals in labels.
- Forms/settings: System Settings layout with grouped sections; inspector panel or modal for edits.
- Sidebar: narrow, translucent, pill active state, subtle divider for secondary/profile items.
- Menus/dropdowns/popovers: frosted, soft shadow, consistent radius, subtle separators, full keyboard support.
- Accessibility: WCAG AA contrast, visible focus, keyboard access for all interactive elements.
- Iconography: monoline SF Symbols-like look; consistent stroke weight and sizes.
Validation
Confirm tokens are used across components, overlays meet interaction rules, and UI changes keep the Lumina aesthetic while applying Cupertino polish.
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
action_logger
Keep an audit trail of changes, commands, and verification.
size_guard
Enforce line budgets and rotate or split large context files.
analyze_repo_capabilities
Detect repo tooling and patterns, then record a dynamic manifest.
safety_validation
Validate changes against .agentignore before commit.
safe_refactor_migration
Plan and execute large refactors with shadow mode and rollback.
command_guard
Enforce .agentpolicy rules before executing commands.
Didn't find tool you were looking for?