Agent skill · cognitedata
aura-review
Checks how well an app uses Aura, Cognite's design system: what fraction of its components are Aura vs. custom-built, whether any custom components should really have been an existing Aura component, and whether Aura components got styled in ways that break the design system's own rules. Runs fully automatically by scanning the app's source and checking it against Aura's docs — no back-and-forth, so it also works unattended in CI. Writes a plain-language report to aura-review/report.md and a machine-readable aura-review/stats.json. Use when asked to run an Aura audit, check Aura compliance, or score how compliant an app is with the Aura design system.
What it needs
About 7k tokens when loaded.
What this skill does
Aura Review An objective, code-level audit of Aura usage in a generated app: did the app use Aura where Aura applies, and did it use the Aura components it did reach for correctly? This skill never asks the user anything. It is designed to run unattended — inside a CI job on a nightly schedule, or by hand — and to always finish with a report and a machine-readable stats file. The one rule that matters more than any step below Only flag something as wrong if it is already written down in either DESIGN.md or the public Aura docs. If you notice something that feels wrong but isn't documented anywhere, do not invent a rule to justify flagging it, that isn't a fair test of an app built against documentation that never mentioned the rule. Instead, note it as a suggestion for the docs and move on. This matters because these reports get used to tell people "Aura says you did X wrong" — that claim has to be traceable to something they could have read. Likewise, when judging whether a custom component "could have been Aura", only say so when you can point at a specific Use when bullet for a named Aura component that matches — otherwise mark it undecided rather than guess. Sources of truth (v1, Storybook is deliberately out of scope for now) Source Location Use it for ------------------------------- --------------------------------------------------------- ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ DESIGN.md <app-dir>/nodemodules/@cognite/aura/DESIGN.md Tokens, per-component "Use when" / "Use something else when" / "Dos and don'ts" / "Behavior", layout patterns Aura docs site https://docs.cognite.com/aura-design-system Foundations (tokens, accessibility, design heuristics) and per-component Primitives pages for anything DESIGN.md doesn't cover — DESIGN.md's own "Docs reference" links here per component Flows community components site h …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills cognitedata/aura-review