Source profileQuality 91/100

VincentChuWaiChow/vanguard-frontier-agentic/skills/frontend/design-token-governance-review/SKILL.md

design-token-governance-review

Reviews design-token source of truth and build pipelines for hardcoded-value drift and resolved WCAG 1.4.3/1.4.11 contrast compliance across theme variants (light, dark, high-contrast), grounded in the W3C Design Tokens format and current WCAG success criteria.

Source repository stars
21
Declared platforms
0
Static risk flags
0
Last source update
2026-08-24
Source checked
2026-08-25

Decision brief

What it does: where it fits

Reviews design-token source of truth and build pipelines for hardcoded-value drift and resolved WCAG 1. 4.

Best for

  • review a design-token source file or build/transform pipeline (Style Dictionary, Tokens Studio, W3C DTCG format),
  • audit whether hardcoded colors/spacing values have crept back into components,
  • verify WCAG 1.4.3 (text contrast) or 1.4.11 (non-text/UI-component contrast) compliance for token pairings,

Not for

  • Tasks that require unconfirmed production actions or broad system permissions.
  • Environments where the pinned source and install steps cannot be inspected.

Compatibility matrix

Platform support, with evidence labels

PlatformStatusEvidenceWhat to check
CodexNot declaredNo explicit evidencePortability before use
Claude CodeNot declaredNo explicit evidencePortability before use
CursorNot declaredNo explicit evidencePortability before use
Gemini CLINot declaredNo explicit evidencePortability before use
Open the compatibility checker

Installation

Inspect first. Install second.

The source command is displayed only when detected. A safe inspection prompt is always available so your agent can explain every action before execution.

Source-detected install commandSource
npx skills add https://github.com/VincentChuWaiChow/vanguard-frontier-agentic --skill "skills/frontend/design-token-governance-review"
Safe inspection promptEditorial

Inspect the Agent Skill "design-token-governance-review" from https://github.com/VincentChuWaiChow/vanguard-frontier-agentic/blob/5e32c1f3b9ba9e9bacae9687f55bed35b5def90f/skills/frontend/design-token-governance-review/SKILL.md at commit 5e32c1f3b9ba9e9bacae9687f55bed35b5def90f. List every install step, command, network request, credential, file read/write, external action, and rollback step. Explain whether it fits my task. Do not install or execute anything until I approve.

Workflow

What the source asks the agent to do

  1. 01

    Purpose

    A token system only delivers its promise (consistent, themeable, accessible UI) if it is actually the single source of truth. This skill catches the two most common failure modes: hardcoded values that duplicate an existing token (silent drift) and token pairings that resolve to…

    A token system only delivers its promise (consistent, themeable, accessible UI) if it is actually the single source of truth. This skill catches the two most common failure modes: hardcoded values that duplicate an exis…
  2. 02

    When to use

    Use this skill when the user asks to:

    review a design-token source file or build/transform pipeline (Style Dictionary, Tokens Studio, W3C DTCG format),audit whether hardcoded colors/spacing values have crept back into components,verify WCAG 1.4.3 (text contrast) or 1.4.11 (non-text/UI-component contrast) compliance for token pairings,
  3. 03

    Context7 Documentation Protocol

    Before making any claim about token-file format, $value/$type semantics, reference resolution, transform behavior, or Storybook a11y tooling, ground the claim in current library docs:

    Call mcpContext7resolve-library-id for the library in scope (Style Dictionary, Storybook) if not already resolved in this session.Call mcpContext7query-docs with a specific query before asserting version-specific behavior (transform config shape, DTCG $type inheritance rules, a11y-addon detection coverage, etc.).Verified library IDs for this skill's scope: Style Dictionary /style-dictionary/style-dictionary (DTCG format, $value/$type, resolveReferences/getReferences, typeDtcgDelegate for $type inheritance); Storybook /storybook…
  4. 04

    Lean operating rules

    Always compute the resolved contrast ratio from the actual token values in scope; a token's semantic name (--color-text-secondary) does not guarantee its computed contrast is compliant.

    Always compute the resolved contrast ratio from the actual token values in scope; a token's semantic name (--color-text-secondary) does not guarantee its computed contrast is compliant.Check every theme variant (light, dark, high-contrast) independently; a token pairing compliant in light mode can fail in dark mode with no code-level warning.Distinguish a documented, intentional design-system escape hatch (a one-off spacing value explicitly allowed by governance docs) from undocumented drift; only the latter is a finding.
  5. 05

    Response minimum

    inventory of hardcoded-value findings with file/line and the matching existing token,

    inventory of hardcoded-value findings with file/line and the matching existing token,computed contrast ratio per token pairing reviewed, per theme variant, with WCAG pass/fail against the correct success criterion (1.4.3 vs 1.4.11),evidence level (computed from provided token values vs inferred, and Context7-grounded vs documentation-based),

Permission review

Static risk signals and limitations

No configured static risk pattern was detected

This is not proof of safety. Runtime behavior, indirect dependencies, and hidden external systems are outside the static scan.

Evidence record

Why each signal appears

EvidenceSourceComputedTestedEditorial
SignalValueEvidence typeMeaning
Quality score91/100ComputedDocumentation, specificity, maintenance, and trust rules
Repository stars21SourceRepository attention, not individual Skill quality
Compatibility0 platformsSourceDeclared in the catalog source record
Usage guideautomated source guideEditorialGenerated or reviewed according to the visible evidence level

Pinned source

Provenance and original SKILL.md

Repository
VincentChuWaiChow/vanguard-frontier-agentic
Skill path
skills/frontend/design-token-governance-review/SKILL.md
Commit
5e32c1f3b9ba9e9bacae9687f55bed35b5def90f
License
Apache-2.0
Collected
2026-08-25
Default branch
master
View the original SKILL.md

Design Token Governance Review

Purpose

A token system only delivers its promise (consistent, themeable, accessible UI) if it is actually the single source of truth. This skill catches the two most common failure modes: hardcoded values that duplicate an existing token (silent drift) and token pairings that resolve to an inaccessible contrast ratio in some theme variant that nobody re-checked after the token value changed.

When to use

Use this skill when the user asks to:

  • review a design-token source file or build/transform pipeline (Style Dictionary, Tokens Studio, W3C DTCG format),
  • audit whether hardcoded colors/spacing values have crept back into components,
  • verify WCAG 1.4.3 (text contrast) or 1.4.11 (non-text/UI-component contrast) compliance for token pairings,
  • review a proposed rebrand, dark-mode, or high-contrast-mode token change for contrast regressions.

Context7 Documentation Protocol

Before making any claim about token-file format, $value/$type semantics, reference resolution, transform behavior, or Storybook a11y tooling, ground the claim in current library docs:

  1. Call mcp__Context7__resolve-library-id for the library in scope (Style Dictionary, Storybook) if not already resolved in this session.
  2. Call mcp__Context7__query-docs with a specific query before asserting version-specific behavior (transform config shape, DTCG $type inheritance rules, a11y-addon detection coverage, etc.).
  3. Verified library IDs for this skill's scope: Style Dictionary /style-dictionary/style-dictionary (DTCG format, $value/$type, resolveReferences/getReferences, typeDtcgDelegate for $type inheritance); Storybook /storybookjs/storybook (@storybook/addon-a11y, built on axe-core, documented as catching up to ~57% of WCAG issues automatically — never represent an addon-a11y pass as full conformance).
  4. If Context7 has no coverage for a claim, fall back to the W3C Design Tokens Community Group spec (https://tr.designtokens.org/format/) or WCAG 2.1 normative text, and mark the claim documentation-based rather than verified.
  5. Never invent a transform name, CLI flag, or token property that was not confirmed via Context7 or the W3C spec.

Lean operating rules

  • Always compute the resolved contrast ratio from the actual token values in scope; a token's semantic name (--color-text-secondary) does not guarantee its computed contrast is compliant.
  • Check every theme variant (light, dark, high-contrast) independently; a token pairing compliant in light mode can fail in dark mode with no code-level warning.
  • Distinguish a documented, intentional design-system escape hatch (a one-off spacing value explicitly allowed by governance docs) from undocumented drift; only the latter is a finding.
  • Apply WCAG 1.4.3 (4.5:1 normal text / 3:1 large text) to text-on-background token pairings and WCAG 1.4.11 (3:1) to UI-component and graphical-object contrast (borders, focus indicators, icons) — these are different success criteria with different thresholds; do not conflate them.
  • In DTCG-format token files, resolve {group.token} references and $type group-level inheritance before evaluating a value — a token's effective type/value can come from an ancestor group, not the token's own object.
  • Require that generated token build output (CSS custom properties, JS token modules) be committed with a reviewable diff against source tokens, not silently regenerated; a build-only change with no source-token diff is itself a governance finding.
  • Treat a Storybook @storybook/addon-a11y pass as partial automated evidence only (axe-core-class coverage, not full conformance); it does not substitute for manually verifying contrast math on token pairings the user is asking about.
  • Load the visual-regression-storybook-review skill instead of this one when the question is about pixel-diff baseline approval rather than token source/contrast math.
  • This is a static-review skill: read and analyze token source files, build configs, and resolved output; do not run builds, mutate token files, or execute pipeline commands.

References

Load these only when needed:

  • Token source and pipeline review — use when reviewing DTCG/Style Dictionary token structure, reference resolution, $type inheritance, transform/build config, or hunting for hardcoded-value drift against an existing token set.
  • Contrast compliance review — use when computing or verifying resolved contrast ratios for token pairings against WCAG 1.4.3/1.4.11 across theme variants.

Response minimum

Return, at minimum:

  • inventory of hardcoded-value findings with file/line and the matching existing token,
  • computed contrast ratio per token pairing reviewed, per theme variant, with WCAG pass/fail against the correct success criterion (1.4.3 vs 1.4.11),
  • evidence level (computed from provided token values vs inferred, and Context7-grounded vs documentation-based),
  • recommended governance mechanism (lint rule/CI check) to prevent recurrence,
  • security caveat if the token pipeline pulls from an external API.

Frequently asked questions

What to verify before installation and use

What does the design-token-governance-review source document cover?

Reviews design-token source of truth and build pipelines for hardcoded-value drift and resolved WCAG 1. 4.

How do I install design-token-governance-review?

The source record exposes this install command: npx skills add https://github.com/VincentChuWaiChow/vanguard-frontier-agentic --skill "skills/frontend/design-token-governance-review". Inspect the command and pinned source before running it.

Alternatives

Compare before choosing

Computed 100147

oaustegard/claude-skills

featuring

Generate hierarchical _FEATURES.md files that describe what a codebase DOES from a user/consumer perspective, anchored to source symbols via tree-sitting. Supports large complex codebases through feature-driven decomposition into sub-feature files. Uses a multi-pass synthesis: orientation → detail → overview rewrite. Use when someone says "what does this do", "document features", "feature inventory", "_FEATURES.md", or needs to understand a codebase's purpose before modifying it. Complements tre

Computed 9916

NintendaDev/unikit-ai

unikit-docs

Generate and maintain the project's TECHNICAL documentation from its codebase — scans the project structure, tech stack, and module boundaries, then writes a lean README landing page plus detailed topic pages (architecture, modules, setup, build, APIs), only the docs that are relevant. Use whenever the user wants to create, update, or validate documentation of the CODE or the project itself, e.g. "generate documentation", "create docs", "write the README", "update the project docs", "document th

Computed 9824,921

alirezarezvani/claude-skills

quality-manager-qms-iso13485

ISO 13485 Quality Management System implementation and maintenance for medical device organizations. Provides QMS design, documentation control, internal auditing, CAPA management, and certification support. Use when working with medical device quality systems, preparing for ISO 13485 audits, managing regulatory compliance documentation, setting up corrective actions, or building audit preparation programs. Useful for quality management, audit preparation, regulatory compliance, medical device d

Computed 982,672

compozy/compozy

bubbletea

Build terminal user interfaces with Go and Bubbletea framework. Use when creating TUI apps with the Elm architecture, dual-pane layouts, accordion modes, mouse/keyboard handling, Lipgloss styling, and reusable components. Includes production-ready templates, effects library, and battle-tested layout patterns from real projects. Don't use for plain-text CLI scripts without an interactive UI, web/desktop GUIs, or non-Go terminal frameworks (Ink, Textual, Ratatui).