ux-scenarios SKILL.md skillA

ux-scenarios 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-scenarios@git:20261027.7807c66

Pins git:20261027.7807c66 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-scenarios/SKILL.md
Versions recorded
14
Latest version
git:20261027.7807c66, committed Oct 27, 2026
First version recorded
Jul 30, 2026
Size
11,238 bytes
Repository stars
6
License
MIT

Use when writing UX scenarios (docs/ux/scenarios.md): a new feature, a user-facing behavior change, a move to scenario-driven development. Triggers: "ux scenarios" / "сценарии использования", "новая фича". Not for an empty project (vision first). Refusal phrase "no 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-scenarios — Maintain the Scenario Base

> Part of **super-ux** — see [system-map.md](references/system-map.md)
> for the whole pipeline and the four sync rules. After changes, run the
> linter (`python3 docs/ux/lint.py`).

AI-generated interfaces go bad when UI is built without a model of user
behavior. This skill keeps one: `docs/ux/scenarios.md` in the target project
is the source of truth for everything the user can do, see, and hit — every
feature, every button, every state, every error, every result.

**Format contract:** [scenario-format.md](references/scenario-format.md)
(ux-contract v4). Read it before writing or editing scenarios. Never deviate
from its field names, ID rules, statuses, or checklists.

**The WHY and HOW layers:** when `docs/ux/foundation.md` exists (personas,
JTBD, journeys, stories — `ux-foundation` skill) and/or `docs/ux/flows.md`
(task analysis, user flows — `ux-flows` skill), scenarios are derived FROM
them: one scenario set per flow, covering the happy path, every error edge,
and every alt branch of the flow diagram; `Traces:` filled with story + flow
IDs; traceability rules enforced (every must/should story covered; every
…

Read the whole file at its exact version.

How to install

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

The line at the top of this page pins the label git:20261027.7807c66, 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_hqx7v5zc4udrsucb.svg)](https://markdownregistry.com/a/art_hqx7v5zc4udrsucb)

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

Versions

The registry has recorded 14 versions of this file, between Jul 30, 2026 and Oct 27, 2026, about one every 7 days.

versioncommittedcommitsizeaudit
git:20261027.7807c66 latest2026-10-27 7807c66 11,238 BA view · diff
git:20261025.d4c4de42026-10-25 d4c4de4 11,239 BA view · diff
git:20261020.d656a922026-10-20 d656a92 11,334 BA view · diff
git:20261019.9d246052026-10-19 9d24605 11,024 BA view · diff
git:20261009.99e17cc2026-10-09 99e17cc 10,678 BA view · diff
git:20260914.18a4be52026-09-14 18a4be5 10,606 BA view · diff
git:20260910.52487e12026-09-10 52487e1 10,231 BA view · diff
git:20260909.1c2e4ab2026-09-09 1c2e4ab 9,712 BA view · diff
git:20260906.a60f6b42026-09-06 a60f6b4 9,340 BA view · diff
git:20260831.5890f872026-08-31 5890f87 9,108 BA view · diff
git:20260830.1f5f2552026-08-30 1f5f255 8,939 BA view · diff
git:20260819.46027122026-08-19 4602712 8,867 BA view · diff
git:20260804.8bc9fdd2026-08-04 8bc9fdd 8,652 BA view · diff
git:20260730.93b320a2026-07-30 93b320a 7,411 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 (11238 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-11-02 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_hqx7v5zc4udrsucb
GET https://markdownregistry.com/api/v1/resolve?ref=ssheleg/super-ux/ux-scenarios
GET https://markdownregistry.com/api/v1/blob/d1bee8cf8490d5b8bf9c398c19e63d7beb4bde6af7366ae3da035061e2f211f2

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 or checking how a product speaks: tone of voice, terminology, canonical facts, register. Triggers…
git:20261025.d4c4de4 · audit A · 6 stars
copywriting SKILL.md skill
ssheleg/super-ux · plugins/super-ux/skills/copywriting/SKILL.md · Use when writing text a user reads: UI strings, landings, store listings, posts, ads, email. Triggers: "напиши текст"…
git:20261025.d4c4de4 · audit A · 6 stars

Every file in ssheleg/super-ux

Other files named ux-scenarios

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

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