Skip to content
Back to search

claude-artisan

SkillWorks with Claude CodeGitHub

A Claude skill that generates production-ready UI components in 224 distinct design styles — from Bauhaus to Brutalism, Art Deco to Cyberpunk. One prompt, any aesthetic.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

Its scripts were only partly scanned.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/ara-mkr/claude-artisan with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/ara-mkr/claude-artisan'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/ara-mkr--claude-artisan/badge.svg)](/listings/ara-mkr--claude-artisan)

HTML

<a href="/listings/ara-mkr--claude-artisan"><img src="/api/listings/ara-mkr--claude-artisan/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

# Point Claude Code at the source directory directly:
design-language/

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 154 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <img width="7616" height="1800" alt="CLAUDE ARTISAN HEADER copy" src="https://github.com/user-attachments/assets/8b37aa7e-1b22-459d-93eb-d195def9f600" />
  2. <img width="7616" height="3080" alt="banner_grid_landscape copy" src="https://github.com/user-attachments/assets/264709c1-3297-4dd7-b1dd-150ece8a925e" />
  3. # Claude Artisan
  4. **A Claude Code skill that turns "make this brutalist" into a finished, accessible, production UI — zero guesswork.**
  5. `design-language` is a skill repository built for [Claude Code](https://claude.com/claude-code) (and any coding agent that can read Anthropic-format skills). Point it at a codebase, say a style name or just a vibe, and it ships real tokens, real components, real accessibility fixes — not a mood board.
  6. ```
  7. "make my landing page glassmorphic" → resolved instantly, named style
  8. "2000s nostalgia, chrome and bubbles" → resolved via decision tree → Y2K Futurism
  9. "premium and futuristic, not childish" → vibe → shortlist → disambiguated
  10. "a spec I can paste into Cursor for this" → tokens handed off explicitly, no ambiguity
  11. ```
  12. ---
  13. ## Why this exists
  14. Design systems live in people's heads. An agent told "make it brutalist" will improvise — wrong border-radius, half the buttons still soft-shadowed, contrast that fails AA, a signature move applied once and forgotten. `design-language` exists so an agent applies a style **the way someone who actually knows that style would**: tokens first, every component walked, the signature move repeated everywhere on purpose, then an accessibility pass, then a drift check before calling it done.
  15. ---
  16. ## By the numbers
  17. | | |
  18. |---|---|
  19. | **Styles cataloged** | 199, researched — not invented |
  20. | **Deep implementation specs** | 199 — every style, full implementation-grade |
  21. | **Style families** | 9 |
  22. | **Starter theme files** | 398 (199 CSS + 199 Tailwind fragments) |
  23. | **Component examples** | 199 fully-styled HTML references — one per style |
  24. | **Scripts** | 3, stdlib-only, all tested |
  25. | **Single source of truth** | `scripts/style_catalog.json` — everything else derives from it |
  26. Every one of the 199 cataloged styles now has the full treatment: tokens, Tailwind fragment, a 10-primitive component-rules table, style-specific accessibility corrections, do/don't, and confusable neighbors — see `references/00-flagship-implementation-specs/`.
  27. <details>
  28. <summary><strong>All 9 families</strong> (199 styles total)</summary>
  29. | Family | Count | Covers |
  30. |---|---:|---|
  31. | Niche subculture & kitsch | 43 | dark academia, cottagecore, webcore, cyberprep — accent layers, not full systems |
  32. | Retrofuturism & speculative genres | 32 | cyberpunk, solarpunk, steampunk, dieselpunk, atompunk, cassette futurism |
  33. | Texture / material / rendering | 30 | chrome, holographic, halftone, risograph, isometric, voxel, pixel art, glitch |
  34. | Historical graphic movements | 30 | Bauhaus, Swiss, De Stijl, Constructivism, Art Deco, Memphis, Pop Art, Dada |
  35. | Flat, material & platform systems | 23 | Material 3, Fluent 2, Liquid Glass, Carbon, Ant Design, Polaris, USWDS |
  36. | Minimal / maximal / organic | 17 | minimalism, maximalism, bento grid, biomorphic, Scandinavian |
  37. | Morphism / tactile-dimensional | 9 | skeuomorphism, neumorphism, claymorphism, glassmorphism hybrids |
  38. | Brutalist & anti-design | 8 | brutalist web, neubrutalism, anti-design, Swiss Punk |
  39. | Glass & transparency | 7 | glassmorphism, liquid glass, acrylic, aero glass, frosted variants |
  40. </details>
  41. ---
  42. ## Repo map
  43. ```
  44. design-language/
  45. ├── SKILL.md ← workflow, navigation, triggers (159 lines)
  46. ├── references/
  47. │ ├── 00-flagship-implementation-specs/ ← 199 files — one per style, full deep-spec
  48. │ ├── 01-morphism-tactile-dimensional.md
  49. │ ├── 02-glass-transparency-family.md
  50. │ ├── 03-brutalist-antidesign.md
  51. │ ├── 04-flat-material-platform-systems.md
  52. │ ├── 05-historical-graphic-movements.md
  53. │ ├── 06-retrofuturism-punk-genres.md
  54. │ ├── 07-minimal-maximal-organic.md
  55. │ ├── 08-texture-material-rendering.md
  56. │ ├── 09-niche-subculture-kitsch.md
  57. │ └── style-selection-decision-tree.md ← vague vibe → specific style
  58. ├── scripts/
  59. │ ├── style_catalog.json ← SINGLE SOURCE OF TRUTH (199 styles)
  60. │ ├── generate_tokens.py ← slug → CSS tokens + Tailwind fragment
  61. │ ├── contrast_check.py ← real WCAG AA/AAA luminance math
  62. │ └── consistency_audit.py ← the "half-applied style" detector
  63. ├── assets/
  64. │ ├── starter-themes/ ← drop-in .css (199) + .tailwind.config.fragment.js (199)
  65. │ └── component-examples/ ← styled button/card/nav HTML — one per style (199)
  66. └── LICENSE.txt
  67. ```
  68. Everything downstream — the 9 category files, the 199 deep specs, the starter themes, both scripts — reads `scripts/style_catalog.json`. Change the catalog, regenerate; never hand-edit the derived files out of sync with it.
  69. ---
  70. ## How an agent actually uses it
  71. 1. **Identify the target style.** Named style → resolve slug/alias (`glassmorphism`, `"soft UI"` → `neumorphism`). Vibe/era/mood → `references/style-selection-decision-tree.md`, which forces a decade pin for anything "retro" (Y2K vs. Frutiger Aero vs. vaporwave are all "2000s" and easy to conflate).
  72. 2. **Pull the spec.** Every style has a full deep-spec file in `references/00-flagship-implementation-specs/`.
  73. 3. **Apply consistently, token-first.** Walk every primitive — button, input, card, nav, modal, table, tooltip, badge, toggle, loading/empty state — and repeat the signature move everywhere it's relevant, not once decoratively.
  74. 4. **Fix accessibility for that specific style.** Every flagship spec lists the exact contrast/scrim/motion-reduction corrections that style needs by default.
  75. 5. **Run the drift check before calling it done.**
  76. ```bash
  77. python3 scripts/consistency_audit.py ./src --style glassmorphism
  78. # exit 0 = clean · exit 1 = drift found (hardcoded values that skipped the token set)
  79. ```
  80. 6. **Handing off to another agent** (Codex, Cursor, etc.)? Tokens are handed over explicitly — never just a style name.
  81. ---
  82. ## The three scripts
  83. All standard-library Python, no dependencies, all tested against synthetic cases before being called done.
  84. ### `generate_tokens.py` — style → paste-ready tokens
  85. ```bash
  86. python3 scripts/generate_tokens.py glassmorphism ./out # writes .css + .tailwind.config.fragment.js
  87. python3 scripts/generate_tokens.py --list # every slug + alias
  88. python3 scripts/generate_tokens.py --flagship # all 199 now have deep specs
  89. ```
  90. ### `contrast_check.py` — real WCAG math, not an approximation
  91. ```bash
  92. python3 scripts/contrast_check.py "#0f172a" "#f8fafc" # manual pair
  93. python3 scripts/contrast_check.py --css styles.css --bg "#0b0b0f" # scan a file
  94. ```
  95. Verified against known boundaries: black/white = 21.00:1, `#767676` on white = 4.54:1 (AA pass), `#777` = 4.48:1 (AA **fail**). Composites alpha over the assumed background so translucent glass fills are judged as they actually render.
  96. ### `consistency_audit.py` — the half-applied-style detector
  97. ```bash
  98. python3 scripts/consistency_audit.py ./src --tokens glassmorphism.css
  99. python3 scripts/consistency_audit.py ./src --style glassmorphism
  100. ```
  101. Flags hex/`rgb()` colors, radius, shadow, and font-family literals that don't trace back to the applied style's token set — the exact drift that makes a styled UI look accidental instead of intentional. Regex-based by design (documented as a lightweight linter, not a CSS parser): treat every hit as a lead, not a verdict.
  102. ---
  103. ## Install
  104. ```bash
  105. # Point Claude Code at the source directory directly:
  106. design-language/
  107. ```
  108. ---
  109. ## Design ground rules this repo was held to
  110. - **Research, don't invent.** Every cataloged style has a verified era, origin, and at least one real reference implementation.
  111. - **No placeholders.** Every token is one that would genuinely ship — real hex-adjacent palettes, real `box-shadow`/`backdrop-filter` values, real easing curves.
  112. - **Depth everywhere.** All 199 cataloged styles get the full implementation-grade treatment — tokens, Tailwind, component rules, a11y, do/don't, confusables.
  113. - **Single source of truth.** The JSON catalog and every prose file agree by construction — the prose is generated from the catalog, not hand-synced.
  114. - **Known deviations, stated up front:** six starter themes (glassmorphism, neubrutalism, claymorphism, neumorphism, brutalism, cyberpunk) are hand-tuned and deliberately left untouched by the generic generator — they beat the auto-generated output. The remaining 180 CSS/Tailwind files were generated from catalog tokens (33 originally hand-authored as flagship specs, 153 authored alongside their deep-spec write-up). The optional trigger-description eval/benchmark loop from skill-creator was not run; it's polish, not scope.
  115. ---
  116. ## License
  117. MIT — see [`design-language/LICENSE.txt`](design-language/LICENSE.txt).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.