improve-ui SKILL.md skillA

improve-ui from discriminative-shoji607/ui-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add discriminative-shoji607/ui-skills/improve-ui@git:20260715.b7a88e7

Pins git:20260715.b7a88e7 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
discriminative-shoji607/ui-skills
Path
skills/improve-ui/SKILL.md
Versions recorded
1
Latest version
git:20260715.b7a88e7, committed Jul 15, 2026
Size
7,830 bytes
Repository stars
3
License
MIT

Audit an existing product surface against its own design evidence, identify verified UI problems, and write self-contained implementation plans for another agent. Strictly read-only on product source. Use when asked to review, refine, improve, or clean up an interface without replacing its identity; investigate design-system drift; or prepare a design handoff.

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

# Improve UI

Audit one coherent product surface against the system that actually governs it. Preserve the product's identity, reuse existing owners, and prefer no finding to an unsupported one. Write plans only for changes the user selects; another agent executes them.

## Boundaries

- Never modify product source. Create or edit files only under `design-plans/`.
- Do not install dependencies, run formatters, commit, push, or otherwise mutate the working tree.
- Do not update design documentation. Record accepted documentation changes in the plan for its executor.
- Use rendered evidence only when the user provides it or explicitly requests visual inspection.
- Make every plan self-contained; its executor has no context from the audit or conversation.

## 1. Select the surface

Honor the user's scope. If the request is broad, select one deployable application and one coherent surface family representing a primary product task. State the selection; do not synthesize the whole repository into one product.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add discriminative-shoji607/ui-skills/improve-ui@sha256:fa2ac808f6d9dab7

The line at the top of this page pins the label git:20260715.b7a88e7, 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_csopgj6dyvtwfeok.svg)](https://markdownregistry.com/a/art_csopgj6dyvtwfeok)

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

Versions

The registry has recorded 1 version of this file, committed on Jul 15, 2026.

versioncommittedcommitsizeaudit
git:20260715.b7a88e7 latest2026-07-15 b7a88e7 7,830 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 (7830 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

discriminative-shoji607/ui-skills · 3 stars · license MIT · pushed 2026-10-14 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_csopgj6dyvtwfeok
GET https://markdownregistry.com/api/v1/resolve?ref=discriminative-shoji607/ui-skills/improve-ui
GET https://markdownregistry.com/api/v1/blob/fa2ac808f6d9dab7bb3620880b014d2c18e227e5b006102856038096e573e69a

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 discriminative-shoji607/ui-skills

baseline-ui SKILL.md skill
discriminative-shoji607/ui-skills · skills/baseline-ui/SKILL.md · Quickly deslop UI code by fixing spacing, hierarchy, typography, and small layout issues. Use when the interface needs…
git:20260611.edda651 · audit A · 3 stars
fixing-accessibility SKILL.md skill
discriminative-shoji607/ui-skills · skills/fixing-accessibility/SKILL.md · Audit and fix HTML accessibility issues including ARIA labels, keyboard navigation, focus management, color contrast…
git:20260219.df4eb34 · audit A · 3 stars
fixing-metadata SKILL.md skill
discriminative-shoji607/ui-skills · skills/fixing-metadata/SKILL.md · Audit and fix HTML metadata including page titles, meta descriptions, canonical URLs, Open Graph tags, Twitter cards…
v1.0.1 · audit A · 3 stars
fixing-motion-performance SKILL.md skill
discriminative-shoji607/ui-skills · skills/fixing-motion-performance/SKILL.md · Audit and fix animation performance issues including layout thrashing, compositor properties, scroll-linked motion, and…
git:20260219.df4eb34 · audit A · 3 stars
ui-skills-root SKILL.md skill
discriminative-shoji607/ui-skills · skills/ui-skills-root/SKILL.md · Use before UI-related work to select the smallest useful UI Skills context through the ui-skills CLI.
v1.0.0 · audit A · 3 stars

Every file in discriminative-shoji607/ui-skills

Other files named improve-ui

improve-ui SKILL.md skill
bjornmelin/dev-skills · skills/improve-ui/SKILL.md · Read-only design-system drift audit: compare an implementation against its own documented design contract, prove each…
git:20260805.9eb2601 · audit A · 8 stars
improve-ui SKILL.md skill
transitive-bullshit/skills · provenance/upstream/improve-ui/SKILL.md · Audit an existing product surface against its own design evidence, identify verified UI problems, and write…
git:20261011.ef64499 · audit A · 4 stars
improve-ui SKILL.md skill
transitive-bullshit/skills · skills/improve-ui/SKILL.md · Audit an interface for design inconsistencies and prepare implementation plans. Use for explicit UI audits…
git:20261002.164a2bc · audit A · 4 stars

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