ux-spec SKILL.md skillA

ux-spec from bandersnatch0x/design-playbook is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add bandersnatch0x/design-playbook/ux-spec@git:20260924.e1cfa82

Pins git:20260924.e1cfa82 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
bandersnatch0x/design-playbook
Path
packages/design-playbook/skills/ux-spec/SKILL.md
Versions recorded
5
Latest version
git:20260924.e1cfa82, committed Sep 24, 2026
First version recorded
Aug 15, 2026
Size
12,434 bytes
Repository stars
3
License
a license file GitHub does not identify

Declaration-first UI spec (six-layer spec.md) shaped through an S0-S6 interactive session. Use when turning a short product/UI ask into six-layer spec.md, or when goal, edge-state, acceptance, or evidence requirements are missing before build.

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

Write a **six-layer `spec.md`**: the functional **declaration** for what must be true. Visual skin, tokens, and Badge-vs-Tag choices are out of scope.

Shaping runs as a session state machine (S0-S6) with append-only artifacts under `.scratch/<run>/shaping/`:

- `shaping-log.jsonl` — append-only event log (process authority; mirrors the decision-log philosophy)
- `queue.json` — derived state (pending questions / staged assumptions / open confirmations), always rebuildable from the log

Events (closed enum): `asked / answered / assumption_staged / confirm_presented / item_confirmed / item_rejected / item_revised / projected / suspended / resumed / superseded_by / archived`.

**Terminology:** In Chinese responses, use「成形(会话)」for "shaping (session)" — see `CONTEXT.md` glossary.

## Steps

### 0. Bind project contract — S0 intake assembly
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add bandersnatch0x/design-playbook/ux-spec@sha256:927443609471e133

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

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

Versions

The registry has recorded 5 versions of this file, between Aug 15, 2026 and Sep 24, 2026, about one every 10 days.

versioncommittedcommitsizeaudit
git:20260924.e1cfa82 latest2026-09-24 e1cfa82 12,434 BA view · diff
git:20260922.d3a16c72026-09-22 d3a16c7 12,328 BA view · diff
git:20260912.09a0c522026-09-12 09a0c52 11,443 BA view · diff
git:20260828.0fbfd2e2026-08-28 0fbfd2e 10,653 BA view · diff
git:20260815.4dec5162026-08-15 4dec516 9,817 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 (12434 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

bandersnatch0x/design-playbook · 3 stars · license a license file GitHub does not identify · pushed 2026-10-21 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_ehuxtqrl33ouwz3l
GET https://markdownregistry.com/api/v1/resolve?ref=bandersnatch0x/design-playbook/ux-spec
GET https://markdownregistry.com/api/v1/blob/927443609471e133d87651983fce4d0afbb878cd9c82b72407414145d5d0d5d9

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 bandersnatch0x/design-playbook

AGENTS.md AGENTS.md file
bandersnatch0x/design-playbook · AGENTS.md
git:20260924.2a8e95b · audit A · 3 stars
CLAUDE.md CLAUDE.md file
bandersnatch0x/design-playbook · CLAUDE.md
git:20260828.03af370 · audit B · 3 stars
AGENTS.md@packages/design-playbook/codex AGENTS.md file
bandersnatch0x/design-playbook · packages/design-playbook/codex/AGENTS.md
git:20260930.099be27 · audit A · 3 stars
DESIGN.md@packages/design-playbook/examples/dogfood/project DESIGN.md file
bandersnatch0x/design-playbook · packages/design-playbook/examples/dogfood/project/DESIGN.md
git:20260815.35c5b00 · audit A · 3 stars
DESIGN.md@packages/design-playbook/examples/export-upgrade/project DESIGN.md file
bandersnatch0x/design-playbook · packages/design-playbook/examples/export-upgrade/project/DESIGN.md
git:20260815.35c5b00 · audit A · 3 stars
component-distill SKILL.md skill
bandersnatch0x/design-playbook · packages/design-playbook/skills/component-distill/SKILL.md · Cross-run component backflow. Derive the reusable components that have recurred across iterated pages and render a…
git:20260924.0bfb615 · audit A · 3 stars
craft-guard SKILL.md skill
bandersnatch0x/design-playbook · packages/design-playbook/skills/craft-guard/SKILL.md · UI craft and feedback quality. Use when polishing product UI (motion, loading/error feedback) or when a page reads as…
git:20260924.e1cfa82 · audit A · 3 stars
design-baseline SKILL.md skill
bandersnatch0x/design-playbook · packages/design-playbook/skills/design-baseline/SKILL.md · Discover, validate, or draft a project-owned DESIGN.md before adding or revising UI in an existing frontend. Use during…
git:20260924.189797b · audit A · 3 stars
design-playbook SKILL.md skill
bandersnatch0x/design-playbook · packages/design-playbook/skills/design-playbook/SKILL.md · Route and orchestrate outcome-first product UI work. Use for answer, review, diagnosis, plan, prototype, build, or fix…
git:20260925.984b133 · audit A · 3 stars
native-craft SKILL.md skill
bandersnatch0x/design-playbook · packages/design-playbook/skills/native-craft/SKILL.md · Native-feel declaration for desktop apps. Use when a cross-platform desktop app (macOS+Windows) must feel…
git:20260721.d3f01a7 · audit A · 3 stars
reference-intake SKILL.md skill
bandersnatch0x/design-playbook · packages/design-playbook/skills/reference-intake/SKILL.md · Reference intake contract from screenshot, URL, design file, or product analogy. Use when the user supplies…
git:20260828.582f33b · audit A · 3 stars
ui-evaluator SKILL.md skill
bandersnatch0x/design-playbook · packages/design-playbook/skills/ui-evaluator/SKILL.md · Run evidence-backed UI acceptance. Use after generating a page, or when the user wants a design review or…
git:20260924.e1cfa82 · audit A · 3 stars

Every file in bandersnatch0x/design-playbook

Other files named ux-spec

ux-spec SKILL.md skill
gonimar/claude-web-studio · skills/ux-spec/SKILL.md · Authors a UX specification for a flow or screen — user goal, flow, screens, all states, UI copy, accessibility…
git:20260927.f32d805 · audit A · 5 stars

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