Valet|Docs

The design-system skill

Every Valet organization has one design-system skill. It tells agents how the organization's work should feel. Agents read it before creating or substantially rewriting an artifact.

It carries identity, not a page template. A report, dashboard, presentation, and application can take different forms while remaining recognizably yours.

Why it is special

Most skills teach an agent how to complete a task. The design-system skill shapes every artifact the organization makes. Valet selects one version for the organization and gives the complete brief to the agent.

An explicit instruction still wins. The skill guides decisions the user did not specify. It does not force one layout onto every kind of work.

What it contains

A design-system skill records the relationships that make an identity coherent:

  • identity, audience, values, and productive tensions;
  • color roles for light and dark modes;
  • typography, fallbacks, rhythm, and density;
  • surfaces, imagery, icons, data, and motion;
  • distinctive signals worth repeating;
  • accessibility adaptations and failure modes.

Light and dark modes belong to the same brief. Each palette preserves the same character instead of mechanically inverting the other.

How an organization gets one

Atlas is the default. Folio, Dispatch, and Studio are ready to use. A member can select any built-in system or edit it to create an organization-owned version.

Valet can also derive a design system from a public website. When someone creates an organization with an eligible work email, Valet reads the company website and offers that identity. A member can also provide a URL directly.

Identity, not artifact form

The skill applies while the agent makes the artifact. Valet does not restyle finished work after publication. Changing the selected system guides future creation and substantial rewrites; it does not silently change existing artifacts.

Manage the selected design system with the organization's settings in the Valet dashboard. Read Artifacts to learn how agents publish the work they create.