
design-system-builder
Builds a brand's complete design system: one interactive multilingual page and the design.md file coding agents read.
What the skill does
From a logo, a few colours and the product documents, your agent builds a design system people can use: one page that shows every decision with copyable values, and a short file coding agents read.
The page works offline, in all your languages, and is checked in a real browser.
What you get
- Tokens and light and dark themes, with contrast and colour blindness checked.
- Typography, animated icons, Hairline illustrations that follow the pointer.
- Animated SVG splash and loader, generated from your mark.
- Components with every state, plus an accessibility button and panel.
- Your product's screens: CRM, site, shop, booking, SaaS, mobile, emails, AI assistant.
- Dictionary translations, automatic QA and screenshots.
Who it is for
- Studios and agencies that deliver a brand and its screens.
- Product teams that want a guide their coding agents follow.
- Founders starting from a logo and three colours.
Less suited if
- You want a Figma file: the output is an HTML page.
- Your machine has neither Edge nor Chrome: QA needs one.
The SOGNI DIGITALI design system was built with this skill. Open it: it is the result itself, offline.
- 33numbered sections
- 3languages
- 3modes (Dark, Light, Colour)
- 180Line MD icons, licences recorded
Compatibility, agent by agent
| Agent | Status | What it means |
|---|---|---|
| Claude Code | Native, tested | Original format. The SOGNI DIGITALI design system was produced with Claude Code. |
| Codex | Not tested | Adaptation planned: an AGENTS.md file pointing to SKILL.md. |
| Cursor | Not tested | Project rule pointing to SKILL.md; not verified. |
| Gemini CLI | Not tested | GEMINI.md file pointing to SKILL.md; not verified. |
| GitHub Copilot | Not compatible | The skill runs Python and Node scripts and a browser: beyond a completion assistant. |
- Native, testedoriginal format, verified on a real project
- Adapted, testedadaptation file provided and verified
- Not testedno promise
- Not compatiblethe reason is written
What the package contains
215 files, 15.0 MB unpacked, 3.7 MB ZIP. Everything is readable; dependencies ship with their licence, nothing is installed separately.
| Folder | Role |
|---|---|
SKILL.md | The instructions the agent follows: nine phases, from discovery to hand-over. |
references/ | The detailed method per topic and nine screen packs per product type. |
scripts/ | Project scaffold, build, colour checks, icons, translations, QA and screenshots. |
assets/ | Page template, base CSS, page scripts, starter sections, Atkinson Hyperlegible font. |
vendor/ | Hairline 0.5.0 (MIT), its figure engine (MIT) and playwright-core 1.64 (Apache-2.0), no browser bundled. |
evals/ | Four test cases for the skill, with the expected output. |
What your machine needs
| Item | Version | Why |
|---|---|---|
| Python | 3.10 or newer | Page build, colours, icons, translations |
| Node.js | 18 or newer | Text extraction, QA, screenshots |
| Browser | Microsoft Edge or Google Chrome installed | Headless QA |
| API key | None | The skill calls no paid service |
| System | Windows, macOS or Linux | Tested on Windows 11 |
What the agent will ask you to allow
- Read and write the project folder
- Run python and node
- Open a headless browser
- Network on demand: api.iconify.design
Install the skill
Two ways: one command, or the ZIP unzipped by hand. Pick your agent.
The install command will be published soon; until then, install the skill by hand from the ZIP.
Claude Code Native, tested
The command and the install prompt appear in the “Get this skill” box, after the TikTok and Instagram step. Go to the box.
Restart Claude Code: the skill appears in the skills list.
Codex Not tested
The command copies the folder into .agents/skills and adds a line to AGENTS.md pointing to SKILL.md. By hand: copy the folder into your repository and add that line yourself.
Cursor Not tested
The command copies the folder into .agents/skills and creates a .cursor/rules project rule pointing to SKILL.md.
Gemini CLI Not tested
The command copies the folder into .agents/skills and adds a line to GEMINI.md pointing to SKILL.md.
GitHub Copilot Not compatible
This skill is not compatible with GitHub Copilot: the reason is in the Compatibility tab.
Other agent Not tested
Any agent that reads files can follow the method: give it SKILL.md as instructions and keep the folder next to it, so it finds the scripts and references.
Using the skill
Just ask for the result. The agent asks what is missing (product type, languages, screens), works in phases and looks at its screenshots before saying it is done.
- Creation
"Create our CRM's design system in French, Italian and English. Here are the logo and the colour sheet."
- Adding a section
"Add a Products section to our design system, with the product page and stock per warehouse."
- Illustrations
"Make our CRM's empty-state illustrations: no leads, empty inbox, no results, 404 and 500 pages."
- Accessibility
"Add an accessibility button: text size, higher contrast, colour-blind colours, animations off."
The commands, if you want to run them yourself
python scripts/new_project.py ../acme --name "Acme" --type crm --langs fr,it,en --source fr
python scripts/palette_check.py ../acme
python scripts/build.py ../acme
node scripts/qa.mjs ../acme
node scripts/qa.mjs ../acme shotsSecurity and privacy
-
No data sent to SOGNI DIGITALI
The skill has no telemetry, no counters, no calls to our servers. Your brand and documents stay on your machine.
-
One network call, on request
scripts/fetch_icons.py downloads the chosen icons from the public Iconify API. The build and the page work offline.
-
Readable code
Plain Python and JavaScript, no compiled files, no hidden code. Read them before the first run.
-
Declared dependencies
Hairline (MIT), playwright-core (Apache-2.0), Atkinson Hyperlegible (OFL): versions and licences in THIRD_PARTY_NOTICES.md.
-
Download integrity
Every ZIP ships with its SHA-256 checksum, shown on this page. The install command checks it before writing any file.
Versions and changes
- 1.0.0
- Three colour modes: Dark, Light and Colour, with cool, warm and balanced temperatures.
- Glowing card edge, on hover and keyboard focus only.
- Shared "AI-generated image" caption, always outside the image.
- 0.9.0
- First release: light and dark themes, SVG splash, Hairline illustrations, accessibility panel, in-browser QA.
Support and questions
-
By email
support@sognidigitali.com, with the skill name and version. Response time.
-
Documentation included
README, SKILL.md and fourteen references: the full method is in the package.
Do I need to code?
Do I own the result?
How long does a design system take?
Do I have to keep following you to keep the skill?
Does the skill send my documents anywhere?
Likes and comments
No account needed: one like per browser, which you can remove. Comments are published after review.
Loading likes and comments…
Comments
Leave a comment
design-system-builder · v1.0.0
Get this skill
Follow SOGNI DIGITALI on TikTok and Instagram: the command and the ZIP appear here.
This site cannot check whether you follow us: we trust you.
Install command
Other agents
Install prompt, to paste into Claude Code:
ZIP SHA-256 checksum :
- Readable files
- No data sent to us
- Tested with Claude Code
A custom skill for your trade?
We also write private skills, in your name. Let's talk about it on a 30-minute call.