Shadcn Tailwind UI
LiarMTTT/TavernWeave
Build, restyle, or review accessible React interfaces that use shadcn/ui, Radix UI primitives, and Tailwind CSS.
How to build UI in this repo — compose classes with cn, use the CSS-variable design tokens (never raw hex/px), reuse the typographic and ui/ primitives, and define variants with cva like the…
Install Design System
$ npx skills add flornkm/personal-site --skill design-system -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install flornkm/personal-site design-system --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/flornkm/personal-site.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/design-system .claude/skills/design-system && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "design-system" agent skill from https://github.com/flornkm/personal-site/tree/main/.agents/skills/design-system into .claude/skills/design-system/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "design-system", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/flornkm/personal-site/tree/main/.agents/skills/design-systemType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add flornkm/personal-site --skill design-system -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install flornkm/personal-site design-system --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/flornkm/personal-site.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.agents/skills/design-system .agents/skills/design-system && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "design-system" agent skill from https://github.com/flornkm/personal-site/tree/main/.agents/skills/design-system into .agents/skills/design-system/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "design-system", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add flornkm/personal-site --skill design-system -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install flornkm/personal-site design-system --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/flornkm/personal-site.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.agents/skills/design-system .cursor/skills/design-system && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "design-system" agent skill from https://github.com/flornkm/personal-site/tree/main/.agents/skills/design-system into .cursor/skills/design-system/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "design-system", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/flornkm/personal-site.git --path .agents/skills/design-system--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add flornkm/personal-site --skill design-system -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install flornkm/personal-site design-system --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/flornkm/personal-site.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.agents/skills/design-system .gemini/skills/design-system && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "design-system" agent skill from https://github.com/flornkm/personal-site/tree/main/.agents/skills/design-system into .gemini/skills/design-system/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "design-system", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install flornkm/personal-site design-systemInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add flornkm/personal-site --skill design-system -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/flornkm/personal-site.git skills-src && mkdir -p .github/skills && cp -r skills-src/.agents/skills/design-system .github/skills/design-system && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "design-system" agent skill from https://github.com/flornkm/personal-site/tree/main/.agents/skills/design-system into .github/skills/design-system/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "design-system", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add flornkm/personal-site --skill design-system -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install flornkm/personal-site design-system --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/flornkm/personal-site.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.agents/skills/design-system .opencode/skills/design-system && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "design-system" agent skill from https://github.com/flornkm/personal-site/tree/main/.agents/skills/design-system into .opencode/skills/design-system/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "design-system", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
design-system- GitHub stars
- 150
- Token cost
- ~1.6k tokens
- SKILL.md length
- 671 words
- Files
- 1
- Skills in repo
- 14
- Repo updated
- First seen
- Licence
- None found
At a glance
How to build UI in this repo — compose classes with cn, use the CSS-variable design tokens (never raw hex/px), reuse the typographic and ui/ primitives, and define variants with cva like the…
- Works in 5 steps: Confirm it's missing — read… → Match the local style — study… → Write it in src/components/ui/.tsx by… → …
- Editing a component
- SKILL.md covers Always compose classes with cn, Use design tokens, not raw…, Reuse the primitives — don't… and Variants: use cva, mirror…, plus 4 more sections
- Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
What it does
Design System is an agent skill from flornkm/personal-site. How to build UI in this repo — compose classes with cn, use the CSS-variable design tokens (never raw hex/px), reuse the typographic and ui/ primitives, and define variants with cva like the existing components. Use whenever writing or editing a component, styling JSX, or reaching for a primitive that does not yet exist.
Its SKILL.md is about 1.6k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
It sits in Frontend & Design, covering Design tokens, Design systems and React components. It works with Tailwind CSS. The repository describes itself as: Florians personal site.
When your agent uses it
- Editing a component
- Reaching for a primitive that does not yet exist
Example prompts
- “/design-system”
Workflow steps
5 steps, taken from the first numbered list in SKILL.md.
- Confirm it's missing — read src/components/ui first; reuse/extend if something close exists.
- Match the local style — study button.tsx: cva for variants, cn(..., className) merge, forwardRef where a ref is useful (see link.tsx)…
- Write it in src/components/ui/.tsx by hand. Keep it small and composable; expose cva variants only if there are real variants.
- Use tokens and cn throughout — no raw colors, no inline style for what Tailwind expresses.
- Only reach for a third-party headless lib if the primitive is genuinely complex (focus trapping, positioning) and nothing comparable…
What it can do on your machine
Read from SKILL.md and the folder at commit cbc0e20. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
No scripts in the folder and no shell commands in SKILL.md (its code samples are typescript).
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Design System loads about 1.6k tokens when it runs. Until then it costs about 86 tokens; SKILL.md has 671 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
Without a licence we can't republish the file, so here is its outline and opening line. It has 671 words (~1,615 tokens).
“This is a TanStack Start + Tailwind v4 site with a handrolled component layer and CSS-variable design tokens. There is no shadcn, no Base UI/Radix, no component CLI — primitives are written by hand in this repo. Stay inside the…”
- name
- design-system
Files
Just SKILL.md in .agents/skills/design-system of flornkm/personal-site.
Open the folder on GitHubat commit cbc0e20
Compare with similar skills
Design System next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Design System this skillflornkm/personal-site | 150 | — | ~1.6k | Automated safety check: Pass | None | |
| Shadcn Tailwind UILiarMTTT/TavernWeave | 153 | — | ~1.7k | Automated safety check: Pass | Custom licence | |
| Shift UI Componentsshift-editor/shift | 348 | — | ~2.5k | Automated safety check: Pass | Apache-2.0 | |
| Tailwind V4 Shadcnsecondsky/claude-skills | 227 | — | ~4k | Automated safety check: Pass | MIT | |
| Design SystemOhh-889/skyroc | 795 | 11 repos | ~1.7k | Automated safety check: Pass | MIT | |
| Creative Tim UI Blockscreativetimofficial/ui | 12k | — | ~2.1k | Automated safety check: Notes | MIT |
Similar skills
Shift UI Components
shift-editor/shift
Guides design, implementation and review of Shift interface work: shared Base UI wrappers, Tailwind v4 theme tokens, Figma matching and accessible interaction states.
Tailwind V4 Shadcn
secondsky/claude-skills
| Production-tested setup for Tailwind CSS v4 with shadcn/ui, Vite, and React.
Design System
Ohh-889/skyroc
Token architecture, component specifications, and slide generation.
Creative Tim UI Blocks
creativetimofficial/ui
Helps install, generate and review Creative Tim UI blocks: shadcn/ui-based React and Tailwind sections that follow a restrained, production-minded design philosophy.
Scalar Design System
scalar/scalar
Scalar's design system — design tokens, theming (@scalar/themes), CSS variables, and the @scalar/components library.
More from flornkm/personal-site
All 14 skills in this repoAnimation Vocabulary
flornkm/personal-site
Reverse-lookup glossary that turns a vague description of a web animation or motion effect into its exact term ("the bouncy thing when a popover opens" → Pop in; "the iOS rubber-band scroll" →…
Apple Design
flornkm/personal-site
Apple's approach to interface design and fluid, physical motion, translated for the web.
Central Icons
flornkm/personal-site
ALWAYS ACTIVE. An agent skill from flornkm/personal-site.
Clean Jsx No Inline Ternaries
flornkm/personal-site
Keep JSX and component logic clean by minimizing inline ternaries, nested conditionals, and stringified conditional classes.
Prefer Container Queries
flornkm/personal-site
Enforce Tailwind container queries over viewport breakpoints for responsive components.
Improve Animations
flornkm/personal-site
Survey a codebase's animation and motion code as a senior motion advisor, then produce a prioritized audit and self-contained implementation plans for other agents (or cheaper models) to execute.
Related
Works with
Categories
Questions about Design System
What does Design System do?
How to build UI in this repo — compose classes with cn, use the CSS-variable design tokens (never raw hex/px), reuse the typographic and ui/ primitives, and define variants with cva like the…. Design System is an agent skill from flornkm/personal-site. How to build UI in this repo — compose classes with cn, use the CSS-variable design tokens (never raw hex/px), reuse the typographic and ui/ primitives, and define variants with cva like the existing components.
When should I use Design System?
Design System fits situations like: editing a component; reaching for a primitive that does not yet exist.
How do I install Design System in Claude Code?
Run `npx skills add flornkm/personal-site --skill design-system -a claude-code`. Or copy the skill folder (.agents/skills/design-system in flornkm/personal-site) into .claude/skills/design-system in your project. Claude Code loads it when a task matches its description.
How do I install Design System in Codex?
Run `npx skills add flornkm/personal-site --skill design-system -a codex`. Or copy the skill folder (.agents/skills/design-system in flornkm/personal-site) into .agents/skills/design-system in your project. Codex loads it when a task matches its description.
Can I use Design System in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add flornkm/personal-site --skill design-system -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/design-system, .gemini/skills/design-system, .github/skills/design-system and .opencode/skills/design-system in your project.
What does Design System need to run?
SKILL.md names no scripts, command-line tools or credentials: Design System is instructions for the agent only.
Does Design System access the network?
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Is Design System safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Design System use?
No licence was found for Design System or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.
How many tokens does Design System use?
About 1.6k tokens (SKILL.md is roughly 6.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Design System?
Skills that share tags, products or a category with Design System: Shadcn Tailwind UI (LiarMTTT/TavernWeave, 153 stars), Shift UI Components (shift-editor/shift, 348 stars), Tailwind V4 Shadcn (secondsky/claude-skills, 227 stars) and Design System (Ohh-889/skyroc, 795 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Design System?
flornkm (a GitHub user) maintains it in flornkm/personal-site, which has 150 GitHub stars. The repository holds 14 skills in this directory. The repository was last updated on October 8, 2026.
Source: flornkm/personal-site on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.