mvhs-bell-schedule

name	mvhs-bell-schedule
description	Fetch and display the live MVHS (Mountain View High School) bell schedule for today or any given date, with the current period highlighted and a progress indicator. Use this skill whenever the user asks about the MVHS bell schedule, what period it is right now, whether there's school today, or what time any period starts or ends at MVHS. Trigger on phrases like "bell schedule", "what period is it", "MVHS schedule", "is there school today", "what time is lunch/brunch/tutorial", or any reference to MVHS class periods.
license	Noncommercial only. See LICENSE for full terms.
compatibility	Requires Python 3.6+ and internet access (fetches live data from Firebase).
allowed-tools	["bash"]
metadata	{"author":"alexey-max-fedorov","version":"1.1.0","source":"https://github.com/alexey-max-fedorov/mvhs-bellschedule-skill"}

MVHS Bell Schedule

Fetches live schedule data from the MVHS Firebase Realtime DB (public, no auth required).

Usage

Today's schedule:

python3 scripts/bell_schedule.py

Specific date:

python3 scripts/bell_schedule.py MMDDYYYY

The script handles everything: parallel Firebase fetches, special-day override detection, current period highlight with % progress, and a natural language summary line.

Output Example

📅 Monday, May 11, 2026 — Schedule A

  Period    Time                 Status
  ────────  ───────────────────  ──────────────
  Period 1  8:30 AM – 9:20 AM    ✓ done
  Period 2  9:27 AM – 10:17 AM   ✓ done
  Brunch    10:17 AM – 10:25 AM  ✓ done
→ Period 4  11:29 AM – 12:19 PM  ◀ NOW (91%)
  Lunch     12:19 PM – 12:54 PM  upcoming
  ...

You're in Period 4 right now — 5 min left.

Notes

• All times are America/Los_Angeles (PDT = UTC−7 Mar–Oct, PST = UTC−8 Nov–Feb)
• "none" schedule = no school today
• Special day keys in /days.json use format MMDDYYYY-MMDDYYYY
• Always fetches fresh — no caching