A glowing glass cube made of small blue and cyan cells, edged with a golden line, on a night-blue background.
Made by SOGNI DIGITALI Featured Design

design-system-builder

Builds a brand's complete design system: one interactive multilingual page and the design.md file coding agents read.

Version
1.0.0
Author
SOGNI DIGITALI, Turin
Output
HTML page + file for agents
Skill language
Instructions in English, output in your languages
Compatibility
Native, tested : Claude Code

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

AgentStatusWhat it means
Claude Code Native, testedOriginal format. The SOGNI DIGITALI design system was produced with Claude Code.
Codex Not testedAdaptation planned: an AGENTS.md file pointing to SKILL.md.
Cursor Not testedProject rule pointing to SKILL.md; not verified.
Gemini CLI Not testedGEMINI.md file pointing to SKILL.md; not verified.
GitHub Copilot Not compatibleThe 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.

FolderRole
SKILL.mdThe 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

ItemVersionWhy
Python3.10 or newerPage build, colours, icons, translations
Node.js18 or newerText extraction, QA, screenshots
BrowserMicrosoft Edge or Google Chrome installedHeadless QA
API keyNoneThe skill calls no paid service
SystemWindows, macOS or LinuxTested 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 shots

Security 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. 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.
  2. 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?
No. You describe the brand and product; the agent runs the scripts. Being able to read a file helps you review the result.
Do I own the result?
The page and design.md file you produce are yours. Fonts and icons you choose keep their authors' licences.
How long does a design system take?
It depends on the number of sections and languages. The core sections take one session; a full system is split across several agents.
Do I have to keep following you to keep the skill?
The site does not check whether you follow us, before or after. The installed skill stays in its files, on your machine.
Does the skill send my documents anywhere?
No. It has no telemetry and no calls to our servers. The only network access downloads the chosen icons from the public Iconify API, on request.

Likes and comments

No account needed: one like per browser, which you can remove. Comments are published after review.

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.

  • Readable files
  • No data sent to us
  • Tested with Claude Code
design-system-builderGet the skill

A custom skill for your trade?

We also write private skills, in your name. Let's talk about it on a 30-minute call.

Book the free call (30 min)