# holistic-ux

The holistic-ux skill turns research and behavior signals into UX decisions. Use it to investigate drop-off, confusion, trust, or recovery before choosing a solution.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 122 installs · ★ 20 repo stars
- Author: connorads
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/connorads/dotfiles/tree/HEAD/skills/holistic-ux/SKILL.md
- Updated: 2026-10-23
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/holistic-ux

## What it does

holistic-ux examines a user-facing experience before implementation begins. It can turn research notes and behavior data into a journey map, service blueprint, user flow, heuristic review, or low-fidelity wireframe. The selected artefact should support the next decision rather than add detail for its own sake.

The skill keeps measured evidence, observed behavior, reported views, inferences, and assumptions distinct. It also keeps competing explanations open and looks for an observation that can separate them. The task needs an unresolved question about the experience.

This skill stays away from feature selection, accessibility code, performance work, visual polish, and implementation of an agreed flow. It is available for Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and OpenCode.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add connorads/dotfiles --skill holistic-ux -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/holistic-ux/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/holistic-ux/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add connorads/dotfiles --skill holistic-ux -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/holistic-ux/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add connorads/dotfiles --skill holistic-ux -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/holistic-ux/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install connorads/dotfiles skills/holistic-ux
```

2. **Manually: put the files in place**
- File: `.github/skills/holistic-ux/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add connorads/dotfiles --skill holistic-ux -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/connorads/dotfiles --path skills/holistic-ux
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/holistic-ux/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add connorads/dotfiles --skill holistic-ux -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/connorads/dotfiles/tree/HEAD/skills/holistic-ux/SKILL.md

## When to use it
- locate where users abandon a task
- turn UX research into a decision-ready artefact
- separate evidence from interpretation and assumptions
- map user actions, recovery points, and exits
- sketch interaction structure before visual design

## Example prompts
- Investigate why people abandon account recovery and choose the smallest UX artefact for the next decision.
- Synthesize these interview notes and behavior signals, labeling evidence, observations, and open explanations.
- Map the checkout task, then identify observations that could distinguish the competing causes of confusion.

## Similar
- [service-blueprint](https://affpapa.org/en/nevibecode/skills/service-blueprint.md) — skill · 2200 installs
- [journey-map](https://affpapa.org/en/nevibecode/skills/journey-map.md) — skill · 2600 installs
- [ui-ux-designer](https://affpapa.org/en/nevibecode/skills/rmyndharis-ui-ux-designer.md) — skill · 176 installs
- [journey-mapping](https://affpapa.org/en/nevibecode/skills/journey-mapping.md) — skill · 1 install
- [ux-artifacts](https://affpapa.org/en/nevibecode/skills/ux-artifacts.md) — skill · ★ 1627 repo stars
- [ui-ux](https://affpapa.org/en/nevibecode/skills/ui-ux.md) — skill · 1400 installs

From the same set: [connorads/dotfiles](https://affpapa.org/en/nevibecode/by/connorads/dotfiles.md) — 2 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
