onboarding-cro

onboarding-cro 技能總覽

onboarding-cro 是用來解決什麼問題

onboarding-cro 技能的重點，是幫你優化註冊後的 onboarding、activation，以及縮短 time-to-value。它最適合用在這種情況：使用者已經建立帳號，卻一直沒有走到第一個能真正證明產品價值的關鍵成果。

誰適合安裝 onboarding-cro

這個技能很適合正在處理 SaaS 或 product-led growth 流程的產品行銷、成長團隊、創辦人、PM 與 UX writer。尤其當你的主要問題不是 acquisition，而是使用者註冊後 activation 偏弱時，onboarding-cro 會特別有用。

它真正要完成的工作

如果你需要的不只是籠統的「改善 onboarding」建議，就該用 onboarding-cro。這個技能會把討論拉回幾個可執行的核心：明確定義 activation event、找出 friction、加快 first value、設計 onboarding checklist、優化 empty state，並提出可驗證的實驗方向。

onboarding-cro 和一般提示詞有什麼不同

和普通 prompt 相比，onboarding-cro skill 的運作框架更明確：

• 它會先從產品與 activation 情境開始
• 它聚焦在 aha moment，而不是泛泛的 UX 意見
• 它會把 onboarding 問題轉成可衡量的實驗
• 它會帶入 repo 裡明確整理出的模式，例如 checklist 設計、empty state 用法，以及縮短 time-to-value

最適合與不適合的使用情境

最適合：

• trial 使用者註冊了，但沒有完成 setup
• 新使用者沒有走到第一個成功里程碑
• 你需要能直接對應 activation metrics 的 onboarding 實驗

不適合：

• 你只是在優化註冊前的轉換
• 你主要需要的是 lifecycle email 策略
• 你的問題發生在首次使用體驗之後很久的 retention 階段

遇到這些情況，repo 本身也有指向其他相關技能，例如 signup-flow-cro 或 email-sequence。

如何使用 onboarding-cro 技能

onboarding-cro 的安裝方式與情境

請從父層 repository 安裝，因為 onboarding-cro 位於 coreyhaines31/marketingskills 裡的 skills/onboarding-cro：

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

如果你的環境使用的是其他 skill loader，重點在於 repo URL，以及正確的 skill slug：onboarding-cro。

先讀這幾個檔案

如果你想快速判斷 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 需要哪些輸入

onboarding-cro usage 的品質，高度取決於以下四種輸入：

1. 產品類型與目標受眾
2. 你的 activation 定義或 aha moment
3. 現有的 onboarding 步驟
4. 已知的 drop-off 節點或 baseline metrics

如果你省略這些資訊，模型還是能回答，但輸出通常會變得比較空泛，也較難落成可測試的方案。

先確認產品行銷脈絡

repo 明確要求 agent 先讀 .agents/product-marketing-context.md；如果是較舊的 setup，則是 .claude/product-marketing-context.md。如果你的 workspace 裡有其中一個檔案，請先提供，或確認 agent 在你提問前能存取它。

這很重要，因為 onboarding 建議一旦脫離產品定位、受眾與 value proposition，往往很容易失準。

把模糊需求改寫成高品質 prompt

弱的 prompt：
「幫我改善 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.”

這種寫法能讓技能有足夠的結構，產出真正可執行的行動方案，而不是流於寬泛的建議。

好的 onboarding-cro prompt 通常會包含什麼

能給多少就給多少，尤其包含以下資訊：

• activation event 定義
• 目前 onboarding flow 的步驟
• mobile 或 desktop 使用情境
• self-serve 或 sales-assisted onboarding
• 不同 user segment 的差異
• analytics baseline
• 螢幕截圖或直接貼上的 UI 文案
• 例如工程限制或法規要求等 constraints

當 onboarding-cro 能分清楚哪些是關鍵步驟、哪些只是加分設定時，效果會明顯更好。

實務上推薦的 onboarding-cro 工作流程

一個實用的 onboarding-cro guide，通常會長這樣：

1. 定義 activation event
2. 畫出從 signup 到 first value 的現有路徑
3. 找出可避免的 friction 與不必要步驟
4. 判斷該採 product-first、guided，還是 value-first onboarding
5. 設計一份精簡且完成動作明確的 checklist
6. 優化 empty states 與使用者卡住的關鍵時刻
7. 從 references/experiments.md 抽取實驗想法
8. 在變更上線前先綁定成功指標

這個順序對齊了 repo 的核心重點：縮短 time-to-value，以及每個 session 只聚焦一個目標。

如何把 checklist 模式用好：onboarding-cro 的關鍵技巧

evals 很明確地暗示 checklist 最好控制在大約 3 到 7 項。這不是單純的排版偏好，而是一個很有用的設計限制。項目太多，使用者會把 setup 視為額外工作；太少，則不容易累積推進感。

好的 checklist 項目應該：

• 可被觀察與驗證
• 直接連到產品價值
• 有順序地把使用者推向 aha moment
• 能在單一 session 內完成

不好的 checklist 項目，通常只是行政性任務，完成後也看不到明顯回報。

把 empty state 當成 onboarding 介面來設計

onboarding-cro for Conversion 很有價值的一點，就是它怎麼處理 empty state。當使用者看到空白 dashboard、空的 project list，或空 workspace 時，這個畫面不該只是空著，而是要主動推動「下一個最佳動作」：

• 解釋這個畫面的價值
• 只提供一個主要 CTA
• 降低決策負擔
• 適合時提供 templates、examples 或 dummy data

很多時候，這比重做整個 signup flow 更快帶來成效。

從參考檔提取實驗想法

references/experiments.md 很值得讀，因為它能把策略轉成實際可測的實驗候選。常見且實用的分類包括：

• 降低 friction
• 調整步驟順序
• 測試 value-first 路徑
• 使用預先填好的 templates
• 調整 required 與 optional steps
• 挽回中途停滯的使用者
• 改善效能、無障礙與 mobile onboarding 體驗

但請在完成診斷之後再用它，而不是一開始就套。否則你很容易得到一串看似很多、實際上和真正 bottleneck 無關的隨機實驗清單。

每次都該要求的 metrics

不要在沒有 measurement layer 的情況下使用 onboarding-cro。至少應該要求：

• activation rate
• time to activation
• step completion rate
• checklist completion rate
• 各步驟的 drop-off
• 不同 segment 或 acquisition source 的 cohort 差異

當每一項建議都能對應到可衡量的變化時，這個技能的價值會高很多。

onboarding-cro 技能 FAQ

onboarding-cro 只適用於 SaaS 嗎

不只。onboarding-cro skill 最直觀的應用場景確實是 SaaS，但凡是存在明確首次使用路徑的產品，它都可能派上用場，例如 marketplaces、fintech apps、協作工具、creator tools，或 AI 產品。關鍵前提是：你能清楚定義 activation event。

它比一般 CRO prompt 更好嗎

通常是，前提是你的問題在 activation，而不是一般性的 UX 評論。這個技能提供的是一個更有紀律的框架：定義 aha moment、縮短 time-to-value、讓每個 session 聚焦單一目標、改善 checklist 設計，並產出能對應 metrics 的實驗。

什麼情況下不該用 onboarding-cro

如果你的問題明顯發生在 signup 之前，就不要把 onboarding-cro install 當成第一步。若使用者根本沒有開始註冊，其他 conversion 類技能會更適合。它也不適合拿來處理長期 retention program，或純粹的 email nurture strategy。

onboarding-cro 對初學者友善嗎

友善，只要你能描述自己的產品、使用者與目前流程即可。你不需要很深的 CRO 專業背景；但對初學者來說，如果能提供螢幕截圖、funnel metrics，以及明確的 activation 定義，效果會比抽象提問好得多。

repository 裡有實作程式碼嗎

這裡沒有明顯的 automation 或 scripts。這更像是一個思考與工作流程型技能，主要由 SKILL.md、evals，以及 experiment reference 支撐。安裝它的目的是提升分析與建議品質，而不是取得可直接 plug-and-play 的程式碼。

怎麼判斷 onboarding-cro 有沒有發揮效果

可以把輸出拿去對照 evals/evals.json 裡那種接近 eval 的期待。好的回答通常應該：

• 先檢查產品行銷脈絡
• 清楚定義 activation
• 診斷 time-to-value friction
• 推薦合適的 onboarding 方法
• 提出精簡的 checklist
• 有意識地使用 empty states
• 提出實驗方案
• 納入 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

這樣 onboarding-cro 才能看出價值是在哪裡被延後，也比較能判斷哪些步驟應該延後、略過，或合併。

提供真實 friction，不要只給推測

強而有力的輸入會像這樣：

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

較弱的輸入則偏向主觀判斷：

• 「users seem confused」
• 「the flow feels long」

當你提供的是觀察到的行為，而不是感受，技能表現會更好。

直接要求一個 redesign 加三個 experiments

想提升 onboarding-cro usage 的品質，一個很好用的方法是直接規定輸出格式：

• 一條推薦的核心 onboarding 路徑
• 三個可拿來驗證的 experiments
• 各自的預期影響與 tradeoffs
• 對應的 metrics

這樣能讓回答維持可執行，而不會發散成一大串點子。

用 constraints 強迫它做優先排序

如果你有真實限制，請明說：

• 本季不能做大規模 backend 工作
• 只能做 mobile
• 不能移除 compliance steps
• design team 暫時無法支援
• 目前只能上 copy 與步驟排序變更

有約束條件的 prompt，通常能產出更銳利的建議，也能降低不切實際的提案。

常見失敗模式：優化的是 setup，不是 value

團隊很常叫這個技能去提高內部 setup 步驟的完成率，卻沒有真正提升使用者得到價值的機率。但 setup flow 變短，並不代表使用者就感受到核心價值。請明確告訴技能：要優化的是 first value，不是單純的表單或設定完成率。

常見失敗模式：一次想解決太多目標

原始內容很強調每個 session 只做一個目標。如果你的 onboarding 想一次教會使用者所有功能，請要求技能拆開來處理：

• activation 所需的必要動作
• 次要設定
• 後續教育內容

這通常能同時改善完成率與清晰度。

用具體素材提升輸出品質

如果手邊有資料，請附上：

• first-run 畫面的螢幕截圖
• modal 與 tooltip 的文案
• analytics 截圖
• 產品分析裡的 event names
• 近期 signup 使用者訪談摘錄

這些素材能讓 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 真正接近可落地執行的地方。

有選擇地使用 experiment reference

不要把 references/experiments.md 的完整清單直接倒進 roadmap。想讓技能更有用，應該要求它根據你的實際 bottleneck 來篩選實驗，例如：

• 降低 first project creation 前的 friction
• 提高 empty-state conversion
• 挽回 signup 第一天後就卡住的使用者

這種有篩選的用法，能形成更聚焦的測試計畫，也更有機會帶來可衡量的成長。