journey-planner

Allocates weekly session slots across active courses using cohort-based bottleneck weighting.

Updated Sep 20, 2026
One-click install
npx skills add https://github.com/alwayslistening86-pixel/claude_plugins --skill journey-planner-alwayslistening86-pixel
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: journey-planner
Source: https://github.com/alwayslistening86-pixel/claude_plugins/tree/main/generic-tutor-1.2.0/skills/journey-planner
Command: npx skills add https://github.com/alwayslistening86-pixel/claude_plugins --skill journey-planner-alwayslistening86-pixel

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Learners juggling multiple courses need a fair, honest way to distribute limited weekly study sessions without false calendar promises. This Skill computes how a learner's weekly session capacity is split across their active, unlocked courses — expressed as a sequence of session slots, never dates — and keeps the level-clearing ledger accurate as courses finish or get dropped. ## Core Features & Use Cases - Slot-Based Allocation: Groups eligible courses by cohort via cohort_status.py, weights each cohort's share toward its bottleneck course, and reports the plan as a session sequence rather than a schedule. - Drop Handling with Wake-Up: /drop <course_id> marks a course dropped, then runs roster_check.py to activate any dormant courses the drop unblocked, routing suspended-course drops to the auditor flow instead. - Level Ledger Updates: After a course completes, walks level_ledger upward to update highest_level_cleared, wakes newly eligible dormant courses, and transparently reports excluded dropped or suspended courses. - Use Case: A learner studying Chemistry and Contract Law at 4 sessions per week adds a new course; re-running /plan regroups cohorts, re-weights slots toward the bottleneck, and reports the next N sessions as a plain sequence. ## Quick Start Ask the AI to re-run the plan after adding a course, for example: "Re-plan my weekly sessions now that I've added Biology."

Frequently Asked Questions about journey-planner

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

FAQPage Schema
How do I allocate weekly study sessions across multiple courses?▼

Run the planning round, which groups eligible courses by cohort using cohort_status.py, estimates remaining slots per course, and weights each cohort's share toward its bottleneck. The result is reported as a sequence of session slots, never calendar dates.

How to drop a course without breaking other enrollments?▼

Use /drop <course_id>, which sets roster_state to dropped while preserving all other fields, then runs roster_check.py to activate any dormant courses the drop unblocked. Re-adding the course later resumes from where it left off.

Does the planner schedule sessions on specific calendar dates?▼

No, capacity is expressed only as sessions_per_week and a sequence of numbered session slots. It can give rough rate-based projections like weeks remaining, but never promises completion by a specific date.

Which courses are eligible to receive session slots?▼

A course draws slots only if its roster_state is active or test_pending_convergence and its grounding_status is not suspended_ungrounded. Dormant, dropped, suspended, and complete courses receive nothing, as determined by cohort_status.py.

What happens when a course is completed?▼

The skill asks cohort_status.py whether the course's cohort is all_complete, then walks the level ledger upward to update highest_level_cleared. Newly eligible dormant courses are woken to active, and excluded dropped or suspended courses are reported transparently.

Why is a dropped course excluded from blocking level completion?▼

Dropped and grounding-suspended courses are listed as excluded_members so an abandoned course cannot hold every higher-level course dormant forever. The exclusion is never silent; the learner is told which courses were left out and why.