design-doctrine SKILL.md skillA

design-doctrine from plugin87/ux-ui-agent-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add plugin87/ux-ui-agent-skills/design-doctrine@git:20261006.5751441

Pins git:20261006.5751441 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
plugin87/ux-ui-agent-skills
Path
.claude/skills/design-doctrine/SKILL.md
Versions recorded
3
Latest version
git:20261006.5751441, committed Oct 6, 2026
First version recorded
Sep 13, 2026
Size
9,226 bytes
Repository stars
3,070
License
MIT

The house rules for ANY design or UI work - the verification protocol (run the gate, never claim a number), the absolute no-emoji rule, token by intent, one shared theme, the eight states, one thing leads, and output completeness. Load this FIRST whenever building, reviewing, or theming a screen, component, or token set. Installed as a plugin, this skill carries what CLAUDE.md carries in the repo.

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

# Skill: Design Doctrine

> **Step 0 — is the kit here?** This skill reads files from the kit. Check once:
> `ls ${CLAUDE_SKILL_DIR}/../../../tokens >/dev/null 2>&1 && echo KIT_OK || echo KIT_MISSING`
> On `KIT_MISSING` only the skill folders were installed, which is what
> `npx skills add` does. Say so plainly, point the user at
> `npx ux-ui-agent-skills init` or the plugin install, and stop. Do not guess the
> contents of a file you could not open.

A plugin's root `CLAUDE.md` is not loaded as project context, so the always-on
brief travels here instead. Read this before the first line of any design work,
then load the rule file for the territory you are actually in.

## Verification protocol - run gates, never claim

1. **Never state a number you did not measure.** Any contrast ratio, "WCAG pass",
   or "100%" must come from running a gate and reporting its real output. If you
   have not run it, say "not verified yet."
2. **Verify every state, not just resting.** `node ${CLAUDE_SKILL_DIR}/../../../scripts/verify_states.mjs <file> [--dark]`
   measures default, hover and focus - a button that passes at rest can fail on hover.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add plugin87/ux-ui-agent-skills/design-doctrine@sha256:8c1b3ffe964af629

The line at the top of this page pins the label git:20261006.5751441, 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_etjmoqtewq3gqjy7.svg)](https://markdownregistry.com/a/art_etjmoqtewq3gqjy7)

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

Versions

The registry has recorded 3 versions of this file, between Sep 13, 2026 and Oct 6, 2026, about one every 11 days.

versioncommittedcommitsizeaudit
git:20261006.5751441 latest2026-10-06 5751441 9,226 BA view · diff
git:20260915.f239f242026-09-15 f239f24 4,833 BA view · diff
git:20260913.8192b342026-09-13 8192b34 4,532 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 (9226 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

plugin87/ux-ui-agent-skills · 3,070 stars · license MIT · pushed 2026-10-27 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_etjmoqtewq3gqjy7
GET https://markdownregistry.com/api/v1/resolve?ref=plugin87/ux-ui-agent-skills/design-doctrine
GET https://markdownregistry.com/api/v1/blob/8c1b3ffe964af629b2106a30e4c3f52cb8a6665fce87e6300607f7477cd9dda1

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 plugin87/ux-ui-agent-skills

a11y-audit SKILL.md skill
plugin87/ux-ui-agent-skills · .claude/skills/a11y-audit/SKILL.md · Audit a UI or design against WCAG 2.2 AA/AAA and ARIA patterns, returning criterion-referenced findings with severity…
git:20261006.5751441 · audit A · 3,070 stars
apply-aesthetic SKILL.md skill
plugin87/ux-ui-agent-skills · .claude/skills/apply-aesthetic/SKILL.md · Apply a visual direction — an archetype (high-end agency, editorial minimal, brutalist, soft-SaaS, dark-tech) or one of…
git:20261006.5751441 · audit A · 3,070 stars
brandkit SKILL.md skill
plugin87/ux-ui-agent-skills · .claude/skills/brandkit/SKILL.md · Generate a complete, accessible brand design system from a brief — primitive → semantic → component DTCG tokens (color…
git:20261006.5751441 · audit A · 3,070 stars
critique SKILL.md skill
plugin87/ux-ui-agent-skills · .claude/skills/critique/SKILL.md · Adversarial design critique of the current work — render it, look at it, and argue for rejection. Run after the gates…
git:20261007.14f8d44 · audit A · 3,070 stars
data-dashboard SKILL.md skill
plugin87/ux-ui-agent-skills · .claude/skills/data-dashboard/SKILL.md · Build a dense, data-heavy screen - an analytics console or a trading terminal - with real charts drawn from tokens…
git:20261019.d271880 · audit A · 3,070 stars
design-code SKILL.md skill
plugin87/ux-ui-agent-skills · .claude/skills/design-code/SKILL.md · Generate production-ready, accessible, token-driven component code for ANY framework — React+Tailwind, Next.js…
git:20261006.5751441 · audit A · 3,070 stars
design-component SKILL.md skill
plugin87/ux-ui-agent-skills · .claude/skills/design-component/SKILL.md · Design a UI component spec to the house quality bar — anatomy, variants, sizes, the 8 states, token mapping, and…
git:20261006.5751441 · audit A · 3,070 stars
design-qa SKILL.md skill
plugin87/ux-ui-agent-skills · .claude/skills/design-qa/SKILL.md · Set up or run design QA gates — token + hardcoded-value lint, automated a11y (axe), contrast, visual regression across…
git:20261006.5751441 · audit A · 3,070 stars
design-review SKILL.md skill
plugin87/ux-ui-agent-skills · .claude/skills/design-review/SKILL.md · Review or audit a design/UI across 6 weighted dimensions with Nielsen's 10 heuristics and a prioritized findings table…
git:20261006.5751441 · audit A · 3,070 stars
design-screen SKILL.md skill
plugin87/ux-ui-agent-skills · .claude/skills/design-screen/SKILL.md · Design or build a page, screen, landing page, website, app or UI from a request - the whole job, end to end. Use this…
git:20261019.d271880 · audit A · 3,070 stars
design-tokens SKILL.md skill
plugin87/ux-ui-agent-skills · .claude/skills/design-tokens/SKILL.md · Generate, extend, or audit design tokens in DTCG format with the 3-tier architecture (primitive → semantic →…
git:20261006.5751441 · audit A · 3,070 stars
figma-integration SKILL.md skill
plugin87/ux-ui-agent-skills · .claude/skills/figma-integration/SKILL.md · Keep Figma and code in sync — map the 3-tier DTCG tokens to Figma Variables (collections + modes), sync in either…
git:20261006.5751441 · audit A · 3,070 stars

Every file in plugin87/ux-ui-agent-skills

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