Maps out how users actually move through your app, not just what features do. Separates critical paths (signup to first value, checkout) from common flows and error recovery. Each journey documents user goals, step-by-step actions with friction points, and recovery scenarios for when things break. The structure pushes you to think about emotional states, real-world conditions like slow networks, and how users get back on track after errors. Works alongside E2E tests but focuses on the experience layer that specs miss. Good for preventing the "all tests pass but users are confused" problem.

skills.sh installs
406
GitHub stars
685
last updated
Jun 3, 2026

Install

$ npx -y skills add alinaqi/claude-bootstrap --skill user-journeys --agent claude-code

Installs into .claude/skills of the current project.

Files

User Journeys Skill

For defining and testing real user experiences - not just specs, but actual flows humans take through your application.


Philosophy

Specs test features. Journeys test experiences.

A feature can pass all specs but still deliver a terrible experience. User journeys capture:

  • How users actually navigate (not how we think they should)
  • Emotional states at each step (frustrated, confused, delighted)
  • Recovery from mistakes (users will make them)
  • Real-world conditions (slow networks, interruptions, distractions)

Journey Documentation Structure

Sponsors

Details

Repository
github.com/alinaqi/claude-bootstrap
First seen
Jun 3, 2026

More from alinaqi/claude-bootstrap

All 54

Recommended

1juliusbrussee avatarcavemanjuliusbrussee/cavemanUltra-compressed communication mode. Cuts output tokens 65% (measured) by speaking like caveman while keeping full technical accuracy. Supports intensity levels618.3Kskills.sh installs
2mattpocock avatargrill-memattpocock/skillsA relentless interview to sharpen a plan or design.1.5Mskills.sh installs
3shadcn avatarimproveshadcn/improveSurvey any codebase as a senior advisor and produce prioritized, self-contained implementation plans for OTHER models/agents to execute. Strictly read-only on s40Kskills.sh installs
4obra avatarsystematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes326.7Kskills.sh installs
5forrestchang avatarkarpathy-guidelinesforrestchang/andrej-karpathy-skillsBehavioral guidelines to reduce common LLM coding mistakes through explicit assumptions, simplicity, and verifiable success criteria.17.9Kskills.sh installs
6vercel-labs avatarfind-skillsvercel-labs/skillsHelps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express int4.3Mskills.sh installs