theme-audit

theme-audit is a skill for Claude Code, Codex from murphytrueman/design-system-ops. It costs 102 tokens per session (4,053 once invoked), scanned A, original, MIT.

A checker for design-system themes, such as light, dark or brand variants. It examines whether design tokens—named values for colours, spacing and other styles—are defined and correctly used across themes and components.

In plain words
What is it for?
Use it to check theme coverage, compare light and dark modes, verify token links through semantic and component layers, and produce a severity-rated report of problems.
Why use it?
It finds missing values and components that may break or fail to change when the theme switches. This avoids searching through many files manually for hardcoded or incomplete styles.

Skill for Claude CodeCodex

Part of the design-system-ops plugin — 40 skills, 14 commands shipped together

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.

agentmods
npx agentmods add skills/murphytrueman/design-system-ops/theme-audit
Any agent
npx skills add murphytrueman/design-system-ops --skill theme-audit
Clone the repo
git clone --depth 1 https://github.com/murphytrueman/design-system-ops

Made for: Claude Code, Codex.

Or install design-system-ops, the plugin that ships this one along with the rest of its 40 skills, 14 commands.

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 theme-audit

README.md
[![agentmods](https://agentmods.dev/badge/skills/murphytrueman/design-system-ops/theme-audit.svg)](https://agentmods.dev/skills/murphytrueman/design-system-ops/theme-audit)
Your own site
<a href="https://agentmods.dev/skills/murphytrueman/design-system-ops/theme-audit"><img src="https://agentmods.dev/badge/skills/murphytrueman/design-system-ops/theme-audit.svg" alt="Measured on agentmods" height="20"></a>
Per session 102 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 4,053 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
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 $0.00102 $0.04053
Opus 5 $0.00051 $0.02027
Sonnet 5 $0.00020 $0.00811
Haiku 4.5 $0.00010 $0.00405

Measured 5d ago against content hash 7cbed91394dc, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

theme-audit 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 5d 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/theme-audit/SKILL.md · 433 lines

How it starts

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

Theme audit

A skill for auditing theme coverage and visual consistency across multiple design system themes. Identifies tokens missing from specific themes, component tier propagation failures, internal consistency violations within each theme, DTCG resolver coverage gaps, and components likely to break on theme switches. Produces a theme coverage report with severity-rated findings.

Context

Theming is where the three-tier token architecture proves its value or reveals its failures. When a system switches themes correctly, the change ripples through every component that references the semantic tier. When it does not — when components hardcode primitives or when the semantic tier is incomplete — a theme switch becomes a hunt through hundreds of files for missed overrides.

A theme audit is not about validating a single theme's visual appearance. It is about ensuring every token consumed by every component exists and is correctly defined across every theme the system claims to support. It is about catching cases where the component tier skips the semantic tier entirely, making theme switches invisible to that component.

The audit surfaces three categories of problems: coverage gaps (token defined in Theme A but not Theme B), architectural failures (component tokens that bypass the semantic tier), and internal consistency breaks (within a single theme, visual logic is violated — e.g. in dark mode, surface colours are lighter than background).

Configuration

Before producing output, check for a .ds-ops-config.yml file in the project root. If present, load:

  • system.theming — if false, exit early with a note that this skill applies only to systems with theming enabled. If true, proceed.
  • severity.* — overrides for theme-specific findings (e.g. missing_theme_value: critical for a system about to launch dark mode)
  • integrations.style_dictionary — if enabled, parse tokens via Style Dictionary v4 to auto-extract all semantic and component tokens and their resolver-defined mode values
  • integrations.figma — if enabled, pull Figma variables and their modes as the theme source
  • recurring.* — if this is a recurring run, load the previous theme audit for trend comparison

Read the full file on GitHub · 433 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. 5d ago First seen · 433 lines · 102 tokens per session scan A 7cbed91394dc

Subscribe to this mod's changes

theme-audit is a skill published in the GitHub repository murphytrueman/design-system-ops (174 stars, last pushed 13d ago), licensed MIT. It adds 102 tokens to every session and 4,053 once invoked, about $0.0005 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-08-30.

Related

Other skills, from other repositories

extract-design

Extract the full design language from any website URL. Produces 8 output files including AI-optimized markdown, visual HTML preview, Tailwind config, React theme, shadcn/ui theme, Figma variables, W3C design tokens, and CSS variables. Also runs WCAG accessibility scoring. Use when user says 'extract design', 'get…

Manavarya09/design-extract · 98 tokens

designlang-tokens

Use when styling UI for cal.com — references the extracted design system tokens instead of inventing colors, spacing, or typography.

Manavarya09/design-extract · 30 tokens

roast-my-design-system

Roast the current repo's design system with real data. Runs a deterministic scanner (no tokens, 1s) that counts everything that betrays a design system, from colours and their near-identical twins to greys, spacing values, typefaces, duplicated and never-imported components, inline styles, !important and arbitrary…

gregkozakiewicz/roast-my-design-system · 161 tokens

design-engineering

Premium design engineering skill for agentic workflows — produces high-end, distinctive UI designs using DESIGN.md as the portable contract across Pencil MCP (in-IDE canvas), Figma MCP (team handoff + design tokens), and Google Stitch (vibe exploration + AI generation). Enforces anti-generic principles, WCAG 2.2 AA…

broomva/skills · 231 tokens

generate-figma-screen

Kod veya açıklamadan Figma'da tam ekran/sayfa oluşturur. Yayınlanmış design system bileşenlerini arayıp instance olarak yerleştirir; hardcode değer yerine DS token'larını kullanır. "Figma'da ekran oluştur", "kodu Figma'ya çevir", "landing page çiz", "ekran tasarla", "generate screen", "UI'ı Figma'ya aktar"…

atezer/FMCP · 118 tokens

fmcp-intent-router

F-MCP ile ilgili herhangi bir kullanıcı talebinin ilk giriş noktası. Kullanıcının niyetini analiz eder, hangi hedef SKILL'in çalıştırılacağına karar verir, o SKILL için gereken eksik input'ları tek turda toplar, özet+onay alır ve ondan sonra hedef SKILL'i çalıştırır. "figma", "ekran oluştur", "tasarım yap", "component…

atezer/FMCP · 153 tokens