design-doctrine
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.
Install / Use
npx skills add plugin87/ux-ui-agent-skills --skill design-doctrineInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
MarketingSupported Platforms
Our assessment of design-doctrine
design-doctrine scores 80/100 on our quality scale, 605th of 644 Marketing skills we index.
Its SKILL.md is 4.7 KB long, split into 5 sections and no code examples: a solid amount of guidance for an agent.
With 1,454 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated about 2 months ago, so design-doctrine is actively maintained.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-10-03. Automated pattern scan on 2026-10-03. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
design-doctrine compared with similar skills
All 4 of these similar skills score higher than design-doctrine; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| design-doctrine (this skill)by plugin87 | 80 | 1.5k | 2mo ago | SKILL.md |
| taste-skillby Leonxlnx | 100 | 117.0k | 8d ago | CLAUDE.md |
| Claude-Code-Game-Studiosby Donchitos | 100 | 39.8k | 7d ago | CLAUDE.md |
| x402by browser-use | 100 | 121.0k | 3d ago | SKILL.md |
| algorithmic-artby anthropics | 100 | 177.9k | 55d ago | SKILL.md |
Frequently asked questions
- How do I install design-doctrine?
- Run
npx skills add plugin87/ux-ui-agent-skills --skill design-doctrine. The install tabs above show the steps for each supported agent. - Which AI agents does design-doctrine work with?
- It is written for Claude Code, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is design-doctrine safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is design-doctrine still maintained?
- The repository was last updated about 2 months ago, so design-doctrine is actively maintained.
Skill content
View source on GitHubname: design-doctrine description: 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. invocation: model
Skill: Design Doctrine
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
- 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."
- Verify every state, not just resting.
node scripts/verify_states.mjs <file> [--dark]measures default, hover and focus - a button that passes at rest can fail on hover. - One command before reporting done:
node scripts/accuracy_report.mjs. Report the realN/Nline. It is all-or-nothing. - Build with the gates, not after them. Fix and re-run until green; never announce success between failures.
- Render and LOOK. Gates pass while a UI is still visibly broken. Screenshot the harness in both themes, click every control, and confirm the state changed.
- Responsive is gated too:
node scripts/verify_responsive.mjs <file|dir>- no horizontal overflow at 280/320/414px. - Honest scope. The gates prove objective correctness. They never prove taste.
For that, run
/critiqueand look at the work yourself. - SKIPPED is not a pass. With no browser installed a render gate prints
SKIPPEDand exits 0, reporting nothing. Run single render gates behindDS_REQUIRE_BROWSER=1so that becomesREQUIRED, FAILING, and fix it withnpx playwright install chromerather than by removing the flag.
ABSOLUTE: zero emoji in any output - UI, code, JSON, copy, comments, commit messages. Not as an icon, a bullet, a status dot, or "polish". Emoji are the number-one tell of machine-generated work. Use a lucide icon (inline SVG,
currentColor) or plain words. Enforced byscripts/check_no_emoji.py.
The five non-negotiables
- Token by intent. Pick the token whose meaning matches the action.
Destructive actions (Delete, Remove, Revoke) wear
action.destructivein every place they appear - the trigger and the confirm dialog both. A blue Delete is a bug. Measured byscripts/lint_intent.mjs. - One theme, one source of truth. Every page renders from the same
tokens/*.jsonthrough one CSS-variable layer imported once at the app root. No per-page palette, no hardcoded hex, px, or timing. - Every interactive element ships eight states: default, hover, focus, active, disabled, loading (if async), error (if input), and selected (if selectable). The eighth is not optional when the thing can be selected.
- One thing leads. Every screen has a first place for the eye, and display type is at least 2.5x the body size. Four equal cards means the eye lands nowhere and the screen reads as generated.
- Output completeness. A partial output is a broken output. Deliver full files, never placeholders. Asked for N components, deliver all N.
Decision framework
User needs, then accessibility, then consistency, then aesthetics, then developer experience. Never sacrifice a higher tier for a lower one. Beautiful but inaccessible is broken; consistent but confusing is the wrong pattern.
Where the depth lives
| Read it when | File |
|---|---|
| Tokens, palettes, theming, dark mode, any colour decision | .claude/rules/tokens-and-color.md |
| Type scale, line length, the 4px spacing rhythm | .claude/rules/typography-and-spacing.md |
| Building any screen or component, composition, empty states | .claude/rules/components.md |
| Auditing, or finishing any interactive element | .claude/rules/accessibility.md |
| Generating code for React, Next.js, SwiftUI, or any adapter | .claude/rules/frameworks.md |
| Design review, prototyping, research, handoff | .claude/rules/review-and-research.md |
| Aesthetic direction, motion, voice and tone, governance, QA | .claude/rules/brand-and-operations.md |
Then pick the runnable skill for the job: design-tokens, design-component,
design-code, design-review, a11y-audit, apply-aesthetic, brandkit,
image-to-code, redesign, and the rest. Interrogate the brief first with
/grill-me; prove the result with /gate; judge it with /critique.
Related Skills
taste-skill
117.0kAgent skills that give coding agents taste: art direction, reference images and a browser check instead of generic AI pages
Claude-Code-Game-Studios
39.8kTurn Claude Code into a full game dev studio — 49 AI agents, 72 workflow skills, and a complete coordination system mirroring real studio hierarchy.
x402
121.0kSet up Browser Use Cloud payments with x402 — pay per request from a crypto wallet (USDC on Base mainnet), no signup or API key.
algorithmic-art
177.9kCreating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use this when users request creating art using code, generative art, algorithmic art, flow fields, or particle systems.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
