Skip to main content
command CX Codex

grade — Claude Code command: what it does, how to install

grade audits design systems from a target URL, producing an HTML report card, scores, and an SVG badge. Useful when evaluating typography, color palettes, and rhythm.

MIT ★ 5,183 updated 2026-10-23

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add Manavarya09/design-extract
/plugin install designlang@designlang
Open on GitHub

What grade does

The command runs npx designlang grade against any submitted URL to inspect eight visual criteria. It assigns an overall letter grade from A to F and flags the top three strengths alongside three key layout defects.

Generated files land in ./design-extract-output/ across HTML, Markdown, and JSON formats. Adding --open launches the rendered card straight in your browser, while --badge outputs a shields.io-compatible SVG for project documentation.

Executing this audit requires npx available in your environment. If called without an address, Claude Code prompts for the URL before starting.

What it helps with

  • audit a web interface against design system conventions
  • export design evaluation files in HTML, JSON, and Markdown
  • identify top defects across typography, rhythm, and color palettes
  • produce an SVG status badge for project documentation

Example prompts for the agent

  • /grade <url> --badge --open
  • Audit the design at <url> and show the main issues
  • /grade <url> --badge

How to install grade

1Plugin marketplace

/plugin marketplace add Manavarya09/design-extract
/plugin install designlang@designlang

2Manually: put the files in place

.claude/commands/grade.md

Call it with /grade. For all projects use ~/.claude/commands/

Questions about grade

How do I install grade in Claude Code?

Add the marketplace source with /plugin marketplace add Manavarya09/design-extract, then install the package with /plugin install designlang@designlang.

What output files does the report produce?

The audit writes standalone HTML, Markdown, and JSON files to ./design-extract-output/. Passing --badge creates a companion SVG badge.

Can I embed a live badge without generating local files?

Yes, by pointing your badge image to https://designlang.app/badge/<host>.svg. That endpoint uses 24-hour blob caching with repeat responses around 50ms.

Source text

grade.md · MIT
---
description: Generate a shareable HTML "Design Report Card" — letter grade, 8 dimensions, evidence (palette, type, rhythm), strengths + fixes, plus an SVG badge.
argument-hint: <url> [--badge] [--open]
---

Audit the design system at the user-provided URL. Emits a self-contained HTML report card plus JSON + Markdown variants. Pass `--badge` to also emit a shields.io-style SVG you can drop into any README.

```bash
npx designlang grade $ARGUMENTS
```

If no `$ARGUMENTS` were supplied, ask the user which URL to grade.

After the run completes:

1. Read the generated `*.grade.md` file from `./design-extract-output/`
2. Surface the headline grade (A–F · score · 8 dimensions)
3. Highlight the top 3 strengths and top 3 issues from the report
4. Offer to open the HTML in the browser (the `--open` flag does this automatically)

If the user wants the live shareable badge URL instead of generating files locally, they can use:

```markdown
![Design Score](https://designlang.app/badge/<host>.svg)
```

This endpoint is blob-cached 24h with edge caching for ~50ms repeat hits.

Compare two sites with `/battle <A> <B>`, restyle with `/remix`, bundle everything with `/pack`.

© Manavarya Singh · MIT · Manavarya09/design-extract

Similar slash commands

All slash commands for Design →

From the same set16

The whole set →
extract-design The extract-design skill analyzes a website URL and generates files describing its design system. Use it to bring a site's colors, typography, and component patterns into a project. CX Codex +1 3,500installs designlang The designlang MCP server for Claude Code reads a site’s design system for an AI editor. It can also compare a UI with brand tokens and rate how generic a page looks. CX Codex +1 ★ 5,183repo stars battle battle puts two sites head to head and produces one shareable HTML card with scores across eight dimensions, bar-by-bar, plus a verdict line. CX Codex +1 ★ 5,183repo stars verify verify rebuilds a page from design tokens, compares the render with the live site, and reports a fidelity score. Use it to check an extracted design system. CX Codex +1 ★ 5,183repo stars remix remix reworks an already extracted page in a different visual vocabulary: brutalist, swiss, art-deco, cyberpunk, soft-ui or editorial. The layout keeps its shape. CX Codex +1 ★ 5,183repo stars studio studio starts a local token editor over your latest design extraction to preview UI components, inspect motion, and export themes. CX Codex +1 ★ 5,183repo stars gallery Turns fidelity reports into a static gallery with score cards and a page for each clone. Use it to publish design comparison results. CX Codex +1 ★ 5,183repo stars pack pack runs designlang once and drops every output — tokens, components, Storybook, prompts — into one design-system folder you can zip. CX Codex +1 ★ 5,183repo stars

More in the catalog

Project sponsors

Companies that keep this analytics open