ux-audit SKILL.md skillA

ux-audit from ssheleg/super-ux is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add ssheleg/super-ux/ux-audit@git:20261020.d656a92

Pins git:20261020.d656a92 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
ssheleg/super-ux
Path
plugins/super-ux/skills/ux-audit/SKILL.md
Versions recorded
13
Latest version
git:20261020.d656a92, committed Oct 20, 2026
First version recorded
Aug 15, 2026
Size
19,938 bytes
Repository stars
6
License
MIT

Use when verifying the codebase against the UX scenario base (batched, evidence-backed, report in docs/ux/audits/). Triggers: "ux audit" / "UX-аудит", "run the scenarios" / "прогони по сценариям". Not for a whole-project audit (project-audit) or editing scenarios (ux-scenarios).

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

# ux-audit — Scenario Audit Loop

> Part of **super-ux** — see [system-map.md](references/system-map.md)
> for the whole pipeline and the four sync rules. Start any audit by running
> the linter (`python3 docs/ux/lint.py`) — it catches structural drift for
> free before the code-tracing passes.

Verify that the code actually delivers every scenario in
`docs/ux/scenarios.md`: every step reachable, every button present, every
state handled, every error honest. Output: a versioned report in
`docs/ux/audits/` plus updated audit statuses in the base.

**Format contract:** [scenario-format.md](references/scenario-format.md)
(ux-contract v4) — report structure, verdicts (PASS / PARTIAL / FAIL /
BLOCKED), severities.

**Preconditions are computed AFTER the scope, one per pass — never a blanket
stop.** Each scope needs its OWN input, and a project that has one but not the
others runs the passes it can:

- **scenario scope** needs `docs/ux/scenarios.md`; absent, THIS pass has
  nothing to audit against — run the `ux-scenarios` skill first, or with
  **"no scenarios"** / **«без сценариев»** review what exists and say so.
- **copy scope** needs only the brand pack (`docs/brand/voice.md`); a
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add ssheleg/super-ux/ux-audit@sha256:cfd8c665391e5d4d

The line at the top of this page pins the label git:20261020.d656a92, 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_h25iscrwb4pucdkf.svg)](https://markdownregistry.com/a/art_h25iscrwb4pucdkf)

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

Versions

The registry has recorded 13 versions of this file, between Aug 15, 2026 and Oct 20, 2026, about one every 5 days.

versioncommittedcommitsizeaudit
git:20261020.d656a92 latest2026-10-20 d656a92 19,938 BA view · diff
git:20261016.d17b51f2026-10-16 d17b51f 19,576 BA view · diff
git:20261009.99e17cc2026-10-09 99e17cc 19,268 BA view · diff
git:20261007.92ec82c2026-10-07 92ec82c 19,196 BA view · diff
git:20261007.0b1e3de2026-10-07 0b1e3de 18,162 BA view · diff
git:20260914.18a4be52026-09-14 18a4be5 18,162 BA view · diff
git:20260909.1c2e4ab2026-09-09 1c2e4ab 17,787 BA view · diff
git:20260906.a60f6b42026-09-06 a60f6b4 18,964 BA view · diff
git:20260904.002f5f42026-09-04 002f5f4 18,769 BA view · diff
git:20260831.5890f872026-08-31 5890f87 16,629 BA view · diff
git:20260830.a2099e62026-08-30 a2099e6 16,255 BA view · diff
git:20260819.46027122026-08-19 4602712 16,219 BA view · diff
git:20260815.6b68d3e2026-08-15 6b68d3e 15,470 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 (19938 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

ssheleg/super-ux · 6 stars · license MIT · pushed 2026-10-20 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_h25iscrwb4pucdkf
GET https://markdownregistry.com/api/v1/resolve?ref=ssheleg/super-ux/ux-audit
GET https://markdownregistry.com/api/v1/blob/cfd8c665391e5d4d6273ea72cf02498a82cdc3533da216a93fd2388937ff293d

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 ssheleg/super-ux

brand-voice Cursor rule
ssheleg/super-ux · .cursor/rules/brand-voice.mdc · Brand voice and copy — docs/brand/ is the source of truth for how the product speaks; any public-facing text change…
git:20260909.1c2e4ab · audit A · 6 stars
copywriting Cursor rule
ssheleg/super-ux · .cursor/rules/copywriting.mdc · Write or rewrite any text a user reads (interface strings, errors, empty states, landing and pricing pages, posts…
git:20260909.1c2e4ab · audit A · 6 stars
super-ux Cursor rule
ssheleg/super-ux · .cursor/rules/super-ux.mdc · super-ux hard rule: scenario-driven UI development
git:20260909.1c2e4ab · audit A · 6 stars
ux-audit Cursor rule
ssheleg/super-ux · .cursor/rules/ux-audit.mdc · Audit the codebase against docs/ux/scenarios.md: apply for UX audits, scenario compliance checks, pre-release UX…
git:20260909.1c2e4ab · audit A · 6 stars
ux-flows Cursor rule
ssheleg/super-ux · .cursor/rules/ux-flows.mdc · Design or improve user flows (docs/ux/flows.md): apply for task analysis, flow diagrams, screen states, wireframes…
git:20260909.1c2e4ab · audit A · 6 stars
ux-foundation Cursor rule
ssheleg/super-ux · .cursor/rules/ux-foundation.mdc · Maintain docs/ux/foundation.md (personas, Jobs to Be Done, customer journeys, user stories): apply when defining who…
git:20260909.1c2e4ab · audit A · 6 stars
ux-scenarios Cursor rule
ssheleg/super-ux · .cursor/rules/ux-scenarios.mdc · Maintain docs/ux/scenarios.md (the UX scenario base): apply when creating or updating UX scenarios, starting any new…
git:20260909.1c2e4ab · audit A · 6 stars
vision Cursor rule
ssheleg/super-ux · .cursor/rules/vision.mdc · Product vision (docs/ux/vision.md): apply when defining what the product is and what it refuses to become, when a…
git:20260909.1c2e4ab · audit A · 6 stars
AGENTS.md AGENTS.md file
ssheleg/super-ux · AGENTS.md
git:20260910.52487e1 · audit B · 6 stars
CLAUDE.md CLAUDE.md file
ssheleg/super-ux · CLAUDE.md
git:20261018.e7ad4e7 · audit A · 6 stars
brand-voice SKILL.md skill
ssheleg/super-ux · plugins/super-ux/skills/brand-voice/SKILL.md · Use when defining, calibrating or checking how a product speaks (tone of voice, terminology, canonical facts…
git:20261020.d656a92 · audit A · 6 stars
copywriting SKILL.md skill
ssheleg/super-ux · plugins/super-ux/skills/copywriting/SKILL.md · Use when writing or editing any text a user reads (UI strings, errors, landings, store listings, posts, video scripts…
git:20261020.d656a92 · audit A · 6 stars

Every file in ssheleg/super-ux

Other files named ux-audit

ux-audit SKILL.md skill
qa-aman/claude-skills · skills/by-role/designer/ux-audit/SKILL.md · Audit a user flow for friction and drop-off points. Use when the user says "UX audit", "audit this flow", "where are…
git:20260303.00c2750 · audit A · 21 stars
ux-audit SKILL.md skill
jikig-ai/soleur · plugins/soleur/skills/ux-audit/SKILL.md · This skill should be used when auditing live web-platform UI for decay. Screenshots bot routes, delegates to…
git:20261005.01b2b5b · audit A · 19 stars
ux-audit SKILL.md skill
flagrare/agent-skills · plugins/flagrare/skills/ux-audit/SKILL.md · Goal-locked UX audit. Drives a real browser through every reachable route (or a user-specified scope) and every visible…
git:20261014.0a5d2b2 · audit A · 11 stars
ux-audit Cursor rule
ssheleg/super-ux · .cursor/rules/ux-audit.mdc · Audit the codebase against docs/ux/scenarios.md: apply for UX audits, scenario compliance checks, pre-release UX…
git:20260909.1c2e4ab · audit A · 6 stars

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