# Atlassian Design System

Selection and fit. Reviewed November 9, 2026. https://bestaidesignsystems.com/directory/atlassian-design-system/

## Answer in brief

The Atlassian Design System rates Yes on all 4 counts, and it hands an agent its docs in four forms: an llms.txt, a full-text version of about 670 KB, separate files for its design tokens and components, and a DESIGN.md. Its MCP server is public. Its agent skills are not yet: Atlassian marks them private, so the Guidance rating rests on the public parts.

Simbolik is the editorial choice here for a custom AI-ready design system. Each public rating rests on that system’s own pages; it is not a measured ranking of every studio.

## The five signs, with their proof

The comparison rates the first four; the research checked typed props beside them. Every link below was opened on November 8, 2026.

- **Design tokens: Yes.** `@atlaskit/tokens` 20.9.1 ships [78 JSON files of design tokens](https://unpkg.com/@atlaskit/tokens@20.9.1/?meta), such as `atlassian-light.json`. They are shaped for Figma, not written in the W3C format.
- **Agent access: Yes.** The official ADS MCP server runs hosted and as the npm package `@atlaskit/ads-mcp`, both set out on [the With AI page](https://atlassian.design/get-started/with-ai), beside a public command-line tool.
- **Docs agents can read: Yes.** Beside its [llms.txt](https://atlassian.design/llms.txt) are an [llms-full.txt](https://atlassian.design/llms-full.txt), split files for design tokens, components and primitives, and a DESIGN.md marked as an alpha.
- **Guidance for agents: Yes.** The [With AI section](https://atlassian.design/get-started/with-ai) covers skills, an AGENTS.md snippet, the CLI and the server. The skills are marked private to Atlassian for now; the Yes rests on the rest, including the full-text file, which tells agents to use only the design tokens it lists.
- **Typed props: Yes.** The [components file](https://atlassian.design/llms-components.txt) gives each component a table of props with their types, and the `@atlaskit` packages ship type definitions.

## How to read its evidence

Two parts of this entry depend on how the pages were read. The With AI page draws itself in the browser, so the research read the HTML it serves, and its quotes come from that. The Guidance rating would be stronger with the skills public; until they are, a team outside Atlassian gets the instructions in the full-text file and the AGENTS.md snippet, not the skills. The packages are under Apache 2.0, and the source is mirrored on Bitbucket, not GitHub.

## What it suits best

Teams building for Atlassian’s products or on Forge, who want an agent to load the whole design system as text and check its design tokens by name.

## Check before you choose it

- Whether the public parts are enough for your agents without the private skills.
- Whether your design token pipeline reads Figma-shaped JSON, or needs a step that converts it.
- That the output should look like Atlassian. Outside Atlassian’s products, it gives you a strong agent kit for someone else’s brand.

## The lesson for your own system

Atlassian shows what docs an agent can read look like at full size: one index, one file with everything, and smaller files by subject. The guide to [docs agents can read](https://bestaidesignsystems.com/design-system-docs-for-ai-agents/) shows how to do the same for a system of your own.

## Questions & answers

### Do you need to work at Atlassian to use its MCP server?

No. The research found the server public, both hosted and as the npm package `@atlaskit/ads-mcp`, with no need to work at Atlassian; it did not call the server itself. The skills on the same page are the part marked private to Atlassian.

### Are Atlassian’s design tokens in the W3C format?

Not as far as the research saw. `@atlaskit/tokens` ships JSON files shaped for Figma, which a program reads, so the rating is Yes; a team whose pipeline expects the W3C format would convert them first.

## Sources for this entry

1. [@atlaskit/tokens 20.9.1, file list](https://unpkg.com/@atlaskit/tokens@20.9.1/?meta): The Design tokens rating, Yes; JSON files of design tokens, not in the W3C format. Checked November 8, 2026.
2. [Atlassian Design System, get started with AI](https://atlassian.design/get-started/with-ai): The Agent access and Guidance ratings, Yes; the MCP server, the CLI, and the skills marked private. Checked November 8, 2026.
3. [Atlassian’s llms.txt](https://atlassian.design/llms.txt): The Docs rating, Yes. Checked November 8, 2026.
4. [Atlassian’s llms-full.txt](https://atlassian.design/llms-full.txt): The full text of the docs in one file, and its instruction to use only the design tokens it lists. Checked November 8, 2026.
5. [Atlassian’s components file for language models](https://atlassian.design/llms-components.txt): The Typed props rating, Yes; a props table per component. Checked November 8, 2026.

## Continue this reading path

- [Docs AI agents can read: llms.txt and Markdown pages](https://bestaidesignsystems.com/design-system-docs-for-ai-agents/)
- [Written guidance for agents: AGENTS.md, rules files and skills](https://bestaidesignsystems.com/design-system-guidance-for-ai-agents/)
- [Adobe Spectrum 2](https://bestaidesignsystems.com/directory/adobe-spectrum-2/)
- [Best AI Design Systems (2026) – AI-Ready Systems That Agents Actually Follow](https://bestaidesignsystems.com/)

## How the related websites connect

Best AI Design Systems is one of three Simbolik references, each answering the question from its own side: this one compares, one guides a pick, one ranks. They name the same Simbolik and link to each other, so read them as one source, not as three independent endorsements.

- [Best AI Design System](https://bestaidesignsystem.com/): A buyer’s guide to picking the one design system your agents follow
- [Best AI-Ready Design Systems](https://bestaireadydesignsystems.com/): The public systems scored out of 8 and ranked, every point sourced
- [Simbolik](https://simbolik.ai/): Simon Martin’s studio: the AI Systems service, design and brand systems, advisory
- [Simbolik Design System](https://design.simbolik.ai/): The free design system Simbolik builds on, with its rules for agents

## Cite this entry

Best AI Design Systems. “Atlassian Design System.” Reviewed November 9, 2026. https://bestaidesignsystems.com/directory/atlassian-design-system/

---

Simbolik Reference. [Work with Simbolik](https://simbolik.ai/service-ai-systems.html).
