tailwind-v4-shadcn SKILL.md skillA

tailwind-v4-shadcn from secondsky/claude-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add secondsky/claude-skills/tailwind-v4-shadcn@git:20260803.875f1a8

Pins git:20260803.875f1a8 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
secondsky/claude-skills
Path
plugins/tailwind-v4-shadcn/skills/tailwind-v4-shadcn/SKILL.md
Versions recorded
5
Latest version
git:20260803.875f1a8, committed Aug 3, 2026
First version recorded
Dec 24, 2025
Size
15,882 bytes
Repository stars
247
License
MIT

| Production-tested setup for Tailwind CSS v4 with shadcn/ui, Vite, and React. Use when: initializing React projects with Tailwind v4, setting up shadcn/ui, implementing dark mode, debugging CSS variable issues, fixing theme switching, migrating from Tailwind v3, or encountering color/theming problems. Covers: @theme inline pattern, CSS variable architecture, dark mode with ThemeProvider, component composition, vite.config setup, common v4 gotchas, and production-tested patterns.

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

# Tailwind v4 + shadcn/ui Production Stack

**Production-tested**: WordPress Auditor (https://wordpress-auditor.webfonts.workers.dev)
**Last Updated**: 2025-12-04
**Status**: Production Ready ✅

## Table of Contents
1. [Before You Start](#-before-you-start-read-this)
2. [Quick Start](#quick-start-5-minutes---follow-this-exact-order)
3. [Four-Step Architecture](#the-four-step-architecture-critical)
4. [Dark Mode Setup](#dark-mode-setup)
5. [Critical Rules](#critical-rules-must-follow)
6. [Semantic Color Tokens](#semantic-color-tokens)
7. [Common Issues & Fixes](#common-issues--quick-fixes)
8. [File Templates](#file-templates)
9. [Setup Checklist](#complete-setup-checklist)
10. [Advanced Topics](#advanced-topics)
11. [Dependencies](#dependencies)
12. [Tailwind v4 Plugins](#tailwind-v4-plugins)
13. [Reference Documentation](#reference-documentation)
14. [When to Load References](#when-to-load-references)

---

## ⚠️ BEFORE YOU START (READ THIS!)

**CRITICAL FOR AI AGENTS**: If you're Claude Code helping a user set up Tailwind v4:

1. **Explicitly state you're using this skill** at the start of the conversation
2. **Reference patterns from the skill** rather than general knowledge
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add secondsky/claude-skills/tailwind-v4-shadcn@sha256:39d77c20c339537e

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

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

Versions

The registry has recorded 5 versions of this file, between Dec 24, 2025 and Aug 3, 2026, about one every 56 days.

versioncommittedcommitsizeaudit
git:20260803.875f1a8 latest2026-08-03 875f1a8 15,882 BA view · diff
git:20260514.120edd62026-05-14 120edd6 15,882 BA view · diff
git:20260429.5f7b93b2026-04-29 5f7b93b 15,282 BA view · diff
git:20260426.852a9f72026-04-26 852a9f7 15,217 BA view · diff
git:20251224.ba827ce2025-12-24 ba827ce 15,188 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 (15882 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

secondsky/claude-skills · 247 stars · license MIT · pushed 2026-10-31 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_rkcnoyzgs44n4u6e
GET https://markdownregistry.com/api/v1/resolve?ref=secondsky/claude-skills/tailwind-v4-shadcn
GET https://markdownregistry.com/api/v1/blob/39d77c20c339537e45f907c2079986eecf86c8e1301b6979980d4dbd7c41daf0

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 secondsky/claude-skills

AGENTS.md AGENTS.md file
secondsky/claude-skills · AGENTS.md
git:20260829.7ecf025 · audit A · 247 stars
CLAUDE.md CLAUDE.md file
secondsky/claude-skills · CLAUDE.md
git:20260917.a0994f7 · audit A · 247 stars
aceternity-ui SKILL.md skill
secondsky/claude-skills · plugins/aceternity-ui/skills/aceternity-ui/SKILL.md · 100+ animated React components (Aceternity UI) for Next.js with Tailwind. Use for hero sections, parallax, 3D effects…
v1.1.0 · audit A · 247 stars
api-authentication SKILL.md skill
secondsky/claude-skills · plugins/api-authentication/skills/api-authentication/SKILL.md · Secure API authentication with JWT, OAuth 2.0, API keys. Use for authentication systems, third-party integrations…
git:20260402.75421fa · audit A · 247 stars
api-changelog-versioning SKILL.md skill
secondsky/claude-skills · plugins/api-changelog-versioning/skills/api-changelog-versioning/SKILL.md · Creates comprehensive API changelogs documenting breaking changes, deprecations, and migration strategies for API…
git:20260402.75421fa · audit A · 247 stars
api-contract-testing SKILL.md skill
secondsky/claude-skills · plugins/api-contract-testing/skills/api-contract-testing/SKILL.md · Verifies API contracts between services using consumer-driven contracts, schema validation, and tools like Pact. Use…
git:20260402.75421fa · audit A · 247 stars
api-design-principles SKILL.md skill
secondsky/claude-skills · plugins/api-design-principles/skills/api-design-principles/SKILL.md · Master REST and GraphQL API design principles to build intuitive, scalable, and maintainable APIs that delight…
git:20260402.75421fa · audit A · 247 stars
api-error-handling SKILL.md skill
secondsky/claude-skills · plugins/api-error-handling/skills/api-error-handling/SKILL.md · Implements standardized API error responses with proper status codes, logging, and user-friendly messages. Use when…
git:20260402.75421fa · audit A · 247 stars
api-filtering-sorting SKILL.md skill
secondsky/claude-skills · plugins/api-filtering-sorting/skills/api-filtering-sorting/SKILL.md · Builds flexible API filtering and sorting systems with query parameter parsing, validation, and security. Use when…
git:20260402.75421fa · audit A · 247 stars
api-gateway-configuration SKILL.md skill
secondsky/claude-skills · plugins/api-gateway-configuration/skills/api-gateway-configuration/SKILL.md · Configures API gateways for routing, authentication, rate limiting, and request transformation in microservice…
git:20260402.75421fa · audit A · 247 stars
api-pagination SKILL.md skill
secondsky/claude-skills · plugins/api-pagination/skills/api-pagination/SKILL.md · Implements efficient API pagination using offset, cursor, and keyset strategies for large datasets. Use when building…
git:20260402.75421fa · audit A · 247 stars
api-rate-limiting SKILL.md skill
secondsky/claude-skills · plugins/api-rate-limiting/skills/api-rate-limiting/SKILL.md · Implements API rate limiting using token bucket, sliding window, and Redis-based algorithms to protect against abuse…
git:20260402.75421fa · audit A · 247 stars

Every file in secondsky/claude-skills

Other files named tailwind-v4-shadcn

tailwind-v4-shadcn SKILL.md skill
maxmiksa/auto-company · .claude/skills/tailwind-v4-shadcn/SKILL.md · Production-tested setup for Tailwind CSS v4 with shadcn/ui, Vite, and React. Use when: initializing React projects…
git:20260918.6efeab7 · audit A · 3,191 stars
tailwind-v4-shadcn SKILL.md skill
asymmetric-al/core · .agents/skills/tailwind-v4-shadcn/SKILL.md · Set up Tailwind v4 with shadcn/ui using @theme inline pattern and CSS variable architecture. Four-step pattern: CSS…
git:20260612.9ac3f47 · audit A · 370 stars

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