holistic-ux — Claude Code skill: what it does, how to install
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.
no license 122 installs ★ 20 updated 2026-10-23
npx skills add connorads/dotfiles --skill holistic-ux -a claude-codeWhat holistic-ux 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.
What it helps with
- 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 for the agent
- 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.
How to install holistic-ux
1Skills CLI (Vercel)
npx skills add connorads/dotfiles --skill holistic-ux -a claude-code2Manually: put the files in place
~/.claude/skills/holistic-ux/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/holistic-ux/
1Skills CLI (Vercel)
npx skills add connorads/dotfiles --skill holistic-ux -a codex2Manually: put the files in place
.agents/skills/holistic-ux/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add connorads/dotfiles --skill holistic-ux -a cursor2Manually: put the files in place
.cursor/skills/holistic-ux/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install connorads/dotfiles skills/holistic-ux2Manually: put the files in place
.github/skills/holistic-ux/SKILL.md1Skills CLI (Vercel)
npx skills add connorads/dotfiles --skill holistic-ux -a gemini-cli2Platform CLI
gemini skills install https://github.com/connorads/dotfiles --path skills/holistic-uxManually: put the files in place
.devin/skills/holistic-ux/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add connorads/dotfiles --skill holistic-ux -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about holistic-ux
How do I install holistic-ux in Claude Code?
Run npx skills add connorads/dotfiles --skill holistic-ux -a claude-code, then check ~/.claude/skills/holistic-ux/SKILL.md.
What does holistic-ux do?
It uses research and behavior data to shape UX decisions before a solution is selected. Depending on the decision, it can produce a journey map, service blueprint, user flow, heuristic review, or low-fidelity wireframe.
What does a task need before holistic-ux can work?
The task must contain an unresolved experience question. That question gives the analysis a decision to support.