roast-my-design-system SKILL.md skillA

roast-my-design-system from gregkozakiewicz/roast-my-design-system is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add gregkozakiewicz/roast-my-design-system/roast-my-design-system@git:20261107.36e60ee

Pins git:20261107.36e60ee in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
gregkozakiewicz/roast-my-design-system
Path
skills/roast-my-design-system/SKILL.md
Versions recorded
15
Latest version
git:20261107.36e60ee, committed Nov 7, 2026
First version recorded
Aug 15, 2026
Size
14,438 bytes
Repository stars
73
License
MIT

Roast the current repo's design system with real data. Runs a deterministic scanner (no tokens, ~1s) that counts everything that betrays a design system, from colours and their near-identical twins to greys, spacing values, typefaces, duplicated and never-imported components, inline styles, !important and arbitrary Tailwind values, and compares them against Ideal Design System norms, a benchmark of 119 public repos (a 34-repo core fleet plus groups for shadcn, Tailwind, MUI, Mantine, Chakra…

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Roast my design system

You are delivering a design-system roast: brutal numbers, deadpan delivery, every claim backed by a real file path. The scanner does the measuring; you do the talking.

## Non-negotiables

- **The report is the file the diagnose script writes.** Never hand-author an HTML report from roast data, and never restyle, restructure or rebuild the generated one. Repo name, section order, the notes section and the footer all come from the script.
- **Your analysis goes inside the report, not instead of it.** Interpretation of the scan goes in `--notes`. Anything longer — an accessibility audit, an interaction review, any deep-dive the user asked for on top of the roast — goes in one or more `--section "Title" file.md` chapters on the diagnose command, which render it inside the report in its own styling. There is always room; a separate page is never needed.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add gregkozakiewicz/roast-my-design-system/roast-my-design-system@sha256:3ad5baddc38e33f8

The line at the top of this page pins the label git:20261107.36e60ee, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_je4sjrsie7tfpcyf.svg)](https://markdownregistry.com/a/art_je4sjrsie7tfpcyf)

4 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 15 versions of this file, between Aug 15, 2026 and Nov 7, 2026, about one every 6 days.

versioncommittedcommitsizeaudit
git:20261107.36e60ee latest2026-11-07 36e60ee 14,438 BA view · diff
git:20261003.a98babe2026-10-03 a98babe 14,365 BA view · diff
git:20260930.1ba2b912026-09-30 1ba2b91 14,349 BA view · diff
git:20260919.7c2d1012026-09-19 7c2d101 13,909 BA view · diff
git:20260918.bb09ed12026-09-18 bb09ed1 13,895 BA view · diff
git:20260918.02901ea2026-09-18 02901ea 13,781 BA view · diff
git:20260918.d1af3692026-09-18 d1af369 13,779 BA view · diff
git:20260917.d7c14522026-09-17 d7c1452 13,766 BA view · diff
git:20260917.8d53b762026-09-17 8d53b76 13,605 BA view · diff
git:20260914.e28e3ad2026-09-14 e28e3ad 11,492 BA view · diff
git:20260823.5d515472026-08-23 5d51547 9,576 BA view · diff
git:20260821.9281b1c2026-08-21 9281b1c 9,572 BA view · diff
git:20260819.8dee3a62026-08-19 8dee3a6 8,119 BA view · diff
git:20260817.2dad6992026-08-17 2dad699 7,223 BA view · diff
git:20260815.7abe6ff2026-08-15 7abe6ff 6,691 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (14438 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

gregkozakiewicz/roast-my-design-system · 73 stars · license MIT · pushed 2026-11-07 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_je4sjrsie7tfpcyf
GET https://markdownregistry.com/api/v1/resolve?ref=gregkozakiewicz/roast-my-design-system/roast-my-design-system
GET https://markdownregistry.com/api/v1/blob/3ad5baddc38e33f8f938e5b51fe49d5284b806fdc75681b5a9f5a2b1b8975fbc

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from gregkozakiewicz/roast-my-design-system

review SKILL.md skill
gregkozakiewicz/roast-my-design-system · skills/review/SKILL.md · Review the UI and style files changed in the working tree against this repo's own design system, before they are saved…
git:20260930.1ba2b91 · audit A · 73 stars

Every file in gregkozakiewicz/roast-my-design-system

Browse by kind, by grade A, or by owner.