Skene
Product docs

Product documentation

Learn how to use Skene: workspaces, sources, milestones, widgets, and analytics.

Navigation
~6 min read

Milestones & lifecycles

After Skene analyzes your source, it proposes milestones grouped into lifecycles. This guide helps you turn those drafts into a clear onboarding journey.

Core concepts

Milestone

A specific step users should complete toward activation, retention, or expansion.

  • • Clear, action-oriented title
  • • Description of what success looks like
  • • Position within a lifecycle

Lifecycle

Groups milestones into phases like Onboarding, Setup, and Advanced.

  • • Reflects user experience over time
  • • Not internal feature boundaries
  • • Rename, reorder, or add as needed

Editing AI-generated milestones

  1. Open the source detail page after analysis completes
  2. Review each lifecycle in order, starting from Onboarding
  3. Click on titles/descriptions to edit—use language users recognize
  4. Remove milestones that are too edge-case for core onboarding
  5. Add missing milestones where users currently get stuck

Rule of thumb: Aim for 5–8 milestones in your primary onboarding lifecycle. More than that and users often stop before reaching the end.

Ordering milestones

Order matters. Milestones should follow the natural sequence a successful user takes—not your internal technical architecture.

1

Setup steps

Create account, connect data, basic config

2

First value

First moment of real product success

3

Advanced

Optional features in later lifecycles

Use drag and drop to adjust order of milestones and lifecycles

Linking to docs and help content

Milestones work best when they link to supporting docs, videos, or examples. Where you have strong content, link it directly from the milestone description so users can self-serve.

Over time, connect Skene to your content systems and PLG playbooks so onboarding and strategy stay in sync.

Iterating based on analytics

After your widget is live, Analytics will show how users move through milestones and where they drop off. Use this feedback loop to:

  • Rewrite or split milestones with low completion rates
  • Move confusing steps later in the flow or to a different lifecycle
  • Add new milestones when users skip important behaviors

See Analytics & insights for reading funnels and time-to-value metrics.

What's next?

Once your milestones and lifecycles feel right, turn them into a widget and embed it in your product.

Continue with Widgets & embedding →