readydesign-skill
Skill14 starsChanged 3 months agoMITView on GitHub
Force UI work onto six ready-to-use libraries only: shadcn/ui, Ant Design, Kokonut UI, Motion (motion.dev), Bklit (bklit.com), and sashimi UI. Web-fetch each official site one-by-one and install the real components from those pages — never invent APIs, class names, colors, or components from memory. Use when building or restyling a UI, scaffolding a frontend, adding components, picking a design system, or when the user says ReadyDesign, ready-to-use components, shadcn, antd, kokonut, motion.dev, framer motion, bklit, sashimi, or runs /readydesign-skill or $readydesign-skill.
- Installs packages
In this repository4 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- readydesign-skillSkill
- readydesign-skillSkill
The file
Show its rules and text
We split this skill into the rules it gives an agent
18 rules. About 0 are common, 15 are distinctive, and 3 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈15
Distinctive · estimate
This author's own choices. Worth a look.
3
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 53
Do not write UI until the fetches for this session have started.
- Distinctive: line 61
Ask the required user questions (below).
- Distinctive: line 68
If a fetch fails: retry that same URL once.
- Very specific: line 71
If a catalog HTML page returns almost no content, fetch that source's markdown / llms.txt / .md docs URL instead (shadcn: …
- Very specific: line 87
Do not put two primitive kits on the same control (no antd Button wrapped in a shadcn Button).
- Distinctive: line 93
If the project is new and the user did not give a design, brand palette, or token file:
- Distinctive: line 96
Keep each installed component's original colors, tokens, and theme CSS exactly as the official source ships them.
- Distinctive: line 98
Do not change a hex, hsl, oklch, shade, radius, or shadow "to match."
- Distinctive: line 99
Do not invent a custom palette.
- Distinctive: line 101
If the user did give a design, apply their tokens and still use only these six sources.
- Distinctive: line 106
Do not dump a questionnaire up front.
- Distinctive: line 110
Should I use animations and motion on every place and action, or only on key interactions?
- Distinctive: line 114
Do you have a brand/design, or should I keep each library's original colors untouched?
- Distinctive: line 122
After the component page is fetched:
- Distinctive: line 136
Do not hand-write a stand-in that "looks like" a library component.
- Distinctive: line 137
If the official component exists, add it.
- Distinctive: line 141
Every UI import in the change must map to a URL fetched in this session.
- Distinctive: line 142
If you cannot point at that fetch, fetch it now or remove the import.
≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
ReadyDesign
UI may come only from these six official sources. Fetch their live docs one-by-one and install what those pages actually ship. Memory, training data, and "shadcn-like" custom rebuilds are not allowed.
Allowed sources
Fetch these pages. Do not substitute blogs, YouTube, or memory.
| Source | Use for | Catalog / start here | Then open |
| shadcn/ui | App primitives: button, form, dialog, table, sidebar | https://ui.shadcn.com/llms.txt | https://ui.shadcn.com/docs/components and the component URL listed there |
| Ant Design | Enterprise / data-dense controls | https://ant.design/components/overview | https://ant.design/components/`<name> or https://ant.design/components/<name>`.md |
| Kokonut UI | Decorative / marketing sections, animated extras | https://kokonutui.com/docs | The component page you will install from |
| Motion | All animation and gesture motion | https://motion.dev/docs/react | The specific guide (animation, gestures, layout, presence) plus https://motion.dev/examples |
| Bklit | Charts and data visualization | https://bklit.com/docs/components | https://bklit.com/docs/installation then the chart page you will add |
| sashimi UI | Native HTML/CSS, no-JS chrome | https://yuto-hasegawa.github.io/sashimi-ui/ | https://yuto-hasegawa.github.io/sashimi-ui/getting-started/ |
Agent extras, fetch when that source is in play:
- shadcn CLI: https://ui.shadcn.com/docs/cli
- Ant Design agents: https://ant.design/docs/react/for-agents.md and https://ant.design/llms.txt
- Motion install: https://motion.dev/docs/react-installation
Nothing else is a UI source. MUI, Chakra, Mantine, DaisyUI, Bootstrap, Flowbite, Magic UI, Aceternity, HeroUI, Radix Themes, GSAP, anime.js, Recharts/Tremor/Chart.js used directly, and handmade "inspired by" components are banned.
Fetch protocol (do this, in this order)
Do not write UI until the fetches for this session have started.
Fetch one URL at a time with the host's page-fetch tool (WebFetch,
web_fetch, open_page, curl, or equivalent). Never batch catalog
fetches. Never skip a source because you "already know it." Search
snippets are not a substitute for the official page.
- Fetch all six catalog / start-here URLs from the table, one after another. Record the real component names each page lists.
- Ask the required user questions (below). Use the answers to decide which sources you will actually install from.
- For every component you will add, fetch that component's official page (or its registry JSON) before you install or paste it.
- Install or copy using only the command, import path, and API shown on the page you just fetched. If the page and your memory disagree, the page wins.
- If a fetch fails: retry that same URL once. If it still fails, stop and tell the user which URL died. Do not invent the missing component.
If a catalog HTML page returns almost no content, fetch that source's
markdown / llms.txt / .md docs URL instead (shadcn:
https://ui.shadcn.com/llms.txt; antd:
https://ant.design/components/`<name>`.md).
Pick a source
| Need | Source |
| Charts, gauges, heatmaps, funnels, analytics | Bklit |
| Motion, hover/tap, layout, exit, scroll animation | Motion (motion/react) |
| Buttons, inputs, dialogs, tables, sidebars, toasts | shadcn/ui |
| Heavy enterprise forms, dense admin, antd-only widgets | Ant Design |
| Hero treatments, particle buttons, decorative blocks | Kokonut UI |
| Semantic native HTML / CSS-only controls | sashimi UI |
Do not put two primitive kits on the same control (no antd Button
wrapped in a shadcn Button). You may compose: shadcn/antd/sashimi
structure + Kokonut decoration + Motion motion + Bklit charts.
Color lock
If the project is new and the user did not give a design, brand palette, or token file:
- Keep each installed component's original colors, tokens, and theme CSS exactly as the official source ships them.
- Do not change a hex, hsl, oklch, shade, radius, or shadow "to match."
- Do not invent a custom palette. Do not restyle defaults.
If the user did give a design, apply their tokens and still use only these six sources.
Ask the user (2–4 times while working)
Do not dump a questionnaire up front. Ask 2 to 4 of these as real decisions come up. Wait for the answer before that part of the UI.
- Are there any analysing charts?
- Should I use animations and motion on every place and action, or only on key interactions?
- Is this a marketing/landing surface, an app shell, or a data-dense admin?
- Do you have a brand/design, or should I keep each library's original colors untouched?
- Any forms that need heavy validation, dates, uploads, or steppers?
Skip a question only when the user already answered it in this thread.
Add the real thing
After the component page is fetched:
- shadcn:
npx shadcn@latest add <name>(name from the fetched docs) - Kokonut: add the
@kokonutuiregistry from https://kokonutui.com/docs, thennpx shadcn@latest add @kokonutui/<name> - Bklit: add the
@bklitregistry from https://bklit.com/docs/installation, thennpx shadcn@latest add @bklit/<name> - Ant Design:
npm install antdas on https://ant.design/docs/react/introduce, then import the component whose page you fetched - Motion:
npm install motionas on https://motion.dev/docs/react-installation, thenimport { motion } from "motion/react" - sashimi: follow https://yuto-hasegawa.github.io/sashimi-ui/getting-started/
(
npm install sashimi-uior the CSS files that page names)
Do not hand-write a stand-in that "looks like" a library component. If the official component exists, add it.
Before you finish
Every UI import in the change must map to a URL fetched in this session. If you cannot point at that fetch, fetch it now or remove the import.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

