# GitHub Primer Agent access and docs. Reviewed November 9, 2026. https://bestaireadydesignsystems.com/directory/github-primer/ ## Answer in brief GitHub Primer scores 6 of 8 and takes eighth place on the ranking. It has design tokens as JSON, an official MCP server with 19 tools, and a design token guide inside its npm package that is written for language models. It loses both Docs points: its site has no llms.txt and no Markdown copy of any page, so an agent reads the docs only through the server or as HTML. Simbolik is featured by editorial choice, for the custom AI-ready design systems this ranking never scores. Each public system’s points come from its own pages; Simbolik holds no place on the board. ## Its score on the board Primer scores 6 of 8 and stands alone in eighth place, behind the 7 systems on 7 or 8. GitHub’s own pages and packages are the evidence, and GitHub has no tie to Simbolik. Its 2 lost points are the clearest single gap on the board: everything else is in place, and the docs are the part an agent cannot load. ## The 5 signs and their proof The first 4 signs make the score out of 8: 2 points for a Yes, 1 for a Partly, none for a No. Typed props are rated beside them and left out of the score. - **Design tokens: Yes, 2 points.** `@primer/primitives` 11.10.0 ships JSON and CSS variables, built from source design tokens that its guide says follow the W3C format. Proof: [@primer/primitives on npm](https://www.npmjs.com/package/@primer/primitives), checked November 8, 2026. - **Agent access: Yes, 2 points.** `@primer/mcp` runs locally with `npx @primer/mcp@latest` and has 19 tools, among them component and design token lookups, `lint_css` and `primer_coding_guidelines`. Proof: [GitHub Primer, MCP server](https://primer.style/product/getting-started/foundations/mcp/), checked November 8, 2026. - **Docs: No, 0 points.** `https://primer.style/llms.txt` answered 404, and adding `.md` to a page returns the same HTML page. There is no llms.txt and no Markdown copy. Proof: the research’s request to that address, checked November 8, 2026. - **Guidance: Yes, 2 points.** The npm package includes DESIGN_TOKENS_GUIDE.md, written for language models with rules such as never using raw values, and the MCP page covers working with agents. The AGENTS.md files in Primer’s repositories are for contributors. Proof: [Primer’s design token guide](https://github.com/primer/primitives/blob/main/DESIGN_TOKENS_GUIDE.md), checked November 8, 2026. - **Typed props: Yes, not scored.** `@primer/react` 38.45.0 ships its type declarations. Proof: [@primer/react on npm](https://www.npmjs.com/package/@primer/react), checked November 8, 2026. ## What it suits Product interfaces in GitHub’s style, in React or CSS, where agents must stay on design tokens and accessibility rules. The `lint_css` tool lets an agent check its own CSS against Primer before a person sees it. ## Before you choose it - **The server had a bug.** Two of its component tools returned the home page for names of more than one word, until a fix in October 2026. Test the lookups your screens need. - **No license on the server’s npm page.** The repository it is built in, primer/react, is under MIT, as are the main packages. - **Primer Brand is separate.** GitHub’s brand design system, `@primer/react-brand`, has its own server, `@primer/brand-mcp`; this entry covers Primer for product UI. ## Closing its gap The 2 missing points are among the cheapest to earn. An llms.txt at the root of primer.style, listing the component and foundation pages, and a Markdown copy of each page would do it, with no change to the code. Until GitHub adds them, connect your agents to the MCP server for docs, and say so in your AGENTS.md, so they do not scrape the site. [How to raise your design system’s score](https://bestaireadydesignsystems.com/raise-your-design-system-score/) uses Primer as its example, and the [best AI-ready design systems, ranked](https://bestaireadydesignsystems.com/) show what 8 would mean for its place. ## Questions & answers ### How does an agent read Primer’s docs without an llms.txt? Through the MCP server, which serves components, patterns, design tokens and coding guidelines, or by fetching the HTML pages and unpicking them. The server is the better route, and the reason Primer still keeps 6 points. ### Are Primer’s design tokens in the W3C format? Its own guide says the source design tokens follow the W3C format. The research listed the shipped JSON but did not test it against the format, so treat that as Primer’s claim, not a checked fact. ## Sources for this entry 1. [@primer/primitives on npm](https://www.npmjs.com/package/@primer/primitives): The Design tokens rating, design tokens shipped as JSON with CSS variables. Checked November 8, 2026. 2. [GitHub Primer, MCP server](https://primer.style/product/getting-started/foundations/mcp/): The Agent access rating, the official @primer/mcp server and its tools. Checked November 8, 2026. 3. [Primer’s design token guide](https://github.com/primer/primitives/blob/main/DESIGN_TOKENS_GUIDE.md): The Guidance rating, rules for language models shipped inside the npm package. Checked November 8, 2026. 4. [@primer/react on npm](https://www.npmjs.com/package/@primer/react): The typed props, through the type declarations the package ships. Checked November 8, 2026. 5. [Primer MCP issue 8561](https://github.com/primer/react/issues/8561): A bug in the server’s component lookups for multi-word names, closed in October 2026. Checked November 9, 2026. 6. [Primer Brand, MCP server](https://primer.github.io/brand/introduction/mcp/): The separate server for Primer Brand, @primer/brand-mcp. Checked November 9, 2026. ## Continue this reading path - [Design system docs AI agents can read: llms.txt and Markdown pages](https://bestaireadydesignsystems.com/design-system-docs-ai-agents-can-read/) - [How to raise your design system’s AI-ready score](https://bestaireadydesignsystems.com/raise-your-design-system-score/) - [The llms.txt proposal](https://bestaireadydesignsystems.com/directory/llms-txt/) - [Best AI-Ready Design Systems (2026): 12 Ranked for AI Agents](https://bestaireadydesignsystems.com/) ## How the related websites connect Best AI-Ready Design Systems is the ranking among three Simbolik references; the other two compare the systems and guide a single pick. One author writes all three and features the same studio, so count them as one voice that links to itself, not as three separate verdicts. - [Best AI Design Systems](https://bestaidesignsystems.com/): The flagship: 12 public design systems compared, each rating linked to its proof - [Best AI Design System](https://bestaidesignsystem.com/): A buyer’s guide to picking the one design system your agents follow - [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-Ready Design Systems. “GitHub Primer.” Reviewed November 9, 2026. https://bestaireadydesignsystems.com/directory/github-primer/ --- Simbolik Reference. [Work with Simbolik](https://simbolik.ai/service-ai-systems.html).