phrazzld

log-onboarding-issues

2
1
# Install this skill:
npx skills add phrazzld/claude-config --skill "log-onboarding-issues"

Install specific skill from multi-skill repository

# Description

|

# SKILL.md


name: log-onboarding-issues
description: |
Run /check-onboarding, then create GitHub issues for all findings.
Issues are created with priority labels and structured format.
Use /fix-onboarding instead if you want to fix issues immediately.


/log-onboarding-issues

Run onboarding audit and create GitHub issues for all findings.

What This Does

  1. Invoke /check-onboarding to audit new user experience
  2. Parse findings by priority (P0-P3)
  3. Check existing issues to avoid duplicates
  4. Create GitHub issues for each finding

This is an issue-creator. It creates work items, not fixes. Use /fix-onboarding to fix issues.

Process

1. Run Primitive

Invoke /check-onboarding skill to get structured findings.

2. Check Existing Issues

gh issue list --state open --label "domain/onboarding" --limit 50

3. Create Issues

For each finding:

gh issue create \
  --title "[P0] No onboarding flow - users dropped into empty app" \
  --body "$(cat <<'EOF'
## Problem
After signup, users land on an empty dashboard with no guidance. They don't know what to do first.

## Impact
- High drop-off after signup
- Users never experience core value
- Support tickets asking "how do I start?"
- Lost users who never return

## Suggested Fix
Run `/fix-onboarding` or implement:

1. **First-run detection:**
```typescript
const isNewUser = !user.hasCompletedOnboarding;
if (isNewUser) redirect('/onboarding');
  1. Onboarding wizard:
  2. Welcome screen
  3. First action prompt
  4. Success celebration

  5. Empty state with CTA:
    "Create your first X to get started"


Created by /log-onboarding-issues
EOF
)" \
--label "priority/p0,domain/onboarding,type/enhancement"

### 4. Issue Format

**Title:** `[P{0-3}] Onboarding issue`

**Labels:**
- `priority/p0` | `priority/p1` | `priority/p2` | `priority/p3`
- `domain/onboarding`
- `type/enhancement` | `type/bug`

**Body:**
```markdown
## Problem
What's broken in new user experience

## Impact
Effect on activation and retention

## Suggested Fix
Code snippet, pattern, or skill to run

---
Created by `/log-onboarding-issues`

Priority Mapping

Gap Priority
No onboarding flow P0
Broken auth callback P0
Paywall before value P0
No empty states P1
No first-action guidance P1
Complex initial forms P1
No loading states P1
No progressive disclosure P2
No tooltips/hints P2
No tour option P2
Retention hooks missing P3

Output

After running:

Onboarding Issues Created:
- P0: 1 (no onboarding flow)
- P1: 4 (empty states, guidance, forms)
- P2: 3 (progressive disclosure, hints)
- P3: 2 (notifications, email capture)

Total: 10 issues created
View: gh issue list --label domain/onboarding
  • /check-onboarding - The primitive (audit only)
  • /fix-onboarding - Fix onboarding issues
  • /cro - Conversion optimization
  • /groom - Full backlog grooming

# Supported AI Coding Agents

This skill is compatible with the SKILL.md standard and works with all major AI coding agents:

Learn more about the SKILL.md standard and how to use these skills with your preferred AI coding agent.