ranbot-ai/skills/developer-onboarding

Developer Onboarding

When to Use

Use this skill when you need get developers to "Hello World" fast with optimized quickstarts, tutorials, and sample apps. Trigger phrases: developer onboarding, time to first value, quickstart guide, hello world tutorial, developer activation, onboarding checklist, sample apps, getting started experience, reduce...

Get developers from signup to working code as fast as possible, then guide them to deeper engagement.

Overview

Developer onboarding is the critical window between "I signed up" and "I understand how to use this." You have about 10 minutes of developer attention. Every second of confusion, every error message without guidance, every "it should work but doesn't" moment costs you users.

Great onboarding feels like pair programming with someone who anticipated every question. Bad onboarding feels like being dropped in a foreign city without a map.

Before You Start

Review the /devmarketing-skills/skills/developer-audience-context skill to understand your target developers. A hobbyist building side projects needs different onboarding than an enterprise architect evaluating tools for production. Review /devmarketing-skills/skills/developer-signup-flow to ensure signup flows smoothly into onboarding.

Time-to-First-Value Optimization

Defining "First Value"

First value isn't "made an API call." First value is when the developer sees your tool doing something useful for them.

| Tool Type | First Value Moment | |-----------|-------------------| | API | Response returns meaningful data | | SDK | Library performs expected function | | Database | Query returns results | | Hosting | App is live and accessible | | Auth | User successfully logs in | | Payment | Test charge processes |

Measuring Time to First Value (TTFV)

Track timestamps at each stage:

signup_completed: 2024-01-15T10:00:00Z
dashboard_loaded: 2024-01-15T10:00:05Z
api_key_copied: 2024-01-15T10:01:30Z
first_api_call: 2024-01-15T10:04:45Z
first_successful_response: 2024-01-15T10:04:46Z  # TTFV = 4:46

Benchmarks by category:

• Simple APIs: <5 minutes
• SDKs requiring installation: <10 minutes
• Complex infrastructure: <30 minutes
• Self-hosted: <60 minutes

Removing TTFV Obstacles

Map every step and eliminate blockers:

Common TTFV killers:

1. Email verification before dashboard access
2. API keys hidden in account settings
3. Quickstart assumes dependencies already installed
4. First example requires paid features
5. Error messages without resolution guidance
6. Docs search finds outdated tutorials

TTFV audit process:

1. Create new account (fresh browser, no cookies)
2. Screen record your first 30 minutes
3. Note every moment of confusion or friction
4. Time each step
5. Repeat with 5 different developer personas

Quickstart Checklist Design

The Ideal Quickstart Structure

# Quickstart: [Specific Goal] in 5 Minutes

What you'll build: [Screenshot or description of end result]

Prerequisites:
- Node.js 18+ (check: node --version)
- npm or yarn

## Step 1: Install the SDK
[One command, copy button]

## Step 2: Initialize with your API key
[Code with placeholder, copy button]

## Step 3: Make your first request
[Complete working example, copy button]

## Step 4: See the result
[Expected output shown]

## Next steps
- [Link to common second task]
- [Link to full documentation]

Checklist Patterns That Work

Progress indicators (Stripe style):

Your integration progress:
[x] Create account
[x] Get API keys
[ ] Install SDK
[ ] Make first API call
[ ] Handle webhooks

Contextual next steps (Vercel style):

You've deployed your first site.

What's next?
[ ] Add a custom domain
[ ] Set up environment variables
[ ] Enable analytics

Common Quickstart Failures

Too much context upfront:

# Bad: The history of authentication
Before we begin, let's understand OAuth 2.0...
[500 words of background]

# Good: Jump to action
Install the SDK and make your first authenticated request.

Assuming environment:

# Bad
Run `npm install` to install dependencies.

# Good
npm install our-sdk
# Or with yarn: yarn add our-sdk
# Or with pnpm: pnpm add our-sdk

Hidden prerequisites:

# Bad (prerequisite discovered in Step 3)
Step 3: Connect to Redis
First, make sure Redis is running...

# Good (prerequisites listed upfront)
Prerequisites:
- Redis 6+ running locally (docker run -p 6379:6379 redis)

Interactive vs Static Tutorials

When to Use Interactive Tutorials

Interactive tutorials work for:

• Complex setup sequences
• Concepts that benefit from immediate feedback
• Onboarding flows where you control the environment
• Features requiring API keys or credentials

Interactive tutorial tools:

• Embedded code editors (CodeSandbox, StackBlitz)
• Terminal emulators (Instruqt, Killercoda)
• In-dashboard walkthroughs (Appcues, Pendo)
• Interactive notebooks (Jupyter, Observable)

Wh