Aura Design System

Aura skill

Design guardrails for agents. One skill at .agents/skills/aura, same layout as the shadcn/ui skill.

Aura skill

Color, type, the 13px grid, icons, motion, forms, lint, and product principles live in .agents/skills/aura/. SKILL.md is the entry. rules/*.md holds Incorrect/Correct pairs. DESIGN.md at the repo root stays the narrative spec. AGENTS.md stays monorepo policy.

Always-on process rules stay in .agents/rules/ (feature-map, no-comments, design-md). Every agent finds it through the root AGENTS.md. They are not inside the skill.

Install

From the Aura registry:

pnpm dlx shadcn@latest add @aura/skill-aura

That writes .agents/skills/aura/.

Or with the skills CLI:

pnpm dlx skills add somosgented/aura-design-system --skill aura

Procedure skills (aura-forms, verify-aura-ui, port-component-to-aura, and the others) stay a separate install:

pnpm dlx shadcn@latest add @aura/skills

Those land in .agents/skills/.

What the skill enforces

FileGuardrail
rules/colors.md--accent-* / --gray-* steps, APCA Lc 60 / Lc 90
rules/typography.mdFluid clamp scale, 17px floor on editable controls
rules/spacing.md13px base, 0.5-unit steps
rules/icons.md@radix-ui/react-icons, className="icon", no icon margin
rules/motion.mdtransform and opacity, reduced motion
rules/forms.mduseFormDynamic, Form, ajv validateFormData
rules/lint.md@shadcn/lint after UI edits
rules/principles.mdAccessibility, consistency, control, forgiveness
rules/surface.mdAura wins over the upstream shadcn skill

To adapt another design to Aura as a theme, use the generate-design-md procedure skill. See DESIGN.md flavors.

When the shadcn skill disagrees on icons, forms, spacing, color, type, or restyle, the Aura skill wins.

Load this skill for UI work in JavaScript frontends. Backend and non-JavaScript projects carry only the always-on rules and the feature map. The full catalog and the order of precedence are on Skills and Rules & skills.