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
/plugin marketplace add Manavarya09/design-extract
/plugin install designlang@designlangWhat 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@designlang2Manually: put the files in place
.claude/commands/grade.mdCall it with /grade. For all projects use ~/.claude/commands/
Manually: put the files in place
~/.codex/prompts/grade.mdCall it with /prompts:grade. Codex marks this format deprecated in favour of skills
Manually: put the files in place
.github/prompts/grade.prompt.mdManually: put the files in place
.gemini/commands/grade.tomlGemini stores commands as TOML: the prompt text goes into the prompt field
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  ``` 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