Tailwind V4 Shadcn
ever-works/ever-works
Production-tested setup for Tailwind CSS v4 with shadcn/ui, Vite, and React.
Applies GitArena's official design system, colors, and typography to frontend components and pages.
$ npx skills add mellowagain/gitarena --skill design-guidelines -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install mellowagain/gitarena design-guidelines --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/mellowagain/gitarena.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/design-guidelines .claude/skills/design-guidelines && 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-guidelines" agent skill from https://github.com/mellowagain/gitarena/tree/main/.claude/skills/design-guidelines into .claude/skills/design-guidelines/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "design-guidelines", 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/mellowagain/gitarena/tree/main/.claude/skills/design-guidelinesType 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 mellowagain/gitarena --skill design-guidelines -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install mellowagain/gitarena design-guidelines --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/mellowagain/gitarena.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.claude/skills/design-guidelines .agents/skills/design-guidelines && 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-guidelines" agent skill from https://github.com/mellowagain/gitarena/tree/main/.claude/skills/design-guidelines into .agents/skills/design-guidelines/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "design-guidelines", 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 mellowagain/gitarena --skill design-guidelines -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install mellowagain/gitarena design-guidelines --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/mellowagain/gitarena.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.claude/skills/design-guidelines .cursor/skills/design-guidelines && 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-guidelines" agent skill from https://github.com/mellowagain/gitarena/tree/main/.claude/skills/design-guidelines into .cursor/skills/design-guidelines/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "design-guidelines", 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/mellowagain/gitarena.git --path .claude/skills/design-guidelines--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 mellowagain/gitarena --skill design-guidelines -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install mellowagain/gitarena design-guidelines --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/mellowagain/gitarena.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.claude/skills/design-guidelines .gemini/skills/design-guidelines && 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-guidelines" agent skill from https://github.com/mellowagain/gitarena/tree/main/.claude/skills/design-guidelines into .gemini/skills/design-guidelines/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "design-guidelines", 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 mellowagain/gitarena design-guidelinesInstalls 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 mellowagain/gitarena --skill design-guidelines -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/mellowagain/gitarena.git skills-src && mkdir -p .github/skills && cp -r skills-src/.claude/skills/design-guidelines .github/skills/design-guidelines && 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-guidelines" agent skill from https://github.com/mellowagain/gitarena/tree/main/.claude/skills/design-guidelines into .github/skills/design-guidelines/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "design-guidelines", 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 mellowagain/gitarena --skill design-guidelines -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install mellowagain/gitarena design-guidelines --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/mellowagain/gitarena.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.claude/skills/design-guidelines .opencode/skills/design-guidelines && 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-guidelines" agent skill from https://github.com/mellowagain/gitarena/tree/main/.claude/skills/design-guidelines into .opencode/skills/design-guidelines/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "design-guidelines", 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.
design-guidelinesApplies GitArena's official design system, colors, and typography to frontend components and pages.
Design Guidelines is an agent skill from mellowagain/gitarena. Applies GitArena's official design system, colors, and typography to frontend components and pages. Use it when building new UI, styling components, or ensuring consistency with the established dark monochromatic visual identity.
Its SKILL.md is about 2.5k 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 Logo and visual identity, Typography and Design systems. It works with shadcn/ui, Git, Rust and Linux. The repository describes itself as: Rust-based Software development platform (forge) with built-in vcs, issue tracking and code review. The licence is MIT.
Read from SKILL.md and the folder at commit a9b0bf7. It shows what the files ask for, not the result of running them.
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.
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.
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Design Guidelines loads about 2.5k tokens when it runs. Until then it costs about 62 tokens; SKILL.md has 909 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.
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.
The full file from mellowagain/gitarena at commit a9b0bf7, republished under its MIT licence (© mellowagain). 909 words, ~2,544 tokens.
.claude/skills/design-guidelines/SKILL.md (or your agent's skills folder).GitArena follows a near-black monochromatic design language inspired by Linear and modern developer tools. The UI is dark-only, achromatic, and relies on luminance contrast rather than color to establish hierarchy.
Keywords: design system, dark theme, monochromatic, styling, brand colors, typography, UI components, visual identity, shadcn/ui, tailwind, Linear-style
| Layer | Technology |
|---|---|
| Framework | Next.js 16 (App Router, React Server Components) |
| Styling | Tailwind CSS v4 (CSS-only config via @theme inline) |
| Components | shadcn/ui (new-york style, neutral base) |
| Icons | Lucide React |
| Fonts | Geist (sans) + Geist Mono (loaded via Next.js built-in) |
| Color space | oklch throughout |
| Class merging | cn() utility from clsx + tailwind-merge |
The entire palette is achromatic (chroma 0 in oklch) except for the destructive red. Both :root and .dark define identical tokens -- the app is dark-only by design.
Surface Colors (background layers, darkest to lightest):
oklch(0.09 0 0) -- Page-level background, near-blackoklch(0.12 0 0) -- Elevated surface (cards, panels)oklch(0.14 0 0) -- Input backgrounds, secondary surfacesoklch(0.14 0 0) -- Dropdowns, popovers, overlaysoklch(0.15 0 0) -- Active sidebar itemsoklch(0.18 0 0) -- Hover states, highlighted rowsoklch(0.2 0 0) -- Sidebar dividersText Colors (lightest to dimmest):
oklch(0.95 0 0) -- Brightest text, sidebar emphasisoklch(0.93 0 0) -- Primary body textoklch(0.8 0 0) -- Secondary textoklch(0.5 0 0) -- Tertiary text, placeholders, timestampsBorder and Focus:
oklch(1 0 0 / 0.08) -- 8% white opacity, subtle dividersoklch(1 0 0 / 0.2) -- 20% white opacity, focus ringsSemantic Colors:
oklch(0.55 0.18 25) -- The only chromatic color; red for errors, delete actions, sign-outblue-500 (Tailwind utility) -- Used sparingly for unread indicatorsChart Colors (achromatic gradient):
oklch(0.7 0 0)oklch(0.6 0 0)oklch(0.5 0 0)oklch(0.4 0 0)oklch(0.3 0 0)Geist with Geist FallbackGeist Mono with Geist Mono Fallback18px (112.5% scale, optimized for 4K readability)-webkit-font-smoothing: antialiased on bodyText Hierarchy Patterns:
| Role | Classes |
|---|---|
| Page heading | text-4xl font-bold tracking-tight (up to text-6xl on lg) |
| Section heading | text-3xl font-bold tracking-tight sm:text-4xl |
| Card title | font-semibold leading-none |
| Section label | text-xs font-medium uppercase tracking-widest text-muted-foreground |
| Body text | text-sm or text-base depending on context |
| Description/secondary | text-sm text-muted-foreground or text-sm leading-relaxed text-muted-foreground |
| Stat/metric value | text-3xl font-bold tracking-tight text-foreground |
| Monospace/username | font-mono text-xs text-muted-foreground |
| Keyboard shortcut | text-[11px] text-muted-foreground bg-secondary rounded border border-border |
0.5rem base (--radius), computed variants: sm (-4px), md (-2px), lg (base), xl (+4px)max-w-6xl (72rem) for landing pagespx-6 horizontal, py-24 or py-16 vertical for sectionspx-6 py-6 with gap-6 between sectionsh-14 (app) or h-16 (landing)h-9 (default), h-8 (sm), h-10 (lg)size-9 (default), size-8 (sm), size-10 (lg)border-border token (oklch(1 0 0 / 0.08))border-t border-border or border-b border-bordergap-px bg-border on parent with bg-card on childrenw-px h-7 bg-borderborder-dashedall 180ms ease on button, a, input, [role="button"]transition-colors for links and non-elevated elementstransition-[color,box-shadow] for inputs and badgestransition-all for buttonsshadow-smshadow-xsshadow-2xl shadow-black/20blur-xl opacity-50All UI primitives use the data-slot attribute for identification and follow the function-component pattern (no forwardRef, using React.ComponentProps):
function ComponentName({ className, ...props }: React.ComponentProps<"div">) {
return (
<div
data-slot="component-name"
className={cn("base-classes", className)}
{...props}
/>
);
}| Variant | Usage |
|---|---|
default | Primary actions (white bg, dark text) |
destructive | Dangerous actions (red bg) |
outline | Secondary actions with border |
secondary | Less prominent actions (dark bg, gray text) |
ghost | Minimal, hover-only actions (nav links, icons) |
link | Inline text links with underline on hover |
Cards use bg-card with border and rounded-xl. Internal spacing uses px-6 and gap-6. Sub-components: CardHeader, CardTitle, CardDescription, CardAction, CardContent, CardFooter.
Centered layout with border-dashed, vertically stacked icon + title + description + action. Use the Empty, EmptyHeader, EmptyMedia, EmptyTitle, EmptyDescription, EmptyContent composable.
bg-background, h-14, breadcrumb with / separatorsbg-background/80 backdrop-blur-xl, h-16text-base font-semibold tracking-tight) in app; G icon block + "GitArena" on landingtext-muted-foreground hover:text-foreground transition-colorstext-foregroundhover:bg-primary/90) or background shift (hover:bg-accent)hover:text-foreground from text-muted-foregroundhover:bg-accent/50 or hover:bg-accent/30hover:text-foreground hover:bg-accent/50hover:ring-2 hover:ring-ringfocus-visible:ring-[3px] focus-visible:ring-ring/50 focus-visible:border-ringaria-invalid:ring-destructive/20 aria-invalid:border-destructiveUse gap-px bg-border on the grid parent with bg-card cells for a border-separated grid layout. Each cell contains an icon, heading, and description.
gitarena-frontend/
app/
globals.css # Theme tokens and base styles (source of truth)
layout.tsx # Root layout with font and analytics
components/
ui/ # 48 shadcn/ui primitives (new-york style)
landing/ # 7 landing page sections
top-bar.tsx # App navigation header
client-layout.tsx # SWR + config providers
...
lib/
utils.ts # cn() class merge utility
public/ # Favicons and placeholder images
components.json # shadcn/ui configurationDo:
bg-card, text-muted-foreground, etc.) instead of raw oklch valuescn() for all className mergingtext-sm as the default text size (renders at ~14.4px given the 18px base)w-4 h-4 (inline) or w-5 h-5 (standalone)transition-colors for color-only transitions and transition-all only when neededtracking-tight to headingsDon't:
data-slot attribute when creating new UI primitivesforwardRef -- use React.ComponentProps<> instead (React 19+ pattern)bg-gray-800) instead of the design tokens© mellowagain, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Just SKILL.md in .claude/skills/design-guidelines of mellowagain/gitarena.
Open the folder on GitHubat commit a9b0bf7
Design Guidelines 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 Guidelines this skillmellowagain/gitarena | 115 | — | ~2.5k | Automated safety check: Pass | MIT | |
| Tailwind V4 Shadcnever-works/ever-works | 158 | 2 repos | ~3.8k | Automated safety check: Pass | MIT | |
| Shadcn Tailwind UILiarMTTT/TavernWeave | 150 | — | ~1.7k | Automated safety check: Pass | Custom licence | |
| Design SystemWrongStack/WrongStack | 370 | — | ~3.9k | Automated safety check: Pass | MIT | |
| Design ReferencesMadAppGang/claude-code | 284 | — | ~2.8k | Automated safety check: Pass | MIT | |
| UI StylingOhh-889/skyroc | 795 | 13 repos | ~2.5k | Automated safety check: Pass | MIT |
ever-works/ever-works
Production-tested setup for Tailwind CSS v4 with shadcn/ui, Vite, and React.
LiarMTTT/TavernWeave
Build, restyle, or review accessible React interfaces that use shadcn/ui, Radix UI primitives, and Tailwind CSS.
WrongStack/WrongStack
Use this skill BEFORE writing or restyling ANY user-facing interface.
MadAppGang/claude-code
Predefined design system references for UI reviews. An agent skill from MadAppGang/claude-code.
Ohh-889/skyroc
Create beautiful, accessible user interfaces with shadcn/ui components (built on Radix UI + Tailwind), Tailwind CSS utility-first styling, and canvas-based visual designs.
Ohh-889/skyroc
Token architecture, component specifications, and slide generation.
mellowagain/gitarena
Set up component testing with Playwright using a story gallery — scaffold stories and a gallery dev page driven by the built-in mount fixture, no dedicated component-testing runtime.
mellowagain/gitarena
Inspect Playwright trace files from the command line — list actions, view requests, console, errors, snapshots and screenshots.
Works with
Categories
Applies GitArena's official design system, colors, and typography to frontend components and pages. Design Guidelines is an agent skill from mellowagain/gitarena. Applies GitArena's official design system, colors, and typography to frontend components and pages.
Design Guidelines fits situations like: building new UI; styling components; ensuring consistency with the established dark monochromatic visual identity.
Run `npx skills add mellowagain/gitarena --skill design-guidelines -a claude-code`. Or copy the skill folder (.claude/skills/design-guidelines in mellowagain/gitarena) into .claude/skills/design-guidelines in your project. Claude Code loads it when a task matches its description.
Run `npx skills add mellowagain/gitarena --skill design-guidelines -a codex`. Or copy the skill folder (.claude/skills/design-guidelines in mellowagain/gitarena) into .agents/skills/design-guidelines in your project. Codex loads it when a task matches its description.
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add mellowagain/gitarena --skill design-guidelines -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-guidelines, .gemini/skills/design-guidelines, .github/skills/design-guidelines and .opencode/skills/design-guidelines in your project.
SKILL.md names no scripts, command-line tools or credentials: Design Guidelines is instructions for the agent only.
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.
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.
Design Guidelines is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
About 2.5k tokens (SKILL.md is roughly 10k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
Skills that share tags, products or a category with Design Guidelines: Tailwind V4 Shadcn (ever-works/ever-works, 158 stars), Shadcn Tailwind UI (LiarMTTT/TavernWeave, 150 stars), Design System (WrongStack/WrongStack, 370 stars) and Design References (MadAppGang/claude-code, 284 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
mellowagain (a GitHub user) maintains it in mellowagain/gitarena, which has 115 GitHub stars. The repository holds 3 skills in this directory. The repository was last updated on October 7, 2026.
Source: mellowagain/gitarena on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.