onboarding-state-machine

Manage onboarding steps as explicit states with per-tenant progress.

Updated Mar 29, 2026
One-click install
npx skills add https://github.com/marquesfelip/agents-and-skills --skill onboarding-state-machine
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: onboarding-state-machine
Source: https://github.com/marquesfelip/agents-and-skills/tree/main/skills/onboarding-state-machine
Command: npx skills add https://github.com/marquesfelip/agents-and-skills --skill onboarding-state-machine

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Onboarding state machine tracks how far a user or tenant has progressed through required and optional steps, enabling reliable progress persistence, gating, and analytics.

Core Features & Use Cases

  • Define explicit onboarding steps per tenant/user with a central registry and a persisted progress store.
  • Gate features behind required steps, resume progress across sessions, and emit analytics on completion or step events.

Quick Start

Define your onboarding steps, persist per-tenant progress, and gate features until all required steps are complete.

Frequently Asked Questions about onboarding-state-machine

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I track onboarding progress across multiple tenants?

Track onboarding progress by defining steps as explicit states within a central registry and persisting progress in a per-tenant store. This enables reliable progress tracking across tenants and users, allowing you to gate features and resume sessions seamlessly.

Can I gate features behind required onboarding steps?

Yes, you can gate features by applying middleware that checks if all required onboarding steps are complete. The state machine restricts access to features until a tenant finishes the necessary steps, ensuring users only see unlocked capabilities.

How does an onboarding state machine handle resuming progress across sessions?

An onboarding state machine handles resuming progress by persisting per-tenant step completion in a database. When a user returns, the service interfaces query the progress store to resume the onboarding flow exactly where they left off.

How do I trigger analytics when a user completes an onboarding step?

Trigger analytics by emitting domain events when the state machine transitions between onboarding steps. The system fires these events upon step completion or state changes, allowing your analytics platform to capture user progress data.

What's the best way to define required and optional onboarding steps?

The best way to define onboarding steps is using a central step registry that distinguishes between required and optional states. This registry interfaces with the persisted progress store to manage per-tenant completion and gate features appropriately.

Do I need a database schema to manage tenant onboarding steps?

Yes, you need a database schema for tenants and steps to manage onboarding progress. The state machine requires this persisted store to track explicit states, trigger domain events, and support the gating middleware effectively.