UX RULER

An open-source UX skill for AI agents (Claude Code, Codex). Helps you go from an idea or a repo to a concrete decision, metric, and next step — instead of jumping straight into features.

Philosophy: every product decision has 4 layers (Usefulness, Ergonomics, Attractiveness, Identity) and should be testable via user research, not just the founder’s intuition.

Description

Download or use

Claude Code (personal skill):

REPO="https://github.com/making-mike/uxruler.git"
TMP_DIR="$(mktemp -d)"
git clone --depth 1 "$REPO" "$TMP_DIR/uxruler-repo"
mkdir -p ~/.claude/skills
rm -rf ~/.claude/skills/uxruler
cp -R "$TMP_DIR/uxruler-repo/uxruler" ~/.claude/skills/
# restart Claude Code

Repo-local (committable):

cp -R "$TMP_DIR/uxruler-repo/uxruler" .claude/skills/
git add .claude/skills/uxruler

Codex: Use $skill-installer to install: https://github.com/making-mike/uxruler/tree/main/uxruler

Reasoning for

Use it when:

  • You’re starting a new product / repo and want to avoid jumping into features without user research
  • You have an existing product and want an audit: does every feature have a user, problem, value
  • You want product memory in the repo — so the next human or agent knows what was decided, what is an assumption, what needs a test

Output: files in the repo — from a minimal stack (AGENTS.md, PRODUCT.md, ROADMAP.md, README.md) to a full maturity layer (decision-log, north-star-metric, experiments, tracking-plan).

Process — 7 stages

  1. Mission — what change we’re creating, for whom, why now
  2. Audience/Market — segments, channels, alternatives
  3. User — a concrete person, jobs/pains/gains, context
  4. Need — which need justifies building/prototype/research
  5. Infrastructure — what has to work technically for value to be reliable
  6. Product — flow, prototype, design system
  7. Value — rollout, onboarding, metrics, feedback

Alternatives considered

  • Agent Skills — UX RULER is an Agent Skill, so this is not an alternative, it’s the class
  • Karpathy Skills — different set, doesn’t cover product methodology
  • Superpowers — SDLC methodology, but for development not product discovery
  • Traditional PRD templates (Notion, Confluence) — without an agent, without consistency checking

Resources


Template: tool