Open Swim

Fetching Schedules

Use whichever method is available in your environment. You must actually attempt to fetch the data — do not assume it will fail.

Method 1: WebFetch (works everywhere, including Claude web interface)

The schedule JSON is embedded as static data in the page HTML, so WebFetch can read it directly. This is confirmed to work — do not skip this method.

Fetch each branch URL with this prompt (substitute the target date in MM/DD/YYYY format, or omit the date clause to get all events):

Find ALL schedule entries where the category is "Open Swim" in the embedded ygdScheduler._initialState JSON data. Only include events with date "MM/DD/YYYY". For each entry, return these fields: name, category, beginningAt, endingAt, date, weekdays, areaName, branchName, duration, canceled, isCancelled, description. Return as a JSON array. Include every matching entry — do not truncate or summarize.

Use these URLs:

• West Carrollton: https://www.daytonymca.org/west-carrollton-schedule
• Coffman: https://www.daytonymca.org/coffman-schedule

Fetch both branches in parallel when the user asks for all branches.

Important notes for WebFetch method:

• Always include the target date in the prompt to keep results focused — the full week's data may be too large for complete extraction.
• If the user asks about "today", calculate today's date and use it in the prompt.
• Results may occasionally be incomplete for very large datasets. If results look sparse, note this and provide the direct schedule links as backup.

Method 2: Python Script (Claude Code CLI only)

Run the bundled fetch script to retrieve live data. ${SKILL_DIR} resolves to the directory containing this SKILL.md file.

# Today's events across all branches (default)
python3 ${SKILL_DIR}/scripts/fetch_open_swim.py

# Tomorrow's events
python3 ${SKILL_DIR}/scripts/fetch_open_swim.py --date tomorrow

# Full schedule, all dates
python3 ${SKILL_DIR}/scripts/fetch_open_swim.py --date all

# Specific date
python3 ${SKILL_DIR}/scripts/fetch_open_swim.py --date 03/15/2026

# Single branch
python3 ${SKILL_DIR}/scripts/fetch_open_swim.py --branch west-carrollton
python3 ${SKILL_DIR}/scripts/fetch_open_swim.py --branch coffman

# Normalized JSON output for shared rendering
python3 ${SKILL_DIR}/scripts/fetch_open_swim.py --format json

Script Options

The script uses only Python standard library modules (no pip dependencies).

JSON Output Structure

When using --format json, the output follows the shared schedule response shape:

{
  "title": "Open Swim Today",
  "mode": "availability",
  "timezone": "America/New_York",
  "items": [
    {
      "source": "West Carrollton YMCA",
      "category": "open-swim",
      "title": "Open Swim",
      "status": "normal",
      "start": "2026-03-18T10:00:00-04:00",
      "end": "2026-03-18T15:45:00-04:00",
      "area": "Lap Pool",
      "timeLabel": "10:00 AM–3:45 PM"
    }
  ],
  "links": [
    {
      "label": "West Carrollton YMCA schedule",
      "url": "https://www.daytonymca.org/west-carrollton-schedule"
    }
  ],
  "metadata": {
    "sourceSummary": ["West Carrollton YMCA", "Coffman YMCA"],
    "distinctTypes": ["Adult Swim", "Open Swim", "Pool Closed"],
    "total": 11
  }
}

Each item may include fields like:

• source
• category
• title
• status
• start
• end
• area
• description
• note
• tags
• dateLabel
• timeLabel
• url

Understanding the Data

Key Filtering Rule

Filter on category === "Open Swim" (the Type filter). Do NOT filter by the event name field — the Class dropdown contains individual event names but is not the correct filter for identifying Open Swim events.

Event Types Within Open Swim

Events under the Open Swim category include varied name values:

• Open Swim — General open swim sessions
• Adult Swim — Pool reserved for ages 18+
• Open Swim - 3 Lanes / Open Swim - Deep End Only — Partial-pool sessions
• Water Walking / Water Volleyball — Specific activities
• Pool Closed — Closure periods (still categorized as Open Swim type)

Pool Areas

• West Carrollton: Therapy Pool, Lap Pool
• Coffman: Instructional / Warm Water Therapy Pool, Competition Pool

Data Quirks

• Some event names have trailing whitespace in raw data
• canceled and isCancelled are separate boolean fields; check both
• days is an array of full day names; weekdays is comma-separated abbreviations
• Dates are in MM/DD/YYYY format; times include AM/PM

Rendering Guidance

Default to the unified schedule spec's availability style.

Prefer structured data

• Prefer --format json when using the Python script so you can normalize and render the results yourself
• If the render_schedule tool is available, pass the normalized JSON response to it instead of hand-formatting long schedule output yourself
• For WebFetch, extract JSON and then render it into the shared display format
• Only present the raw Python table output if the user explicitly asks for the full raw schedule/table view

Status mapping

Normalize event names into these statuses before rendering:

• Open Swim → normal
• Adult Swim → limited
• Open Swim - 3 Lanes / Open Swim - Deep End Only → limited
• Water Walking / Water Volleyball → usually limited
• Pool Closed → blocked
• any event with canceled or isCancelled → cancelled

Default display behavior

• Show usable swim windows first
• Keep one primary line per item, e.g. - 10:00 AM–3:45 PM · Open Swim · Lap Pool
• Use a secondary line only when needed, e.g. - Adults 18+ only
• Do not let Pool Closed rows dominate the main list
• Collapse closure-heavy results into a short Facility notes section when possible
• If there are no usable sessions, explain that clearly and then show the relevant closures that explain why

Direct links

Always include direct schedule links as a fallback:

• West Carrollton: https://www.daytonymca.org/west-carrollton-schedule
• Coffman: https://www.daytonymca.org/coffman-schedule

Additional Resources

Reference Files

• references/data-structure.md — Complete field-by-field documentation of the ygdScheduler._initialState JSON schema and all known event types
• ../../../docs/schedule-display.md — Unified schedule display spec for Discord

Scripts

• scripts/fetch_open_swim.py — Standalone Python script to fetch, parse, and filter Open Swim events from both branch schedule pages