ux-flows SKILL.md skillA

ux-flows 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-flows@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-flows/SKILL.md
Versions recorded
14
Latest version
git:20261027.7807c66, committed Oct 27, 2026
First version recorded
Aug 17, 2026
Size
20,691 bytes
Repository stars
6
License
MIT

Use when designing how users move through a product: flows, screen states, wireframes, Figma mockups, funnels, paywalls. Triggers: "юзер флоу", "add a screen" / "добавь экран", "mockups" / "макеты". Not for the visual system (sheleg-design). 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-flows — Design HOW Users Move

> 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`).

Turns user stories into user flows AND maintains the UI map: task analysis →
flow diagram (mermaid) → the screen registry `screens.md` (every screen and
state with Figma frame, wireframe, coverage, resources) → optional
wireframes/Figma mockups. Also the home of UX improvement: heuristic
evaluation of existing flows and traced redesign proposals.

**Two files owned:** `flows.md` (flows referencing screens by `SCR-ID`) and
`screens.md` (the canonical per-screen spec — the design map that ties UX,
UI, Figma, and code together). A screen used by several flows is described
once in `screens.md`.

**Contracts:** [scenario-format.md](references/scenario-format.md);
for an interactive flow preview, the bounded scenario graph in
[interactive-flow-prototypes.md](references/interactive-flow-prototypes.md)
— declared first, walked second, and the preview raises no status; its
walkthrough, coverage and handoff receipt in
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add ssheleg/super-ux/ux-flows@sha256:690893be535e1eee

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_uh4oy6q542ipxtee.svg)](https://markdownregistry.com/a/art_uh4oy6q542ipxtee)

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

Versions

The registry has recorded 14 versions of this file, between Aug 17, 2026 and Oct 27, 2026, about one every 5 days.

versioncommittedcommitsizeaudit
git:20261027.7807c66 latest2026-10-27 7807c66 20,691 BA view · diff
git:20261025.d4c4de42026-10-25 d4c4de4 20,481 BA view · diff
git:20261022.13195c62026-10-22 13195c6 20,474 BA view · diff
git:20261020.d656a922026-10-20 d656a92 20,140 BA view · diff
git:20261008.29acd2b2026-10-08 29acd2b 21,467 BA view · diff
git:20261007.92ec82c2026-10-07 92ec82c 21,467 BA view · diff
git:20260910.52487e12026-09-10 52487e1 21,669 BA view · diff
git:20260909.1c2e4ab2026-09-09 1c2e4ab 20,990 BA view · diff
git:20260906.a60f6b42026-09-06 a60f6b4 19,348 BA view · diff
git:20260831.5890f872026-08-31 5890f87 19,191 BA view · diff
git:20260831.3e921f62026-08-31 3e921f6 18,818 BA view · diff
git:20260830.a2099e62026-08-30 a2099e6 18,356 BA view · diff
git:20260817.24f6c4d2026-08-17 24f6c4d 18,336 BA view · diff
git:20260817.cdb049a2026-08-17 cdb049a 18,280 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 (20691 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_uh4oy6q542ipxtee
GET https://markdownregistry.com/api/v1/resolve?ref=ssheleg/super-ux/ux-flows
GET https://markdownregistry.com/api/v1/blob/690893be535e1eeea874fa66206dd50d2fadd94584b7a4fbe9f59b14c1175c32

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-flows

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

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