ux-psychology SKILL.md skillA

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

Install it, pinned
mdr add tartinerlabs/skills/ux-psychology@git:20261019.70eba48

Pins git:20261019.70eba48 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
tartinerlabs/skills
Path
plugins/design/skills/ux-psychology/SKILL.md
Versions recorded
6
Latest version
git:20261019.70eba48, committed Oct 19, 2026
First version recorded
Oct 17, 2026
Size
8,053 bytes
Repository stars
8
License
MIT

Use when designing, building, or reviewing a screen, flow, or page — landing and marketing pages, onboarding, sign-up, navigation, forms, settings, dashboards, tables, pricing, checkout, empty states, error messages, permission prompts — or when a UI feels confusing, cluttered, or slow. Applies UX psychology (Hick, Fitts, cognitive load, Gestalt, defaults, reciprocity) to web/SaaS, Apple platforms (iOS, iPadOS, macOS, visionOS, watchOS, tvOS), Android, and React Native/Expo apps. Not for…

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

You apply how people perceive, decide, and remember to the UI being built or reviewed. Every rule cites the research it rests on and says when it does not apply — these are strong predictions about people, not laws, so a rule that does not fit the product is set aside, not forced.

## 1. Pick the Mode

Decide from the request; do not ask.

- **Build mode** — the task creates or changes UI. Apply the rules as constraints while writing the code. Stay quiet about them: mention a principle only when it changed a decision, in one line (e.g. "kept one primary button — von Restorff"). No report.
- **Audit mode** — the user asks to review, audit, or critique the UX, or asks why users drop off, get confused, or don't convert. Produce the report in Step 4.

## 2. Detect the Platform

Read the manifest as prose and load **only** the matching guides:

| Platform | Detected by | Load |
|---|---|---|
| **Web / SaaS** (apps, landing and marketing pages) | `package.json` with a web framework (Next.js, Vite, Remix, Astro, Nuxt, SvelteKit, …), or HTML templates | `references/web.md` |
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add tartinerlabs/skills/ux-psychology@sha256:8d6ede708ac7bd62

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

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

Versions

The registry has recorded 6 versions of this file, between Oct 17, 2026 and Oct 19, 2026, more than one a day.

versioncommittedcommitsizeaudit
git:20261019.70eba48 latest2026-10-19 70eba48 8,053 BA view · diff
git:20261017.3fc15912026-10-17 3fc1591 7,760 BA view · diff
git:20261017.7fb27e72026-10-17 7fb27e7 7,672 BA view · diff
git:20261017.8463ad62026-10-17 8463ad6 7,543 BA view · diff
git:20261017.dbbc3a02026-10-17 dbbc3a0 7,509 BA view · diff
git:20261017.aa088c52026-10-17 aa088c5 7,472 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 (8053 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

tartinerlabs/skills · 8 stars · license MIT · pushed 2026-10-19 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_x4zeezazlss4wscp
GET https://markdownregistry.com/api/v1/resolve?ref=tartinerlabs/skills/ux-psychology
GET https://markdownregistry.com/api/v1/blob/8d6ede708ac7bd6200a8e68356c5405fbf494f6273eba3f8588aad17cb92096b

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 tartinerlabs/skills

AGENTS.md AGENTS.md file
tartinerlabs/skills · AGENTS.md
git:20261017.3fc1591 · audit A · 8 stars
accessibility SKILL.md skill
tartinerlabs/skills · plugins/design/skills/accessibility/SKILL.md · Use when building or reviewing UI for accessibility — screen readers (VoiceOver, TalkBack), keyboard and focus, colour…
git:20261017.0f05021 · audit A · 8 stars
apple-featuring SKILL.md skill
tartinerlabs/skills · plugins/design/skills/apple-featuring/SKILL.md · Use when preparing an Apple platform app for App Store featuring or the Apple Design Awards — readiness reviews before…
git:20261017.94810f7 · audit A · 8 stars
i18n SKILL.md skill
tartinerlabs/skills · plugins/quality/skills/i18n/SKILL.md · Use when internationalising or localising an app, preparing it for translation, extracting hardcoded strings, adding…
git:20261018.ca0b241 · audit A · 8 stars
naming-format SKILL.md skill
tartinerlabs/skills · plugins/quality/skills/naming-format/SKILL.md · Use when reviewing file names, renaming files, fixing naming conventions, or auditing exports. Enforces consistent…
git:20261007.6a855c7 · audit A · 8 stars
project-structure SKILL.md skill
tartinerlabs/skills · plugins/quality/skills/project-structure/SKILL.md · Use when deciding where code should live, organising files, or auditing project structure. Checks colocation, grouping…
git:20261007.6a855c7 · audit A · 8 stars
refactor SKILL.md skill
tartinerlabs/skills · plugins/quality/skills/refactor/SKILL.md · Use when refactoring, cleaning up code, reducing complexity, fixing code smells, or improving code quality. Audits code…
git:20261007.6a855c7 · audit A · 8 stars
deps SKILL.md skill
tartinerlabs/skills · plugins/security/skills/deps/SKILL.md · Use when hardening a dependency supply chain, pinning versions, adding registry/security flags, or setting up Renovate…
git:20261017.0f1c3d3 · audit A · 8 stars
security SKILL.md skill
tartinerlabs/skills · plugins/security/skills/security/SKILL.md · Use when auditing security, checking for vulnerabilities, scanning for secrets, or reviewing dependencies. Dependency…
git:20261007.6a855c7 · audit A · 8 stars
setup SKILL.md skill
tartinerlabs/skills · plugins/tooling/skills/setup/SKILL.md · Use when setting up a project, adding linting, formatting, git hooks, or type checking. Detects the language and…
git:20261017.0f1c3d3 · audit A · 8 stars
testing SKILL.md skill
tartinerlabs/skills · plugins/tooling/skills/testing/SKILL.md · Use when writing tests, running tests, adding test coverage, or debugging test failures. Detects the language and its…
git:20261007.6a855c7 · audit A · 8 stars
update-project SKILL.md skill
tartinerlabs/skills · plugins/tooling/skills/update-project/SKILL.md · Use when updating docs, syncing CLAUDE.md, AGENTS.md, or README.md, fixing stale documentation, or refreshing project…
git:20261007.6a855c7 · audit A · 8 stars

Every file in tartinerlabs/skills

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