Design systems
A design system is your design system's package: the zip you upload (with its SKILL.md, tokens, assets and components), kept as it is, in versions. AI tools install it as a skill, Claude uses it when it builds pages, themes and cards for you, and you can share it with a link. A workspace can keep several, one for each purpose.
Design systems imported into the Brand Vault before October 2026 were converted to packages: the assets, folders and themes they created stay in your Brand Vault exactly as they were, and simply stop syncing.
Availability: plans that include design systems. If you don't see Design systems under Brand Vault, ask your account administrator.
How design systems work
The zip you upload is kept as it is, versioned and shared; nothing is imported into your Brand Vault.
- Upload the design system's zip. Any design system export works (Claude Design and others), up to the size shown on the upload field. Nothing is added to your Brand Vault.
- Include its
SKILL.md. It's what lets AI tools such as Claude, Claude Code, Cursor or Codex install the design system as a skill. A zip without a validSKILL.mdstill uploads, with a warning saying why (for example, a name with capital letters); it can't be exported or shared as a skill until you upload a zip that contains one. linkable.id never writes aSKILL.mdfor you. A zip of a Design System in Claude, put together by Claude or by hand, usually has none (the Design System's ownSKILL.mdonly explains the format), so to share it as a skill, ask Claude to write the brand'sSKILL.mdinto the zip first. - Every upload is a new version and becomes current at once. Versions lists them with the files added, changed and removed since the version before; Files shows every file of a version and its
SKILL.mdcheck. Make current on an earlier version goes back to it. Share links keep the version they point to. - Keep as many design systems as you need: one per campaign, for print, web, social media or an event. Give each a name and a description that say what it's for.
- Make one the workspace default with Make workspace default, on the design system's page (a design system shared with your workspace can be its default too). Claude uses the default when a task doesn't point to another design system.
Making a version current or a design system the default needs permission to edit design systems.
Before packages: importing into the Brand Vault
Until October 2026 a design system was imported into the Brand Vault. The import was retired in November 2026; what became of the assets, folders, themes and hubs it created is in Design systems imported into the Brand Vault. Sharing, exporting and Claude, below, apply to every design system.
Sharing a design system as a skill
Share as skill, on the design system's page, makes links that download the design system as an Agent Skill (the same zip as Export → Skill for AI tools). Use them to give the design system to an AI tool, a developer or an agency.
- Each link downloads one version. It keeps that version after you publish a new one, until you switch it with Edit; the URL stays the same.
- Members only by default. Someone opening a members-only link signs in to linkable.id, and must be a member of your workspace (or of one the design system is shared with) who can view design systems.
- Public, if you choose. Make public lets anyone with the link download it, without signing in, on a domain of your workspace. You confirm it by typing a word, because the zip holds your logos, guidelines and files. Members only or Revoke stops a public link at once.
- Expiry and revoking. A link can expire on a date; a revoked or expired link stops working and can't be turned back on.
- The list shows each link's version, who can download it, and how many times it was downloaded.
Managing links needs the Share as a skill (links) permission on design systems.
Sharing a design system with other workspaces
Use Manage sharing (the share icon in the list, or the button at the top of the design system) to let other workspaces of your organization use a design system. They get it read-only, together with its Brand Vault folders and assets, its themes and its hub: their pages can use the themes and assets, and Claude can read the system from there. Everything a later import or publish adds is shared with them too. Only your workspace imports, publishes, changes or deletes it.
Sharing it needs the Share with other workspaces permission on design systems. When you stop sharing, anything the other workspace already uses (a page on one of the themes, a widget showing one of the folders) stays shared with it, and linkable.id tells you which pieces; everything else stops being shared. Anything you had shared with that workspace on its own, before, is left as it was.
Exporting a design system
Use Export (under More actions (⋯) on the design system) to download a version as a .zip. It's prepared in the background: you get a notification with the link, and it stays on My downloads for 3 days. Any version whose package linkable.id still keeps can be exported.
- Skill for AI tools: the design system as an Agent Skill, the format Claude, Claude Code, Cursor, Codex and other AI tools read. The zip holds one folder named after the skill, with its
SKILL.md, the system's files andlinkable.json. The designer's source material (uploads/) is left out, and so are font files unless the import confirmed their license;linkable.jsonlists what was left out and why. It needs a validSKILL.mdin the package: linkable.id never writes one, so a version without it can't be exported as a skill. To install it, upload the zip in Claude's skill settings, or unzip the folder into your project's skills folder (for Claude Code,.claude/skills/); each tool's documentation has the exact steps.
Claude can also export the original package (for a round trip) through the connector.
Exporting needs only the permission to view design systems.
Limits
| Limit | Value |
|---|---|
| Upload (zip) | 50 MB |
| Unpacked package | 200 MB |
| One file in the package | 20 MB |
| Files in the package | 2,000 |
Kept packages count toward your plan's storage.
With Claude
With the Claude connector, Claude can list your design systems, load one and follow its SKILL.md while it builds pages, themes, cards and Custom Pages, bring in a new version of a package, export it, set the default, and create and change share links.
- Connection permissions: View design systems to use and export them; Create design systems and bring in new versions to upload; Publish design system versions for the default, the current version and share links. Your role's permissions still apply.
- Goes live: a new version becomes current at once; a public share link can be downloaded by anyone with it.
- Stays in the panel: deleting design systems and versions.
Try asking:
- "Use our default design system to build a private landing page for the new product."
- "Make a members-only share link to the current version of our design system."