From studio-insight
Create a user journey map that traces a persona's experience step by step — actions, touchpoints, emotions, pain points, and opportunities. Use when you need to understand user workflows, identify friction points, design service improvements, or when someone asks "what does the user experience look like". Produces a structured journey document.
How this skill is triggered — by the user, by Claude, or both
Slash command
/studio-insight:journey-mapThis skill is limited to the following tools:
The summary Claude sees in its skill listing — used to decide when to auto-load this skill
Produce a professional user journey map that traces a specific persona through a real workflow — from trigger to outcome. Captures what the user does, how they feel, where they struggle, and where plugin opportunities exist.
Produce a professional user journey map that traces a specific persona through a real workflow — from trigger to outcome. Captures what the user does, how they feel, where they struggle, and where plugin opportunities exist.
This skill uses dynamic expert loading. On every run:
product-manager.md (leads journey analysis)studio/agents/*.md — load all custom experts the team has created${CLAUDE_SKILL_DIR}/../../agents/*.md — load shipped experts (skip any already loaded from project)## Your Domain section and title against the user's input topic. Include 1-3 most relevant domain experts._domain-expert-template.md — it's for creating new experts, not for consultation.The primary role produces the initial artifact. Domain experts review and correct it in the Expert Review step.
Accept one of:
$ARGUMENTS (e.g., "李妈妈的日常营养管理流程")studio/changes/{name}/personas/ and event-storm.mdIf a persona card exists at studio/changes/{name}/personas/{persona}.md, read it for context.
Clarify with the user:
Break the journey into 4-7 phases. Each phase represents a distinct mindset or context shift:
[触发] → [信息收集] → [决策] → [执行] → [验证] → [反思]
Name each phase with the user's language, not technical terms.
For each stage, fill in the journey row:
┌──────────┬──────────┬──────────┬──────────┬──────────┬──────────┐
│ Stage │ 准备早餐 │ 记录饮食 │ 查看报告 │ 获取建议 │ 调整计划 │
├──────────┼──────────┼──────────┼──────────┼──────────┼──────────┤
│ Actions │ 翻食谱 │ 打开App │ 看图表 │ 问营养师 │ 修改菜单 │
│ │ 查冰箱 │ 输入食物 │ 对比标准 │ 搜小红书 │ │
├──────────┼──────────┼──────────┼──────────┼──────────┼──────────┤
│ Touch- │ 食谱书 │ Excel/ │ 无工具 │ 微信群 │ 手写笔记 │
│ points │ 小红书 │ 微信备忘 │ │ 小红书 │ │
├──────────┼──────────┼──────────┼──────────┼──────────┼──────────┤
│ Thoughts │ 今天吃啥 │ 好麻烦 │ 看不懂 │ 等太久了 │ 希望简单 │
│ │ 有变化吗 │ 又忘了 │ 怎么调整 │ 不够针对 │ 点 │
├──────────┼──────────┼──────────┼──────────┼──────────┼──────────┤
│ Emotion │ 😐 纠结 │ 😩 烦躁 │ 😕 困惑 │ 😤 焦虑 │ 😌 还行 │
├──────────┼──────────┼──────────┼──────────┼──────────┼──────────┤
│ Pain │ 缺乏膳食 │ 记录成本 │ 数据不直 │ 专业建议 │ │
│ points │ 计划 │ 太高 │ 观 │ 获取难 │ │
└──────────┴──────────┴──────────┴──────────┴──────────┴──────────┘
Draw the emotional arc across stages:
高 · ·
· ·····
· ··· ·····
中 ······· ······
· ····· ······
· ·······
低 ·
├────────┼────────┼────────┼────────┼────────┤
准备早餐 记录饮食 查看报告 获取建议 调整计划
For each pain point found in the journey:
| # | Stage | Pain Point | Severity | Opportunity |
|---|---|---|---|---|
| 1 | 准备早餐 | 每天纠结吃什么 | 高 | 自动膳食计划推荐 |
| 2 | 记录饮食 | 记录太麻烦 | 高 | 语音/拍照快速记录 |
| 3 | 查看报告 | 看不懂营养数据 | 中 | 可视化 + 简单语言解读 |
| 4 | 获取建议 | 等回复太久 | 高 | AI 即时营养建议 |
Mark which opportunities could become plugin skills.
If domain experts were discovered in Expert Discovery, use the Agent tool to have each relevant expert review the journey map.
Give each expert subagent:
Incorporate corrections. Common improvements from domain experts:
If no relevant domain experts were found, skip this step.
Present the complete journey map to the user:
If working within a studio workspace:
studio/changes/{domain-or-plugin}/journeys/{persona-slug}-{scenario-slug}.md
If standalone, write to the current directory or let the user choose.
The file contains:
npx claudepluginhub ameng2001/astra-studio-plugins --plugin studio-insightCreates user journey maps with personas, phases, touchpoints, emotions, pain points, and opportunities for UX analysis and improvement.
Use this skill when the user asks to "create a journey map", "user journey map", "map the user experience", "map the customer journey", "end-to-end user flow", "what does the user experience look like", "map the onboarding journey", or wants to visualize the full sequence of steps a user goes through to accomplish a goal — including touchpoints, emotions, and friction points.
Create an end-to-end user journey map with stages, touchpoints, emotions, pain points, and opportunity areas. Use when mapping the full user experience for a product, feature, or service.