Agent skills

What are agent skills?

llms.txt tells your AI what SGDS contains. Skills tell your AI how to use it.

Think of llms.txt as the ingredient list, and skills as the recipe.

Skills are markdown files that give your AI step-by-step instructions for working with SGDS — which components to reach for, which tokens and patterns to follow, and what good output looks like. You install them once into your project, and your AI reads them automatically from that point on.

If you're unsure where to start, begin with sgds-workflow. It maps the skill set and points your AI to the right skill for the task.

Why skills matter

If you've ever asked an AI to help you build something, you've probably seen the result: code that almost works — wrong component names, made-up class names, patterns that don't exist in your design system. The AI isn't being careless. It simply doesn't know how your system works.

Skills fix that. Once installed, your AI understands exactly how SGDS is structured without you having to explain it every time.

For new applications, the workflow starts with sgds-getting-started. From there, your AI moves between components, utilities, theming, templates, and forms depending on the task.

How skills work

Skills are plain markdown files structured for AI consumption. Each skill contains:

• A quick decision guide — decision trees for choosing the right token or component variant
• An API summary — compact attribute and property tables
• Usage examples — idiomatic HTML the AI can produce and adapt
• A "For AI agents" section — explicit rules and common mistakes to avoid

Skills are read by the agent at query time. They do not add runtime dependencies to your project.

What you can do with skills installed

Instead of wrestling with your AI to get correct output, you can simply describe what you want to build:

• "Build a sidebar dashboard layout using SGDS"
• "What spacing utility class should I use between these cards?"
• "How do I prevent a modal from closing when clicking the background?"

Your AI will respond with accurate, SGDS-aligned answers — no guessing, no wrong names, no hallucinated components.

How to install SGDS skills

Available SGDS skills

Each skill covers a different area of SGDS. You don't need to remember what's in them — your AI reads them for you.

What skills can't do

Skills guide the agent. They rely on what's underneath — llms.txt points the AI to what exists, and the SGDS documentation gives it the detail. The richer both are, the better the skills perform.