token-foundations SKILL.md skillA

token-foundations from tonygorb/skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add tonygorb/skills/token-foundations@git:20261013.8f735ab

Pins git:20261013.8f735ab in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
tonygorb/skills
Path
skills/token-foundations/SKILL.md
Versions recorded
2
Latest version
git:20261013.8f735ab, committed Oct 13, 2026
First version recorded
Oct 13, 2026
Size
14,083 bytes
Repository stars
2
License
MIT

Build or audit semantic design tokens in OKLCH, light and dark. Use when the user says "set up design tokens", "audit the token foundation" or "OKLCH colour scales".

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Token foundations

Build the token layer a product's UI stands on, or audit the one it has. Colour in OKLCH, a
semantic layer over raw scales, light and dark from day one, small scales for type, space and
radius. Structure stays boring so every screen built on it comes out consistent.

This skill works on the tokens themselves. To sweep components for hard-coded colours and swap in
tokens, use `polish-design-system` after this.

## The rule underneath

Three layers, strictly separate.

1. **Primitives.** Raw values with no meaning: `color.brand.500`, `spacing.4`, `radius.md`.
2. **Semantic tokens.** Say what a value is for and point at a primitive: `background`,
   `surface.default`, `text.primary`, `action.primary`. Every colour role declares a light and a
   dark value.
3. **Component tokens.** Only when a reusable component needs one: `button.height.md`,
   `card.radius`. Never per page.

Components use semantic and component tokens only. Never primitives, never raw values.

Keep one source of truth. It can be a tokens JSON file that generates the theme CSS, or the theme
CSS itself. Everything else is derived from it. Never hand-maintain two copies.

## Steps
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add tonygorb/skills/token-foundations@sha256:ef476d8eb1904d3d

The line at the top of this page pins the label git:20261013.8f735ab, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_miya6dguz6do5zla.svg)](https://markdownregistry.com/a/art_miya6dguz6do5zla)

1 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 2 versions of this file, all committed on Oct 13, 2026.

versioncommittedcommitsizeaudit
git:20261013.8f735ab latest2026-10-13 8f735ab 14,083 BA view · diff
git:20261013.bc9e4372026-10-13 bc9e437 12,827 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (14083 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

tonygorb/skills · 2 stars · license MIT · pushed 2026-10-13 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_miya6dguz6do5zla
GET https://markdownregistry.com/api/v1/resolve?ref=tonygorb/skills/token-foundations
GET https://markdownregistry.com/api/v1/blob/ef476d8eb1904d3da6809a81a0b65baf6c0539567368276e310b94918366f8e6

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from tonygorb/skills

concept-lab SKILL.md skill
tonygorb/skills · skills/concept-lab/SKILL.md · Build 3-5 real concepts side by side and let the user pick one. Use when the user says "show me options", "explore some…
git:20261013.8f735ab · audit A · 2 stars
design-within-what-exists SKILL.md skill
tonygorb/skills · skills/design-within-what-exists/SKILL.md · Change a screen with the patterns it already has, not new ones. Use when the user says "redesign this", "restyle this…
git:20261013.8f735ab · audit A · 2 stars
evolve SKILL.md skill
tonygorb/skills · skills/evolve/SKILL.md · Audit one part of the code and rank what to improve. Changes nothing. Use when the user asks "is this outdated" or "how…
git:20261013.bc9e437 · audit A · 2 stars
polish-design-system SKILL.md skill
tonygorb/skills · skills/polish-design-system/SKILL.md · Find hard-coded colours, propose tokens, apply them once approved. Use when the user says "polish the design system"…
git:20261013.8f735ab · audit A · 2 stars
review-a-screen SKILL.md skill
tonygorb/skills · skills/review-a-screen/SKILL.md · Check a screen in the browser at real sizes, like a designer would. Use when the user says "review this screen", "check…
git:20261013.bc9e437 · audit A · 2 stars
tokens-to-figma SKILL.md skill
tonygorb/skills · skills/tokens-to-figma/SKILL.md · Push a codebase's design tokens into Figma as variables and modes. Use when the user says "sync tokens to Figma"…
git:20261013.8f735ab · audit A · 2 stars
unugly SKILL.md skill
tonygorb/skills · skills/unugly/SKILL.md · Find what makes AI-built UI look generic, fix it once approved. Use when the user says "this looks AI-generated", "make…
git:20261013.8f735ab · audit A · 2 stars
verify-work SKILL.md skill
tonygorb/skills · skills/verify-work/SKILL.md · Prove a change works with real checks before calling it done. Use before saying work is done, or when the user says…
git:20261013.bc9e437 · audit A · 2 stars
wrap-up SKILL.md skill
tonygorb/skills · skills/wrap-up/SKILL.md · Close a task: list the changes, fix stale docs, run checks, draft the commit. Use when the user says "wrap up" or…
git:20261013.8f735ab · audit A · 2 stars

Every file in tonygorb/skills

Browse by kind, by grade A, or by owner.