onboarding-cro

onboarding-cro 技能概览

onboarding-cro 适合解决什么问题

onboarding-cro 技能用于优化注册后的 onboarding、激活率和 time-to-value。它最适合这样的场景：用户已经完成注册，但始终没能走到第一个能够证明产品价值的关键结果。

谁适合安装 onboarding-cro

这个技能适合 SaaS 或产品驱动增长流程中的产品营销团队、增长团队、创始人、PM 和 UX writer。尤其当你的核心问题不是获客，而是注册后的激活偏弱时，onboarding-cro 会很有帮助。

它真正要完成的任务是什么

如果你需要的不只是泛泛而谈的“优化 onboarding”建议，就该用 onboarding-cro。这个技能会把讨论拉回到更具体、可执行的层面：明确 activation event、诊断流失摩擦、缩短首次价值达成时间、设计 onboarding checklist、优化 empty state，并产出可测试的实验方案。

这个技能的不同之处

和普通 prompt 相比，onboarding-cro skill 的工作框架更聚焦：

• 它从产品定位和激活语境出发
• 它关注 aha moment，而不是宽泛的 UX 评论
• 它会把 onboarding 转化为可衡量的实验
• 它吸收了仓库中明确沉淀的方法，比如 checklist 设计、empty state 用法，以及 time-to-value 缩短策略

最适合与不适合的使用场景

最适合：

• 试用用户注册了，但没有完成初始设置
• 新用户没有走到第一个成功里程碑
• 你需要把 onboarding 实验和 activation 指标绑定起来

不适合：

• 你现在只想优化注册前的转化
• 你主要需要的是 lifecycle email 策略
• 你的问题发生在首轮体验很久之后，更偏长期留存

对于这类场景，仓库本身也指向了相关技能，比如 signup-flow-cro 或 email-sequence。

如何使用 onboarding-cro 技能

onboarding-cro 的安装方式

请从父仓库安装，因为 onboarding-cro 位于 coreyhaines31/marketingskills 的 skills/onboarding-cro 路径下：

npx skills add https://github.com/coreyhaines31/marketingskills --skill onboarding-cro

如果你的环境使用的是其他 skill loader，关键是仓库 URL 和准确的 skill slug：onboarding-cro。

先看这几个文件

如果你想快速判断值不值得装，优先查看：

• skills/onboarding-cro/SKILL.md
• skills/onboarding-cro/evals/evals.json
• skills/onboarding-cro/references/experiments.md

为什么按这个顺序看：

• SKILL.md 说明它的工作方法
• evals/evals.json 能看出什么样的输出才算好
• references/experiments.md 则在完成诊断后，提供一组很实用的实验思路

这个技能需要哪些输入

onboarding-cro usage 的输出质量，很大程度取决于这四类输入：

1. 产品类型和目标用户
2. 你的 activation 定义或 aha moment
3. 当前 onboarding 流程步骤
4. 已知的流失节点或基线指标

如果这些信息缺失，模型依然会回答，但结果通常会更泛、更难落地，也更难进入测试。

先确认产品营销语境

仓库明确要求 agent 先读取 .agents/product-marketing-context.md，在旧版环境中则是 .claude/product-marketing-context.md。如果你的工作区有这类文件，最好一并提供，或者确保 agent 在给建议前可以访问它。

这一步很重要，因为脱离产品定位、目标用户和价值主张的 onboarding 建议，往往会失效。

把模糊需求改写成高质量 prompt

弱 prompt：
“Help me improve onboarding.”

强 prompt：
“We run a B2B project management tool for agencies. Our activation event is ‘create first project and invite one teammate.’ Only 30% of trial users create a project in week one. Current flow after signup: email verify, workspace setup, template choice, project creation, invite step. Biggest drop-off is after workspace setup. Use onboarding-cro to diagnose friction, redesign the first-run path, suggest a 3-7 item checklist, improve empty states, and propose experiments with metrics.”

这样的 prompt 能给技能足够的结构，让它输出一份行动方案，而不是空泛建议。

高质量的 onboarding-cro prompt 通常应包含什么

能提供多少就提供多少：

• activation event 定义
• 当前 onboarding 流程步骤
• mobile 或 desktop 场景
• self-serve 还是 sales-assisted onboarding
• 不同用户分群的差异
• analytics 基线数据
• 截图或复制出来的 UI 文案
• 工程限制、法律要求等约束条件

当技能能够区分“必须完成的关键步骤”和“可以后置的配置项”时，表现会明显更好。

实际使用中的推荐 workflow

一个实用的 onboarding-cro guide 通常是这样推进的：

1. 定义 activation event
2. 梳理从 signup 到 first value 的当前路径
3. 找出可避免的摩擦和不必要步骤
4. 判断更适合 product-first、guided 还是 value-first onboarding
5. 设计一个简短、动作明确的 checklist
6. 优化 empty state 和用户卡住时的界面
7. 从 references/experiments.md 提取实验思路
8. 在上线前先绑定成功指标

这个顺序和仓库的核心强调一致：缩短 time-to-value，并且每次 session 只围绕一个目标推进。

如何把 checklist 模式用好

从 evals 可以明显看出，checklist 最好控制在 3 到 7 项左右。这不是单纯的排版偏好，而是一个很有价值的约束。太长，用户会觉得是在“做配置工作”；太短，又可能不足以形成推进感。

好的 checklist 项通常具备这些特征：

• 可观察、可判断是否完成
• 和产品价值直接相关
• 顺着 aha moment 的路径排布
• 能在一次 session 内完成

差的 checklist 项，则常常只是管理性任务，做完也看不到明显回报。

把 empty state 当作 onboarding 触点

onboarding-cro for Conversion 最有价值的一部分之一，就是它对 empty state 的处理方式。如果用户进入的是空白 dashboard、空项目列表或空 workspace，那么这个页面就不该只是“空着”，而应该主动推动下一步最佳动作：

• 解释这个页面的价值
• 只突出一个主要 CTA
• 降低决策负担
• 在合适时提供模板、示例或 dummy data

很多时候，这比彻底重做整个 signup 流程更快见效。

从参考文件中提取实验思路

references/experiments.md 值得认真看，因为它会把策略转成可测试的实验候选。比较实用的类别包括：

• 减少摩擦
• 调整步骤顺序
• 测试 value-first 路径
• 使用预填充模板
• 调整必填步骤与可选步骤
• 挽回卡住的用户
• 性能、可访问性与移动端 onboarding 优化

但要在完成诊断之后再用它，而不是一上来就翻实验列表。否则很容易得到一堆和真实瓶颈无关的随机实验。

每次都要要求它给出指标

不要在没有 measurement layer 的情况下使用 onboarding-cro。至少要让它围绕这些指标来输出：

• activation rate
• time to activation
• 各步骤完成率
• checklist 完成率
• 按步骤拆解的 drop-off
• 不同 segment 或 acquisition source 的 cohort 差异

当每条建议都能对应到一个可衡量变化时，这个技能的价值会高很多。

onboarding-cro 技能 FAQ

onboarding-cro 只适用于 SaaS 产品吗

不是。onboarding-cro skill 最典型的使用场景确实是 SaaS，但它同样适用于任何存在明确首次使用路径的产品：marketplace、fintech app、协作工具、creator tools，或者 AI 产品。关键前提是，你能定义清楚 activation event。

它比普通的 CRO prompt 更好吗

通常是的，前提是你的问题核心在 activation，而不是泛泛的 UX 评价。这个技能提供了一个更有纪律性的框架：先定义 aha moment，缩短 time-to-value，让每个 session 只聚焦一个目标，优化 checklist 设计，并产出和指标绑定的实验。

什么情况下不该用 onboarding-cro

如果你的问题明显发生在 signup 之前，就不要把 onboarding-cro install 当作第一步。如果用户连注册都没开始，应该优先使用其他转化类技能。它也不适合长期留存项目，或纯粹的 email nurture 策略。

onboarding-cro 对新手友好吗

友好，前提是你能说清楚自己的产品、用户和当前流程。你不需要很深的 CRO 专业背景，但对新手来说，带上截图、漏斗指标，以及明确的 activation 定义，效果会远比只提抽象问题更好。

仓库里包含可直接实现的代码吗

没有。这里没有明显的自动化脚本或实现代码；它本质上是一个思考与 workflow 类技能，主要由 SKILL.md、evals 和实验参考文件支撑。安装它的目的，是提升分析质量和建议质量，而不是获取 plug-and-play 代码。

怎么判断这个技能是否发挥了作用

可以把输出和 evals/evals.json 里类似评测标准的要求对照。一个高质量回答通常应该做到：

• 检查产品营销语境
• 清楚定义 activation
• 诊断 time-to-value 上的摩擦
• 推荐合适的 onboarding 方式
• 给出一个精简的 checklist
• 有意识地利用 empty state
• 提出实验方案
• 带上 measurement 设计

如何提升 onboarding-cro 技能的使用效果

给 onboarding-cro 一个精确的 activation 目标

最有效的提升方式，就是明确说明：什么用户动作意味着“这个用户已经获得了价值”。例如：

• “imports first CSV and sees a live dashboard”
• “creates first project and invites one teammate”
• “uploads first design and receives one comment”

如果没有这个定义，技能就无法正确判断哪些步骤优先级更高。

用编号列出当前流程

不要只说“我们的 onboarding 很卡”。请按顺序列出来：

1. signup
2. email verification
3. workspace naming
4. template selection
5. data import
6. dashboard view

这样技能才能识别：价值到底被延后在了哪里，哪些步骤可以推迟、跳过或合并。

提供真实摩擦，而不是主观猜测

高质量输入通常像这样：

• “60% drop after email verification”
• “mobile users abandon template selection”
• “trial users skip integrations and never return”

低质量输入则更像主观判断：

• “users seem confused”
• “the flow feels long”

你提供的是观察到的行为，而不是感受，技能表现就会更好。

要求它给出一个主方案加三个实验

提升 onboarding-cro usage 质量的一个好办法，是在需求里直接约束输出结构：

• 一个推荐的核心 onboarding 路径
• 三个围绕它验证的实验
• 每个方案的预期影响和 tradeoff
• 每个方案对应的指标

这样能让回答更可执行，不会越说越散。

用约束条件逼出优先级

如果你有现实限制，一定要说清楚，比如：

• 本季度不能做大的 backend 改动
• 仅限 mobile
• 不能移除合规步骤
• design 团队当前不可用
• 只能改文案和步骤顺序

带约束的 prompt 往往能得到更锋利的建议，也能减少不切实际的方案。

常见失败模式：优化的是设置完成率，不是价值达成

团队经常会让技能去优化内部设置步骤的完成率，却没有真正优化用户感知价值。缩短 setup 流程本身并不够；如果用户仍然没体验到核心收益，问题并没有解决。要明确告诉技能：优化目标是 first value，而不是单纯把表单填完。

常见失败模式：一次 session 里塞太多目标

原始材料反复强调，每次 session 只聚焦一个目标。如果你的 onboarding 试图在第一轮体验里把所有功能都教完，就应该让技能帮你拆分：

• activation 所必需的动作
• 次级配置项
• 适合后续再教育的内容

这通常会同时提升完成率和清晰度。

用素材提升输出质量

如果有条件，尽量附上这些材料：

• 首次使用界面的截图
• modal 和 tooltip 的文案
• analytics 截图
• 产品分析里的事件名
• 最近新注册用户的访谈片段

这些素材能让 onboarding-cro 针对真实界面和真实节点做判断，而不是凭空假设。

在第一轮回答后继续迭代

第一轮输出之后，可以继续追问，例如：

• “Rewrite the checklist for enterprise admins”
• “Now optimize for mobile users”
• “Keep email verification but move it later”
• “Rank these experiments by ease and likely impact”
• “Turn this into an A/B test plan”

很多时候，第二轮迭代才是 onboarding-cro guide 真正变得接近可实施方案的阶段。

有选择地使用实验参考

不要把 references/experiments.md 里的完整列表一股脑塞进 roadmap。想提升技能的实用性，应该让它按你的真实瓶颈做筛选，例如：

• reducing friction before first project creation
• improving empty-state conversion
• recovering users who stalled after signup day one

有选择地使用，才能形成更聚焦的测试计划，也更有机会拿到可衡量的提升。