design-token-architecture

design-token-architecture is a skill for Claude Code, Codex from jxoesneon/Ciel. It costs 32 tokens per session (1,366 once invoked), scanned A, original, Apache-2.0.

A set of rules for organizing design tokens, which are named values for colors, spacing, sizes, and other interface styles. It separates raw values, shared meanings, and component-specific settings.

In plain words
What is it for?
Use it when defining CSS variables, naming design tokens, or structuring a multi-layer design system.
Why use it?
It keeps a design system consistent and makes themes or individual component changes easier to manage. It also prevents components from depending directly on raw style values.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one.

Good fit Use it when defining CSS variables, naming design tokens, or structuring a multi-layer design system.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/jxoesneon/ciel/design-token-architecture
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add jxoesneon/Ciel --skill design-token-architecture
Clone the repo
git clone --depth 1 https://github.com/jxoesneon/Ciel

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for design-token-architecture

README.md
[![agentmods](https://agentmods.dev/badge/skills/jxoesneon/ciel/design-token-architecture/github.svg)](https://agentmods.dev/skills/jxoesneon/ciel/design-token-architecture)
Your own site
<a href="https://agentmods.dev/skills/jxoesneon/ciel/design-token-architecture"><img src="https://agentmods.dev/badge/skills/jxoesneon/ciel/design-token-architecture/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for design-token-architecture

Your own site · 80×15
<a href="https://agentmods.dev/skills/jxoesneon/ciel/design-token-architecture"><img src="https://agentmods.dev/badge/skills/jxoesneon/ciel/design-token-architecture.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 32 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,366 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00032 $0.01366
Opus 5 $0.00016 $0.00683
Sonnet 5 $0.00006 $0.00273
Haiku 4.5 $0.00003 $0.00137

Measured 4d ago against content hash aedeb7ab4b9e, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-12, from the pricing page.

Security

Grade A, and why

design-token-architecture scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 4d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/design-token-architecture/SKILL.md · 80 lines

How it starts

The opening of the file, as written. The whole thing — 80 lines — stays where its author put it; the contents beside it link to each section on GitHub.

CIEL ADAPTATION: Design Token Architecture

This skill formalizes the token layer of a design system — the ui-ux-design skill covers style selection and ciel-security-and-design mentions tokens only as an anti-pattern guardrail; this one defines how to actually structure them. It is advisory only: it emits token definitions and conventions, never executes them.

The Three-Layer Model

Component   (--button-bg, --card-padding)      per-component overrides
   ↑ refs
Semantic    (--color-primary, --spacing-section) purpose-based aliases
   ↑ refs
Primitive   (--color-blue-600, --space-4)       raw design values
  • Primitive: Raw values with no semantic meaning (colors, sizes, radii, shadows). Change rarely — foundational.
  • Semantic: Purpose aliases referencing primitives (--color-primary: var(--color-blue-600)). This is the layer you swap for theming.
  • Component: Component-specific tokens referencing semantic layer (--button-bg: var(--color-primary)). Enables per-component customization without touching semantics.

Rule: Each layer references ONLY the layer below it. Never let a component token reach through to a raw value, and never let a semantic token hardcode a literal.

CSS Variable Patterns

  • HSL channel triplets for colors (--color-primary: 222 47% 11%) consumed via hsl(var(--color-primary) / <alpha>) — enables opacity control without redefining tokens.
  • Dark mode = semantic override only: redefine semantic tokens under .dark; primitives and component tokens stay unchanged.
  • File organization: tokens/primitives.css, tokens/semantic.css, tokens/components.css, tokens/index.css (imports all) — or a single file with === LAYER === comment banners.
  • W3C DTCG alignment for JSON token sources: { "color": { "blue": { "600": { "$value": "#2563EB", "$type": "color" } } } }.

Spacing & Typography Scales

  • Spacing — 4px base: --space-1: 0.25rem, --space-2: 0.5rem, --space-4: 1rem, --space-6: 1.5rem, --space-8: 2rem. Semantic aliases: --spacing-component: var(--space-4), --spacing-section: var(--space-6). Components reference semantics, never raw --space-N.
  • Typography — primitive sizes: --font-size-sm: 0.875rem, --font-size-base: 1rem, --font-size-lg: 1.125rem, --font-size-xl: 1.25rem, --font-size-2xl: 1.5rem. Semantic roles: --typography-font-heading/-body/-mono (family), --text-heading/-body/-caption (size+weight+leading bundles).
  • Line-height travels with the size token, not as a separate concern: --font-size-lg: 1.125rem; --line-height-lg: 1.75.
  • Keep to the scale: arbitrary pixel values break the rhythm; add a primitive token rather than a one-off literal.

Read the full file on GitHub · 80 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 4d ago Changed aedeb7ab4b9e
  2. 8d ago First seen · 80 lines · 32 tokens per session scan A 5d4cd50d7b06

Subscribe to this mod's changes

design-token-architecture is a skill published in the GitHub repository jxoesneon/Ciel (1 stars, last pushed 5d ago), licensed Apache-2.0. It adds 32 tokens to every session and 1,366 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-03.

Related

Other skills, from other repositories

franchise-brand-enforcer

Franchise consistency is a two-front war: Visuals and Voice. This agent audits local social posts or webpages, using Vision to flag stretched/outdated logos and Text Analysis to rewrite off-brand copy into your Headquarters voice.

akhilkannur/marketing-agent-blueprints · 50 tokens

ad-visual-reverse-engineer

Why is the competition winning? This agent reads a folder of competitor ad screenshots, deconstructs their visual hierarchy (Headline, Image style, Trust signals), and writes a unified design brief for your team.

akhilkannur/marketing-agent-blueprints · 49 tokens

bio-link-optimizer

Choice paralysis kills sales. This agent audits your current 'Link in Bio' page (if provided) or researches high-converting layouts for your niche to suggest a prioritized structure that drives users toward your primary offer.

akhilkannur/marketing-agent-blueprints · 47 tokens

brand-kit-gen

Instantly create cohesive visual identity starter kits for multiple projects. This agent generates logos, seamless background patterns, and defines color palettes for an entire portfolio of brands.

akhilkannur/marketing-agent-blueprints · 36 tokens

cta-button-optimizer

Generic buttons like 'Submit' kill conversion. This agent rewrites your Call-to-Action (CTA) buttons to be value-driven and suggests color/placement changes for an entire suite of landing pages.

akhilkannur/marketing-agent-blueprints · 45 tokens

skin-creator

Create and apply a two-asset LobsterAI visual skin from the user's style description. Use only when the AI Skin Designer kit supplies the structured skinpack workflow marker; do not use for ordinary theme or image requests.

netease-youdao/LobsterAI · 48 tokens