Pack Availability Guard
Before telling the user to run a skill from another project-local pack, check .agents/project.json.enabled_packs. If the target pack is not enabled, recommend /pack install <pack> instead of the target skill.
Onboarding Map
Create the stage-level onboarding plan that expands research/journey-map.md.
Workflow
- Resolve app scope using the same
research/{app}/ convention as /journey-map.
- Read
research/.progress.yaml when present. Normalize active_path (singular legacy) to active_paths (plural list) when reading. Scope the onboarding map to the active product path by default.
- Require
research/journey-map.md or research/{app}/journey-map.md; if missing, recommend /journey-map.
- Load ICP, journey map, specs, customer feedback, metrics, and current product routes/components when present.
- Interview and recommend around: signup entry points, account creation, required setup, imports/integrations, team invites, empty states, first-session guidance, first 5 minutes/hour/day, aha threshold, drop-offs, recovery, and support touchpoints.
- Present the proposed onboarding model before writing.
- Write
research/onboarding-map.md and research/onboarding-map-interview.md after validation.
Output Shape
# Onboarding Map
> Based on: research/journey-map.md
> Date: YYYY-MM-DD
## Summary
## Personas And Entry Points
## Signup And Setup Flow
## Activation Path
## First Success
## Drop-Offs And Recovery
## Instrumentation Needs
## Product Gaps
## Next Steps
Alignment Page
When this skill produces durable deliverables (research, specs, plans, reports, prototypes, or any document output), build a full-depth HTML alignment page following ALIGNMENT-PAGE.md in this skill's directory. Output: alignment/onboarding-map-{topic}.html.
Constraints
- Stay stage-specific; do not rewrite the whole journey map.
- Make onboarding steps concrete enough to drive specs, UX variations, and instrumentation.
- End with
## Next Steps, preferring /conversion-map, /lifecycle-metrics, /ux-variations as context dictates.
1---2name: onboarding-map-73description: Plan signup, setup, activation, first success, onboarding drop-offs, and time-to-value for each lifecycle persona4---5
6## Pack Availability Guard
7
8Before telling the user to run a skill from another project-local pack, check `.agents/project.json.enabled_packs`. If the target pack is not enabled, recommend `/pack install <pack>` instead of the target skill.
9
10# Onboarding Map
11
12
13
14Create the stage-level onboarding plan that expands `research/journey-map.md`.
15
16## Workflow
17
181. Resolve app scope using the same `research/{app}/` convention as `/journey-map`.
192. Read `research/.progress.yaml` when present. Normalize `active_path` (singular legacy) to `active_paths` (plural list) when reading. Scope the onboarding map to the active product path by default.
203. Require `research/journey-map.md` or `research/{app}/journey-map.md`; if missing, recommend `/journey-map`.
214. Load ICP, journey map, specs, customer feedback, metrics, and current product routes/components when present.
225. Interview and recommend around: signup entry points, account creation, required setup, imports/integrations, team invites, empty states, first-session guidance, first 5 minutes/hour/day, aha threshold, drop-offs, recovery, and support touchpoints.
236. Present the proposed onboarding model before writing.
247. Write `research/onboarding-map.md` and `research/onboarding-map-interview.md` after validation.
25
26## Output Shape
27
28```markdown
29# Onboarding Map
30
31> Based on: research/journey-map.md
32> Date: YYYY-MM-DD
33
34## Summary
35## Personas And Entry Points
36## Signup And Setup Flow
37## Activation Path
38## First Success
39## Drop-Offs And Recovery
40## Instrumentation Needs
41## Product Gaps
42## Next Steps
43```
44
45## Alignment Page
46
47When this skill produces durable deliverables (research, specs, plans, reports, prototypes, or any document output), build a full-depth HTML alignment page following `ALIGNMENT-PAGE.md` in this skill's directory. Output: `alignment/onboarding-map-{topic}.html`.
48
49## Constraints
50
51- Stay stage-specific; do not rewrite the whole journey map.
52- Make onboarding steps concrete enough to drive specs, UX variations, and instrumentation.
53- End with `## Next Steps`, preferring `/conversion-map`, `/lifecycle-metrics`, `/ux-variations` as context dictates.
GeorgeQLe