GitHub radar
🤖 shadcn/lint: A linter to keep your AI agents in check!
An agent-first Tailwind CSS design system linter from the shadcn team. Tells the agent what’s wrong and how to fix it as it works. The agent self-corrects on the spot.
The @shadcn/lint is an agent-focused linter for Tailwind CSS design systems developed by the shadcn team. When using an AI agent to build a website and ensuring its design is perfect, there might be instances where the generated UI code contains colors, spacings, or utility classes which may not adhere to the design rules of your project. The @shadcn/lint can help identify such violations and provide informative error messages explaining the issues and ways to rectify them, allowing the agent to correct itself during generation itself instead of going through several iterations. In most cases, the Claude and GPT models required just one iteration of providing feedback regarding the design rules to attain zero violations. Models like Sonnet 5, Haiku 4.5, and Opus 5 were able to obtain zero violations across all the eight tasks with just one iteration of correction. Using @shadcn/lint while providing feedback resulted in a reduction of 10% to 48% in the total number of tokens required to rectify violations. The @shadcn/lint is compatible with React, Svelte, and Vue projects based on Tailwind CSS version 4 and can be used alongside both ESLint and Oxlint.
Why a vibe-coder should care
With this tool, you no longer have to worry about going through multiple iterations of corrections which usually happen when working with an AI agent to create websites and ensure their design is perfect. You will receive detailed feedback and your agent will be able to self-correct immediately while you will get precisely what you wanted the first time!
How to install
Copy this and send it to your agent — Claude Code, Codex, any of them:
Install @shadcn/lint in this project: https://github.com/shadcn-ui/lint — follow the README, configure the rules for our design system, add linting to the code review step, and show me the final config. Ask me if you need settings for specific components.
Runs on any laptop — only Node.js needed
Open on GitHub▌ More finds