neo-user-journey — Claude Code skill: what it does, how to install
neo-user-journey maps end-to-end user journeys with emotional tracking and tests live flows using Playwright. Useful for auditing interactive web apps against UX heuristics.
MIT 217 installs ★ 35 updated 2026-10-21
npx skills add podo/design-agent-skills --skill neo-user-journey -a claude-codeWhat neo-user-journey does
The skill structures user journeys step by step while logging emotional states. It bundles a library of UX patterns, synthetic persona profiles, Nielsen heuristics scoring, and guardrails to prevent generic AI feedback.
It drives browser checks across four distinct modes: happy path journeys, cognitive walkthroughs, synthetic user simulations, and accessibility audits. These checks run against live domains or localhost.
Without @playwright/test and @axe-core/playwright installed in your project, the automated test suite will fail. The skill is built strictly for interactive workflows, so it will not help with static layouts or pure visual reviews.
What it helps with
- map interactive user journeys with emotional state tracking
- run automated accessibility audits using Playwright
- evaluate user flows against Nielsen heuristics
- simulate varied user archetypes across interactive steps
Example prompts for the agent
- Run a UX journey audit on the checkout flow at
localhost:3000 - Map the user journey and run an accessibility check on
/onboarding - Execute a Playwright UX cognitive walkthrough for the signup funnel
How to install neo-user-journey
1Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill neo-user-journey -a claude-code2Manually: put the files in place
~/.claude/skills/neo-user-journey/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/neo-user-journey/
1Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill neo-user-journey -a codex2Manually: put the files in place
.agents/skills/neo-user-journey/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill neo-user-journey -a cursor2Manually: put the files in place
.cursor/skills/neo-user-journey/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install podo/design-agent-skills skills/neo-user-journey2Manually: put the files in place
.github/skills/neo-user-journey/SKILL.md1Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill neo-user-journey -a gemini-cli2Platform CLI
gemini skills install https://github.com/podo/design-agent-skills --path skills/neo-user-journeyManually: put the files in place
.devin/skills/neo-user-journey/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill neo-user-journey -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 neo-user-journey
How to install neo-user-journey in Claude Code?
Run npx skills add podo/design-agent-skills --skill neo-user-journey -a claude-code in your terminal.
What does neo-user-journey do?
It maps interactive user flows with emotional tracking, scores interfaces with Nielsen heuristics, and executes Playwright test passes.
What dependencies does this skill require?
Automated checks require @playwright/test and @axe-core/playwright in your project dependencies.
Source text
SKILL.md · MIT
--- name: neo-user-journey description: | UX agency skill for user journey mapping with emotional tracking. Includes Playwright testing (happy path, cognitive walkthrough, accessibility, synthetic user), a library of proven UX patterns, synthetic personas, Nielsen heuristics scoring, and anti-generic-AI guardrails. triggers: - "user journey" - "UX journey" - "journey mapping" - "Playwright UX" - "neo-user-journey" das: type: skill category: interaction-polish upstream: "https://github.com/Cornjebus/neo-user-journey" upstream_path: "SKILL.md" version: latest install: true --- # neo-user-journey > Catalogue stub — full skill: [Cornjebus/neo-user-journey](https://github.com/Cornjebus/neo-user-journey) <!-- das:install:start — generated from stub.yaml by `npm run generate`; edit stub.yaml, not this block --> ## Decision tree 1. **Is the full skill already installed?** Upstream names this skill `ux-journey-architect`, so it installs next to this pointer (the pointer is not replaced). - Global: `f=~/.agents/skills/ux-journey-architect/SKILL.md; [ -f "$f" ] && ! grep -q "^das:" "$f" && echo "installed" || echo "pointer"` - Project: `f=.agents/skills/ux-journey-architect/SKILL.md; [ -f "$f" ] && ! grep -q "^das:" "$f" && echo "installed" || echo "pointer"` - `installed` → the skill is installed as `ux-journey-architect`, invoke it and proceed - `pointer` → go to step 2 2. **Detect scope, then install:** ```bash [ -e ~/.agents/skills/neo-user-journey ] && echo "global" || echo "project" ``` **Global:** ```bash npx skills add Cornjebus/neo-user-journey --skill ux-journey-architect -g -y ``` **Project:** ```bash npx skills add Cornjebus/neo-user-journey --skill ux-journey-architect -y ``` > **Claude Code:** send a command as a chat message starting with `!` to run it without leaving the conversation. **Heads-up** - **Requires:** Playwright in your project (@playwright/test and @axe-core/playwright) for the automated journey tests - **License:** no LICENSE file in the repo <!-- das:install:end --> ## Invoke after install - Skill name: `ux-journey-architect` - Trigger phrases: "user journey", "UX journey", "journey mapping", "Playwright UX", "neo-user-journey" ## What it does UX agency skill for end-to-end user journey mapping with emotional state tracking at every step. Runs four Playwright test modes — happy path, cognitive walkthrough, accessibility audit, and synthetic user simulation — against live or localhost URLs, so the test half needs Playwright in your project. Ships with a library of proven UX patterns, synthetic personas representing diverse user archetypes, a Nielsen heuristics scoring rubric, and explicit anti-generic-AI guardrails to prevent surface-level analysis. ## When NOT to use - Static design work with no user flow — use a design review skill instead - Pure visual audit with no interaction component — use `plan-design-review`
© podo · MIT · podo/design-agent-skills