Communitygithub.com

YepAPI/skills

多步驟精靈、進度指示器、啟用核取清單與歡迎引導流程。

skills 是什麼?

這項技能提供了一套完整的用戶引導與啟用工作流程,特別適合 SaaS 產品、開發者工具或任何需要引導新用戶的應用程式。其核心包含一個基於陣列的多步驟精靈,透過狀態管理追蹤 `currentStep`,並搭配進度條顯示已完成的步驟數,確保用戶隨時知道剩餘步驟。此外,它還支援啟用核取清單,定義關鍵行動(如「建立第一個專案」、「邀請團隊成員」、「連接整合工具」),並在儀表板上顯示完成百分比,幫助產品團隊量化用戶的啟用進度。該設計也包含了進度持久化機制,將完成的步驟儲存至資料庫,讓用戶能隨時離開並從中斷處繼續,避免因重新整理頁面而流失進度。為了提升用戶體驗,它允許跳過非關鍵步驟,並在最終步驟提供慶祝動畫(如五彩紙屑)作為完成獎勵,最後將用戶導向主要產品視圖。此技能支援 Claude Code 等平台,透過定義清晰的 TypeScript 介面與狀態管理模式,開發者可以快速整合並客製化引導流程。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/YepAPI/skills/tree/HEAD/skills/onboarding-flow

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

入職引導流程

規則

  • 多步驟精靈:將步驟定義為陣列 — 在狀態中追蹤 currentStep,顯示帶有步驟計數的進度條
  • 進度指示器:在頂部顯示步驟編號或進度條 — 顯示已完成、目前和即將進行的步驟 — 永遠不要隱藏剩餘步驟數
  • 進度持久化:將完成的步驟儲存至資料庫 — 用戶可以離開並從中斷處繼續
  • 啟用核取清單:定義關鍵行動(例如「建立第一個專案」、「邀請團隊成員」、「連接整合工具」)— 在儀表板上顯示完成百分比
  • 歡迎郵件序列:註冊後立即發送,然後在第 1、3、7 天發送 — 內容對應他們尚未完成的核取清單項目
  • 跳過選項:允許用戶跳過非關鍵步驟 — 標記為「已跳過」,而非「已完成」 — 提供稍後完成的選項
  • 資料收集:只詢問必要的內容 — 將個人資訊、工作區設定和偏好設定分為不同的步驟
  • 完成慶祝:在最後一步顯示五彩紙屑或成功動畫 — 將用戶重新導向主要產品視圖

精靈模式

const ONBOARDING_STEPS = [
  { id: "profile", title: "你的個人檔案", required: true },
  { id: "workspace", title: "建立工作區", required: true },
  { id: "invite", title: "邀請團隊", required: false },
  { id: "integrations", title: "連接工具", required: false },
] as const;

// 在資料庫中追蹤
interface OnboardingState {
  userId: string;
  currentStep: number;
  completedSteps: string[];
  skippedSteps: string[];
  completedAt: Date | null;
}

啟用核取清單模式

在儀表板上顯示,直到所有項目完成或用戶關閉:

const ACTIVATION_ITEMS = [
  { key: "first_project", label: "建立你的第一個專案", check: (user) => user.projectCount > 0 },
  { key: "invite_member", label: "邀請一位團隊成員", check: (user) => user.teamSize > 1 },
  { key: "first_deploy", label: "部署到生產環境", check: (user) => user.deployCount > 0 },
];

應避免的事項

  • 過早詢問過多資訊 — 精靈中最多 3-5 個步驟,其餘推遲
  • 沒有進度持久化 — 用戶會因為頁面重新整理而失去進度
  • 強制完成所有步驟 — 允許用戶跳過可選步驟
  • 沒有啟用追蹤 — 你必須衡量入職引導的完成率

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

YepAPI/skills

WCAG 2.1 AA — semantic HTML, keyboard navigation, screen readers.

YepAPI/skills

Experiment setup, variant splitting, statistical significance, and feature flag integration.

YepAPI/skills

CRUD generators, data tables, user management, role-based access, and bulk operations.

YepAPI/skills

Monitor what ChatGPT and Gemini say about your brand using YepAPI.

YepAPI/skills

Queue workers with BullMQ/Inngest/Trigger.dev, job retries, dead letter queues, concurrency.

YepAPI/skills

Commander.js, interactive prompts with Clack, spinners, colors, config files, exit codes, and npm publishing.

YepAPI/skills

cmdk integration, Cmd+K trigger, fuzzy search, grouped actions, keyboard navigation, and dynamic action registration.

YepAPI/skills

Content planning with trend and sentiment data from YepAPI.

YepAPI/skills

Content calendar, keyword-driven planning, and content briefs.

YepAPI/skills

Theme switching with CSS variables, system preference detection, next-themes, and persistence.

YepAPI/skills

Threaded comments, @mentions, reactions, moderation queue, optimistic UI, and cursor pagination.

YepAPI/skills

Competitive analysis between domains using YepAPI.

YepAPI/skills

Layout grids, KPI cards, data tables with sorting/filtering, sidebar navigation, and responsive breakpoints.

YepAPI/skills

Data encryption — TLS everywhere, AES-256-GCM for PII, bcrypt passwords, encrypted backups.

YepAPI/skills

Chart patterns with Recharts/Nivo/D3, responsive containers, color scales, and accessibility.

YepAPI/skills

Drizzle schema definition, push vs migrate, type-safe queries, relations, transactions, and prepared statements.

YepAPI/skills

Upload handling, resize/compress, CDN delivery, blur placeholders, and next/image patterns.

YepAPI/skills

Local business and Google Maps research using YepAPI.

YepAPI/skills

Cursor-based pagination, IntersectionObserver, virtualized lists with @tanstack/react-virtual, and scroll position restoration.

YepAPI/skills

Chat UI components, streaming responses with AI SDK, context window management, and RAG patterns.

相關技能