skills folder in shadcn/ui codebase - Part 1.0

In this article, we review skills folder in shadcn/ui codebase. You will learn:

1. shadcn/SKILL.md

Prerequisite:

1. AGENTS.md, a README.md for agents.

shadcn/SKILL.md

Below is the SKILL.md metadata defined:

---
name: shadcn
description: Manages shadcn components and projects — adding, searching, fixing, debugging, styling, and composing UI. Provides project context, component docs, and usage examples. Applies when working with shadcn/ui, component registries, presets, --preset codes, or any project with a components.json file. Also triggers for "shadcn init", "create an app with --preset", or "switch to --preset".
user-invocable: false
---

I haven’t seen the option, user-invocable before. I checked the docs and below is what I could find.

And I reviewed the structure of SKILL.md and found the below table of content.

This is the second time I see Principles section. There is a Core Principles section in Lobehub SKILLS.md.

Then there’s Critical Rules section that references the styling.md defined in the rules folder.

You can write the scripts/rules and create a folder and reference them within your skill.

It is important that you breifly define what the additional markdown files are about as shown below:

It is also common to define the patterns in the SKILLS.md. Shadcn has this below section, Key Patterns.

I liked the Workflow section because it clearly highlights how to manage Shadcn codebase, step by step.

About me:

Hey, my name is Ramu Narasinga. Email: ramu.narasinga@gmail.com

Tired of AI-generated code that works but nobody understands? 

I spent 3+ years studying OSS codebases and wrote 350+ articles on what makes them production-grade. I built an open source tool that reviews your PR against your existing codebase patterns.

Your codebase. Your patterns. Enforced. 

Get started for free — thinkthroo.com

References:

1. shadcn-ui/ui/skills/shadcn/SKILL.md

2. AGENTS.md, a README.md for agents.

3. agentskills.io/specification#frontmatter-required

4. shadcn-ui/ui/skills/shadcn/rules/styling.md

5. shadcn-ui/ui/skills/shadcn/SKILL.md#workflow