superior-ux SKILL.md skillA

superior-ux from kodekateam/superior-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add kodekateam/superior-skills/superior-ux@git:20261106.9769969

Pins git:20261106.9769969 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
kodekateam/superior-skills
Path
skills/superior-ux/SKILL.md
Versions recorded
2
Latest version
git:20261106.9769969, committed Nov 6, 2026
First version recorded
Oct 20, 2026
Size
4,867 bytes
Repository stars
47
License
MIT

Design or review product experiences through user goals, journeys, information architecture, task flows, interaction models, feedback, recovery, and cross-screen continuity. Use when the primary question is how users understand and complete a goal across steps or surfaces. Do not use for visual styling, implementation-only logic, or unsupported user-research claims.

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

# Superior UX

Make the user's path to a meaningful outcome clear, coherent, and recoverable. Base decisions on product evidence and observable behavior; never invent research, personas, or confidence that the project does not support.

## Establish the experience contract

Before proposing a flow, identify:

- the primary user, job, context, and entry point;
- the successful outcome and how the user recognizes it;
- required decisions, information, permissions, and constraints;
- existing routes, screens, terminology, analytics, research, support evidence, and product rules;
- interruptions, failures, alternate paths, and return visits that materially affect completion.

Separate observed evidence from assumptions. Ask for direction when competing assumptions would change who the product serves, what consent means, or what outcome counts as success. Otherwise, use the smallest reversible assumption and state it.

Read [references/journeys-task-flows-and-information-architecture.md](references/journeys-task-flows-and-information-architecture.md) when work spans multiple steps, screens, roles, entry points, or navigation levels.

## Shape the journey
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add kodekateam/superior-skills/superior-ux@sha256:f34918ad4754d479

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

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

Versions

The registry has recorded 2 versions of this file, between Oct 20, 2026 and Nov 6, 2026, about one every 17 days.

versioncommittedcommitsizeaudit
git:20261106.9769969 latest2026-11-06 9769969 4,867 BA view · diff
git:20261020.ce4784f2026-10-20 ce4784f 4,860 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 (4867 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

kodekateam/superior-skills · 47 stars · license MIT · pushed 2026-11-06 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_wrdat7ub2nhcwu32
GET https://markdownregistry.com/api/v1/resolve?ref=kodekateam/superior-skills/superior-ux
GET https://markdownregistry.com/api/v1/blob/f34918ad4754d479e4ec86464d07e77797fb6afe8d82707254e00dc439bccbcd

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 kodekateam/superior-skills

AGENTS.md AGENTS.md file
kodekateam/superior-skills · AGENTS.md
git:20261106.9769969 · audit A · 47 stars
superior-accessibility SKILL.md skill
kodekateam/superior-skills · skills/superior-accessibility/SKILL.md · Review or implement interface accessibility for semantics, keyboard operation, focus, contrast, status communication…
git:20261015.f73f383 · audit A · 47 stars
superior-api-security SKILL.md skill
kodekateam/superior-skills · skills/superior-api-security/SKILL.md · Implement, harden, or review defensive security controls for REST APIs, including authentication and authorization…
git:20261015.f413813 · audit A · 47 stars
superior-architecture SKILL.md skill
kodekateam/superior-skills · skills/superior-architecture/SKILL.md · Design, implement, or assess project structure, module ownership, dependency boundaries, and safe file or folder…
git:20261029.325740f · audit A · 47 stars
superior-code-review SKILL.md skill
kodekateam/superior-skills · skills/superior-code-review/SKILL.md · Review a code change, diff, commit, branch, or pull request for actionable defects, regressions, security risks…
git:20261025.89211a9 · audit A · 47 stars
superior-comments SKILL.md skill
kodekateam/superior-skills · skills/superior-comments/SKILL.md · Add, revise, or remove source-code comments while preserving executable behavior. Use for comment-only cleanup…
git:20261015.e3d1e5f · audit A · 47 stars
superior-copywriting SKILL.md skill
kodekateam/superior-skills · skills/superior-copywriting/SKILL.md · Write or revise user-facing product and marketing copy with a specific voice, verifiable claims, natural rhythm, and…
git:20261106.5be7d1d · audit A · 47 stars
superior-database SKILL.md skill
kodekateam/superior-skills · skills/superior-database/SKILL.md · Design, implement, review, or repair database schemas, queries, indexes, transactions, migrations, and backfills with…
git:20261015.f413813 · audit A · 47 stars
superior-debugging SKILL.md skill
kodekateam/superior-skills · skills/superior-debugging/SKILL.md · Diagnose and repair reproducible, intermittent, environment-specific, or production-observed software failures by…
git:20261015.f413813 · audit A · 47 stars
superior-delivery SKILL.md skill
kodekateam/superior-skills · skills/superior-delivery/SKILL.md · Design, implement, review, or repair CI/CD pipelines, release artifacts, environment promotion, deployment rollout…
git:20261015.665ae43 · audit A · 47 stars
superior-docs SKILL.md skill
kodekateam/superior-skills · skills/superior-docs/SKILL.md · Create, reconstruct, synchronize, or automatically record durable repository documentation and curated implementation…
git:20261026.bc705e7 · audit A · 47 stars
superior-lean SKILL.md skill
kodekateam/superior-skills · skills/superior-lean/SKILL.md · Simplify coding implementations and reviews by reusing existing capabilities and removing unjustified abstractions…
git:20261029.325740f · audit A · 47 stars

Every file in kodekateam/superior-skills

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