onboarding-milestones

Tracks new customer onboarding milestones in Postgres and HubSpot and drafts stall nudges for CSM review.

20.2k|3.4k|Updated Oct 5, 2024
One-click install
npx skills add https://github.com/kortix-ai/suna --skill onboarding-milestones
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: onboarding-milestones
Source: https://github.com/kortix-ai/suna/tree/main/packages/starter/templates/marketplace/runtime/skills/onboarding-milestones
Command: npx skills add https://github.com/kortix-ai/suna --skill onboarding-milestones

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

New customer accounts often stall during onboarding without anyone noticing until it is too late to recover them. This Skill runs a daily sweep that detects stalled or overdue accounts early, drafts a targeted nudge email for each one, and alerts the owning CSM — all before any customer-facing action is taken.

Core Features & Use Cases

  • Milestone classification: Reads activation milestones and product events from Postgres and classifies each account as on track, stalled at a specific milestone, or overdue against a five-step framework (workspace live, core setup, first activation, team expansion, full activation).
  • Deduplicated nudge drafting: Drafts a nudge email tied to the exact missed step, skipping accounts already nudged for the same stall via a HubSpot marker property.
  • CSM alerting with human approval gate: Posts a daily alert to the owning CSM with full context and holds every draft for human review — the agent never emails customers or changes account state.
  • Use Case: A SaaS team runs the sweep each morning; an account stuck at "core setup" on day 5 gets a draft nudge about connecting its first data source, and its CSM gets a Slack alert with the account's milestone history.

Quick Start

Run the onboarding sweep to check every account inside the onboarding window and draft nudges for any that are stalled or overdue.

Frequently Asked Questions about onboarding-milestones

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

FAQPage Schema
How do I detect stalled customer onboarding accounts automatically?

Query your CRM for accounts inside the onboarding window, pull their activation milestones and product events from Postgres, and classify each against expected milestone timing. Accounts past a milestone's expected day without completing it are flagged as stalled, and those past the full window are overdue.

How to track onboarding milestones with HubSpot and Postgres?

Use HubSpot as the account registry (customer-since date, owner, nudge-marker properties) and Postgres as the source of truth for milestone completion and product events. The sweep joins both per account and writes only the last-nudged-milestone marker back to HubSpot.

Does this skill send onboarding nudge emails to customers directly?

No. Every nudge is created as a draft held in a review channel for the owning CSM to edit and send. The agent never emails customers and never changes plans, seats, deal stages, or account owners.

How are duplicate nudges for the same onboarding stall prevented?

A HubSpot property records the last milestone that was nudged. Before drafting, the sweep compares the current stall against that marker and skips accounts already nudged for the same milestone, drafting again only when the stalled milestone changes.

What happens if one account's milestone check fails during the sweep?

Each account is handled as an independent unit. A failure checking one account's milestones is logged and skipped without blocking the rest of the sweep, since state lives on the HubSpot record rather than a local ledger.