When you sign up to Skene, the app automatically creates a personal workspace. A workspace is where you manage repositories, onboarding content, widgets, analytics, and your team.

1. Go to the Skene dashboard and sign up with your email
2. Click the magic link in your inbox to complete login
3. You'll land in your first workspace dashboard

Skene reads your codebase to propose onboarding milestones. Connect via sources—GitHub repositories linked to a site in your workspace.

1. In your workspace, navigate to repositories/sources
2. Click Connect repository
3. Paste your GitHub repository URL
4. For private repos: use the GitHub App or a fine-grained personal access token with read-only Contents access
5. Confirm and start analysis

Once analysis finishes, Skene suggests onboarding milestones grouped into lifecycles (Onboarding, Setup, Advanced). These are the steps a customer should complete to achieve success.

1. Open your source detail page
2. Review the suggested milestones and lifecycles
3. Edit titles and descriptions inline to match your product language
4. Drag and drop to reorder, or delete irrelevant ones
5. Add any missing critical milestones

When you're happy with milestones, build and publish an embeddable widget that shows this journey inside your product.

1. On the source detail page, click Build widget
2. Review the preview
3. Adjust milestones if needed, then rebuild
4. Click Publish to make it live

After publishing, Skene provides a JavaScript snippet to embed in your app.

1. Go to workspace settings → create/copy an API key
2. Add your app's domain to Allowed origins
3. Copy the embed snippet from the widget preview
4. Paste before </body> in your HTML

<script
  src="https://your-skene-domain.com/skene-milestones-widget.js"
  data-api-key="YOUR_API_KEY"
  data-source-id="YOUR_SOURCE_ID"
  data-position="bottom-right"
></script>