Communitygithub.com

YepAPI/スキル

マルチステップウィザード、進捗インジケーター、アクティベーションチェックリスト、ウェルカムシーケンス。

スキル とは?

このスキルは、ソフトウェア製品におけるユーザーオンボーディング体験を設計・実装するための包括的なガイドラインとパターンを提供します。マルチステップウィザードの定義、進捗状況のデータベースへの永続化、アクティベーションチェックリストによる主要なアクションの完了追跡、およびタイミングを調整したウェルカムメールシーケンスの送信方法をカバーしています。ユーザーが非クリティカルな手順をスキップできるようにし、収集するデータを最小限に抑えることで、摩擦の少ないオンボーディングを促進します。主にWebアプリケーションやSaaSプラットフォームを対象としており、TypeScriptによる実装パターンとデータベーススキーマの例が含まれています。このスキルは、ユーザーが途中で離脱しても後から再開できるようにし、最終ステップでは完了をお祝いするアニメーションを表示することで、製品への定着率を向上させます。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/YepAPI/skills/tree/HEAD/skills/onboarding-flow

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

オンボーディングフロー

ルール

  • マルチステップウィザード:ステップを配列として定義 — 状態で 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.

関連スキル