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-auraThat writes .agents/skills/aura/.
Or with the skills CLI:
pnpm dlx skills add somosgented/aura-design-system --skill auraProcedure skills (aura-forms, verify-aura-ui, port-component-to-aura, and the others) stay a separate install:
pnpm dlx shadcn@latest add @aura/skillsThose land in .agents/skills/.
What the skill enforces
| File | Guardrail |
|---|---|
rules/colors.md | --accent-* / --gray-* steps, APCA Lc 60 / Lc 90 |
rules/typography.md | Fluid clamp scale, 17px floor on editable controls |
rules/spacing.md | 13px base, 0.5-unit steps |
rules/icons.md | @radix-ui/react-icons, className="icon", no icon margin |
rules/motion.md | transform and opacity, reduced motion |
rules/forms.md | useFormDynamic, Form, ajv validateFormData |
rules/lint.md | @shadcn/lint after UI edits |
rules/principles.md | Accessibility, consistency, control, forgiveness |
rules/surface.md | Aura 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.