review-design SKILL.md skillA

review-design from mgiovani/cc-arsenal is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add mgiovani/cc-arsenal/review-design@v1.1.1

Pins v1.1.1 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
mgiovani/cc-arsenal
Path
skills/review-design/SKILL.md
Versions recorded
7
Latest version
v1.1.1, committed Oct 5, 2026
First version recorded
Jun 16, 2026
Size
13,286 bytes
Repository stars
8
License
MIT

Performs a comprehensive UX/UI/design quality audit of a live URL or a.

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

# Design Review

Comprehensive UX/UI/design quality analysis across 8 audit dimensions, each mapped to
authoritative standards. This skill only analyzes: it identifies design
issues, explains findings against a cited criterion, and suggests fix approaches without
making code changes.

It supports two input modes:

- Live mode: audits a running URL via the `agent-browser` CLI (screenshots + DOM/accessibility snapshot).
- Static mode: audits a codebase (CSS/components/design tokens) via Grep.

When both a URL and a codebase target are supplied, it runs both and emits two separate reports.

## Audit Taxonomy (8 Dimensions)

| # | Dimension | Key Standards |
|---|-----------|---------------|
| 1 | Visual Hierarchy & Layout | NN/g, Refactoring UI, Laws of UX, MD3 8pt grid |
| 2 | Typography | Butterick, Refactoring UI, MD3, Apple HIG |
| 3 | Color & Theming (incl. Dark Mode) | MD3 color roles, 60-30-10, WCAG 1.4.1/1.4.3 |
| 4 | Depth & Elevation (Shadows) | MD3 elevation, Refactoring UI, Josh Comeau |
| 5 | Components & Affordance (Buttons/Icons) | MD3 buttons/icons, Apple HIG, NN/g |
| 6 | Feedback & States | NN/g visibility-of-status, MD3 state layers |
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add mgiovani/cc-arsenal/review-design@sha256:ef71ca127def69ed

The line at the top of this page pins the label v1.1.1, 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_oxs2uxmwstwe4ali.svg)](https://markdownregistry.com/a/art_oxs2uxmwstwe4ali)

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

Versions

The registry has recorded 7 versions of this file, between Jun 16, 2026 and Oct 5, 2026, about one every 18 days.

versioncommittedcommitsizeaudit
v1.1.1 latest2026-10-05 b620662 13,286 BA view · diff
v1.1.12026-09-25 ca015cc 13,264 BA view · diff
v1.1.12026-09-24 a80f9cd 13,240 BA view · diff
v1.1.12026-09-16 0d6e629 13,301 BA view · diff
v1.1.12026-07-27 fa2e9cf 13,205 BA view · diff
v1.1.12026-07-19 4ee8666 13,248 BA view · diff
v1.0.02026-06-16 4475a8d 12,341 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 (13286 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

mgiovani/cc-arsenal · 8 stars · license MIT · pushed 2026-10-28 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_oxs2uxmwstwe4ali
GET https://markdownregistry.com/api/v1/resolve?ref=mgiovani/cc-arsenal/review-design
GET https://markdownregistry.com/api/v1/blob/ef71ca127def69edb243d2f473cfcae8e1180744284c368ac9a1eaa82a6fc4d5

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 mgiovani/cc-arsenal

AGENTS.md AGENTS.md file
mgiovani/cc-arsenal · AGENTS.md
git:20261005.b0bf138 · audit A · 8 stars
CLAUDE.md CLAUDE.md file
mgiovani/cc-arsenal · CLAUDE.md
git:20260924.a80f9cd · audit B · 8 stars
CLAUDE.md@examples/claude-md/bash CLAUDE.md file
mgiovani/cc-arsenal · examples/claude-md/bash/CLAUDE.md
git:20260925.ca015cc · audit A · 8 stars
CLAUDE.md@examples/claude-md/fastapi CLAUDE.md file
mgiovani/cc-arsenal · examples/claude-md/fastapi/CLAUDE.md
git:20260925.ca015cc · audit A · 8 stars
CLAUDE.md@examples/claude-md/nodejs CLAUDE.md file
mgiovani/cc-arsenal · examples/claude-md/nodejs/CLAUDE.md
git:20260925.ca015cc · audit A · 8 stars
CLAUDE.md@examples/claude-md/reactjs CLAUDE.md file
mgiovani/cc-arsenal · examples/claude-md/reactjs/CLAUDE.md
git:20260925.ca015cc · audit A · 8 stars
llms.txt@scripts/tests/fixtures/anything_to_skill/web llms.txt file
mgiovani/cc-arsenal · scripts/tests/fixtures/anything_to_skill/web/llms.txt
git:20260930.e89382d · audit A · 8 stars
agent-browser SKILL.md skill
mgiovani/cc-arsenal · skills/agent-browser/SKILL.md · Headless browser automation CLI optimized for AI agents: drives a real browser via accessibility-tree snapshots and…
git:20261005.b620662 · audit A · 8 stars
anything-to-skill SKILL.md skill
mgiovani/cc-arsenal · skills/anything-to-skill/SKILL.md · Turns a docs site, local folder, PDF or book, YouTube video, playlist or channel, or a topic into a source-grounded…
git:20261005.b620662 · audit A · 8 stars
ci-generate SKILL.md skill
mgiovani/cc-arsenal · skills/ci-generate/SKILL.md · Generate a production-ready CI/CD pipeline config (GitHub Actions,
v1.0.0 · audit A · 8 stars
ci-local SKILL.md skill
mgiovani/cc-arsenal · skills/ci-local/SKILL.md · Run the checks a GitHub Actions workflow would run, locally, when Actions
git:20261005.b620662 · audit A · 8 stars
clotho-research SKILL.md skill
mgiovani/cc-arsenal · skills/clotho-research/SKILL.md · Find what a change will actually touch before planning it — the existing
v1.0.0 · audit A · 8 stars

Every file in mgiovani/cc-arsenal

Other files named review-design

review-design SKILL.md skill
serpro69/claude-toolbox · kodex-plugin/skills/review-design/SKILL.md · Review design, implementation, and task documents produced by design. Evaluates document quality, internal consistency…
git:20261025.9787473 · audit A · 155 stars
review-design SKILL.md skill
serpro69/claude-toolbox · klaude-plugin/skills/review-design/SKILL.md · Review design, implementation, and task documents produced by design. Evaluates document quality, internal consistency…
git:20261025.7dcde54 · audit A · 155 stars
review-design SKILL.md skill
doodledood/manifest-dev · claude-plugins/manifest-dev/skills/review-design/SKILL.md · Review digital artifacts against the user’s task, creative direction, functional and accessibility requirements, and…
git:20261025.686cdf9 · audit A · 77 stars
review-design SKILL.md skill
gtrabanco/agentic-workflow · skills/review-design/SKILL.md · Internal UI/UX design review pass of the agentic-workflow review pack — composed in-turn by review-change and…
v4.10.0 · audit A · 23 stars
review-design SKILL.md skill
urmzd/dotfiles · dot_agents/skills/review-design/SKILL.md · Pragmatic Programmer principles: DRY, orthogonality, ETC, reversibility, tracer bullets, design by contract…
git:20260530.d3be4dd · audit A · 5 stars

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