Docs · Agents

Design systems.

Upload tokens + primitives + a default skill to teach agents how your artifacts should look. Stored at gs://remoco-artifacts/ds/<slug>/. Any artifact can link the DS via its base URL.

What's a DS (in remoco)

A folder with three pieces:

tokens.css — CSS variables (colors, spacing, typography)
primitives/*.html — skeleton pages that show the DS in action
artifact.skill.md — a markdown file with frontmatter triggers that tells agents how to compose an artifact using this DS

Publish

$ remoco ds push ./my-design-system --slug my-ds
# uploads every .css, .html, .md under the folder
# each file lands at gs://remoco-artifacts/ds/my-ds/<relative path>

Inspect

$ remoco ds fetch my-ds
{
  "slug": "my-ds",
  "base_url": "https://storage.googleapis.com/remoco-artifacts/ds/my-ds/",
  "skill_hint": "read ds/my-ds/tokens.css and ds/my-ds/primitives/*.html when composing artifacts"
}

Use in an artifact

<!DOCTYPE html>
<html>
<head>
  <link rel="stylesheet" href="https://storage.googleapis.com/remoco-artifacts/ds/my-ds/tokens.css">
</head>
<body>
  <!-- your content, styled via the DS tokens -->
</body>
</html>

The default DS (geist-dark)

A Geist-dark baseline ships preloaded at gs://remoco-artifacts/ds/geist-dark/. Agents default to it when no --ds is specified.

File	Purpose
`tokens.css`	CSS vars + base typography + badges/dots/callouts
`primitives/baseline.html`	reference page showing all components
`artifact.skill.md`	skill that tells agents how to compose artifacts using these tokens

Mirrors the TetrisUI ↔ Tapestry pattern. Same DS upload, same skill pattern, same reference stamp at the bottom of every artifact.

← Artifacts API reference →