What is the b-end design system skill?
b-end-design-system is an MIT-licensed skill by Ludi-Herry for enterprise and back-office interfaces. Its SKILL.md gives the agent a six-step workflow, six page archetypes, seven component choice rules and visual rules such as 0.5px borders and one primary button per action area. It ships a Cursor rules file and a Windsurf rules file.
B-end means business-facing software: admin consoles, back-office tools and enterprise dashboards. This skill packages design-system rules for that kind of interface. The README is written mainly in Chinese, and the SKILL.md frames the rules as an executable constraint layer for AI coding assistants.
Beyond SKILL.md the repository carries seven reference files, four TSX page templates, a machine-readable component manifest and a Python audit script, so the agent has examples and a check rather than only prose.
What changes in your agent's output
- The agent first matches the request to one of six page archetypes: query list, step form, detail page, metrics dashboard, settings page and error or result page.
- Component choices follow seven avoid-when rules, for example a side Drawer for viewing details and a confirm dialog only for high-risk deletes.
- An action area gets at most one primary button, and status badges use a soft background with dark text.
- Borders use a fine 0.5px style and nested corners follow outer radius equals inner radius plus padding.
Who it is for and who it is not for
Best for
- Teams building admin panels, CRMs and internal tools in React with Tailwind CSS.
- Cursor or Windsurf users, since the repo ships rules files and install guides for both.
- Products with several languages, as the rules cover text expansion and right-to-left layout.
Not for
- Marketing sites and landing pages; for those see frontend-design or Premium SaaS Web.
- Projects without React and Tailwind, because the TSX templates assume them and are reference components, not a standalone app.
- Readers who need English-only documentation, since the README and guides are in Chinese.
Use it with UiChemy
The skill shapes the interface your agent writes. When a finished build needs to live in WordPress as an editable page, UiChemy AI to WordPress imports an existing AI build. Click Get Started on uichemy.com.
How to install B-End Design System Skill: Admin UI Rules for AI Coding Agents
git clone https://github.com/Ludi-Herry/b-end-design-system-skill.gitTSX templates need an existing React and TypeScript app with lucide-react and Tailwind CSS installed.Clone outside your project
Run the command above in a source folder that is not your application repository.
Copy the full package
Copy SKILL.md, LICENSE, components.manifest.json and the references, templates and scripts folders. The Cursor guide puts them in .cursor/skills/b-end-design-system and the Windsurf guide in .windsurf/skills/b-end-design-system.
Optional rules file
The repo includes a .cursorrules file and a .windsurfrules file. The Cursor guide says copying only .cursorrules gives a reduced rule set without the references.
Other agents
The docs folder has separate install guides for Claude Code, Codex and Antigravity.
Invoke it
Ask in your agent's chat, for example: Follow the b-end-design-system skill to design a customer contract list page.
Check that it loaded
In Cursor, open Customize and Skills and confirm b-end-design-system is listed. In Windsurf, check the Skills list in Cascade settings.
Key features
- Six workflow stepsDecompose the request, match a template, build the layout, apply component choice rules, apply atomic constraints, then run the gate checklist.
- Page archetypesSkeletons for list, form, detail, dashboard, settings and error pages, with business-ready recipes in one reference file.
- Avoid-when rulesSeven rules say when not to use a component, such as radios for fewer than five options or a skeleton for loads under one second.
- Modal versus DrawerViewing details prefers a side Drawer that keeps context; a blocking dialog is kept for high-risk actions.
- One primary actionA single action area may hold at most one primary button, and approval screens stay neutral.
- Button statesDefault, hover, active, disabled, loading with a repeat-click lock, and a visible focus state are all required.
- Visual rulesFine borders, concentric corner radius, soft badge colors and a 4px spacing grid are written as hard constraints.
- i18n and typographyTabular numerals, balanced text wrapping, flexible button widths for longer translations and logical properties for right-to-left.
- Component manifestcomponents.manifest.json lists components and their avoid-when contract in machine-readable form.
- Audit scriptscripts/audit-design-rules.py checks code against the design rules and needs only Python 3.
Frequently asked questions
What is the b-end design system skill?
It is an agent skill from the Ludi-Herry/b-end-design-system-skill repository that gives AI coding tools executable design rules for enterprise and back-office interfaces. It includes page templates, component choice rules, visual constraints, TSX examples, a component manifest and an audit script.
What does B-end mean?
B-end refers to business-facing software, such as admin consoles, CRMs, approval flows and internal dashboards, as opposed to consumer-facing products. The skill's six page archetypes, from query lists to settings pages, reflect that kind of work.
How do I install it in Cursor or Windsurf?
Clone the repo, then copy SKILL.md, LICENSE, the component manifest and the references, templates and scripts folders into .cursor/skills/b-end-design-system or .windsurf/skills/b-end-design-system. Do not copy SKILL.md alone, because it points to the other folders. The repo's install guides give exact commands.
Does it work with Claude Code and Codex?
The README says the rules target agents including Claude Code, Cursor, Windsurf and Codex, and the docs folder has install guides for Claude Code, Codex and Antigravity. Follow the guide for your tool and check that it discovers the skill.
Is the documentation in English?
Mostly no. The README, install guides and much of SKILL.md are in Chinese, while the component names, code and rule keywords are standard front-end terms. If you cannot read them, ask your agent to translate the install guide before copying files.
What does the audit script do?
scripts/audit-design-rules.py checks a project against the skill's design rules. It needs Python 3 and no pip packages, and the SKILL.md says to run it with the absolute path of the installed copy. It is optional.
What are the avoid-when rules?
Seven rules say when a component is the wrong choice. Examples from the README: fewer than five options use radios, details open in a Drawer rather than a modal, a skeleton is skipped under one second, and critical errors never hide inside a tooltip.
Can it help build WordPress pages?
It produces React and Tailwind interface code for admin-style products. To import an AI build into WordPress as an editable page, UiChemy AI to WordPress is the route. Click Get Started on uichemy.com. For a broader rule pack, see UI UX Pro Max.


