ux-researcher/SKILL.md
UX research toolkit: data-driven persona generation, customer journey mapping, usability testing frameworks, research synthesis. Use when planning user research, creating personas, mapping journeys, or validating designs.
npx skillsauth add lidge-jun/cli-jaw-skills ux-researcherInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
[{
"user_id": "user_1",
"age": 32,
"usage_frequency": "daily",
"features_used": ["dashboard", "reports"],
"primary_device": "desktop",
"tech_proficiency": 7,
"pain_points": ["slow loading", "confusing UI"]
}]
| Archetype | Signals | Design Focus | |-----------|---------|--------------| | Power User | Daily use, 10+ features | Efficiency, shortcuts, customization | | Casual User | Weekly use, 3–5 features | Simplicity, guidance, progressive disclosure | | Business User | Work context, team use | Collaboration, reporting, admin | | Mobile-First | Mobile primary device | Touch-friendly, offline, speed |
| Element | Define | |---------|--------| | Persona | Which user type | | Goal | What they're trying to achieve | | Start | Trigger that begins journey | | End | Success criteria | | Timeframe | Hours / days / weeks |
Awareness → Evaluation → Onboarding → Adoption → Advocacy
Stage: [Name]
├── Actions: What does user do?
├── Touchpoints: Where do they interact?
├── Emotions: How do they feel? (1–5)
├── Pain Points: What frustrates them?
└── Opportunities: Where can we improve?
Score = Frequency × Severity × Solvability
| Vague | Testable | |-------|----------| | "Is it easy to use?" | "Can users complete checkout in <3 min?" | | "Do users like it?" | "Will users choose Design A or B?" | | "Does it make sense?" | "Can users find settings without hints?" |
| Method | Participants | Duration | Best For | |--------|--------------|----------|----------| | Moderated remote | 5–8 | 45–60 min | Deep insights | | Unmoderated remote | 10–20 | 15–20 min | Quick validation | | Guerrilla | 3–5 | 5–10 min | Rapid feedback |
| Metric | Target | |--------|--------| | Completion rate | >80% | | Time on task | <2× expected | | Error rate | <15% | | Satisfaction | >4/5 |
SCENARIO: "Imagine you're planning a trip to Paris..."
GOAL: "Book a hotel for 3 nights in your budget."
SUCCESS: "You see the confirmation page."
Progression: Warm-up → Core → Secondary → Edge case → Free exploration
Tag each data point:
[GOAL] — What they want to achieve[PAIN] — What frustrates them[BEHAVIOR] — What they actually do[CONTEXT] — When/where they use product[QUOTE] — Direct user wordsGroup users by behavioral patterns → identify segments → size each segment:
| Cluster | Users | % | Persona Priority | |---------|-------|---|-----------------| | Power Users | 18 | 36% | Primary | | Business Users | 15 | 30% | Primary | | Casual Users | 12 | 24% | Secondary |
For each theme:
| Factor | Score 1–5 | |--------|-----------| | Frequency | How often does this occur? | | Severity | How much does it hurt? | | Breadth | How many users affected? | | Solvability | Can we fix this? |
| Question Type | Method | Sample Size | |---------------|--------|-------------| | "What do users do?" | Analytics, observation | 100+ events | | "Why do they do it?" | Interviews | 8–15 users | | "How well can they?" | Usability test | 5–8 users | | "What do they prefer?" | Survey, A/B test | 50+ users | | "What do they feel?" | Diary study | 10–15 users |
| Level | Definition | Action | |-------|------------|--------| | 4 — Critical | Prevents task completion | Fix immediately | | 3 — Major | Significant difficulty | Fix before release | | 2 — Minor | Causes hesitation | Fix when possible | | 1 — Cosmetic | Noticed, not problematic | Low priority |
tools
Use only on the Codex CLI for native image generation or image editing without an API key. Save final PNG files under ~/.cli-jaw/uploads, report web-ready absolute-path markdown, and send to Telegram or Discord only when explicitly requested.
tools
Ranked repository structure map via `cli-jaw map`. Use for codebase overview, structure map, symbol overview, unfamiliar codebase exploration, architecture orientation. Triggers: repo map, structure map, codebase overview, 와꾸, project structure, unfamiliar code.
tools
cli-jaw Design workspace: create, preview, run, and export design pages from the right sidebar. Covers panel UX, direct-write workflow, artifact lifecycle, wireframe generation, design system, and Open Design adapter.
development
MUST USE for infrastructure and delivery work — container builds, deploy pipelines, Kubernetes, Infrastructure as Code, SRE foundations, edge/serverless, ML infrastructure. Triggers: Dockerfile, K8s manifests, CI/CD pipeline, Terraform/IaC, release/deploy, devops/infra/deploy or release_cd task_tags.