events

Events Skill

Find real upcoming events in your city across music, comedy, theater, food, and museums.

Usage

• /events - What's happening this week (all categories)
• /events music - Music/concerts only
• /events comedy - Comedy shows
• /events comedy this weekend - Comedy this weekend
• /events theater - Theater/broadway shows
• /events food - Food events and pop-ups
• /events museums - Current museum exhibitions
• /events all next week - Everything next week

Workflow

Step 0: Setup Check

Read data/preferences.json. If metadata.setup_complete is false, say:

"Run /date-plan setup first to set your city and preferences!"

Step 1: Parse Input

Read city from data/preferences.json.

Extract from arguments:

• Category: music, comedy, theater, food, museums, all (default: all)
• Timeframe: "tonight", "this weekend", "this week", "next week", "next 2 weeks" (default: this week)

Convert timeframe to concrete dates:

• "tonight" → today only
• "this weekend" → upcoming Saturday + Sunday
• "this week" → today through Sunday
• "next week" → next Monday through Sunday
• "next 2 weeks" → today + 14 days

Step 2: Fetch Events by Category

Music:

• WebSearch: "concerts {city} this week", "live music {city} this weekend"
• If Ticketmaster API available: python3 ${CLAUDE_PLUGIN_ROOT}/scripts/fetch_events.py --city "{city}" --category music --days {N} --format json

Theater:

• WebSearch: "theater shows {city} now playing", "broadway {city} current"
• If Ticketmaster API available: python3 ${CLAUDE_PLUGIN_ROOT}/scripts/fetch_events.py --city "{city}" --category theatre --days {N} --format json

Comedy:

• WebSearch: "comedy shows {city} this week", "stand up comedy {city} this weekend"
• Check data/venues.json for comedy venues, search each by name: "[venue name] upcoming shows"

Food Events:

• WebSearch: "food events {city} this week", "food festival {city} this month", "pop up restaurant {city}"

Museums:

• WebSearch: "museum exhibitions {city} now", "art exhibitions {city} current"
• Check data/venues.json for museums, search each by name: "[museum name] current exhibitions"

Step 3: Format and Display Results

Group by category, sorted by date within each:

## Music

1. **[Artist/Show Name]** — [Venue Name]
   [Day, Date] at [Time] | $XX-XX | [Tickets](url)

2. **[Artist/Show Name]** — [Venue Name]
   [Day, Date] at [Time] | $XX-XX | [Tickets](url)

## Comedy

1. **[Show/Comedian]** — [Venue]
   [Day, Date] at [Time] | $XX | [Info](url)

## Theater

1. **[Show Name]** — [Venue]
   Now through [end date] | $XX-XX | [Tickets](url)

## Food Events

1. **[Event Name]** — [Location]
   [Dates] | [Details]

## Museum Exhibitions

1. **[Exhibition Name]** — [Museum]
   Through [end date] | [Price/Free] | [Details]

If a category has no results:

No [category] events found for this period.

Step 4: Offer Next Steps

What next?

• Turn something into a date plan → /date-plan
• Add a venue to your watchlist → /venue-watch add [name]
• Search for a specific artist → just ask!

Special Handling

Artist Search

If user asks about a specific artist (e.g., /events "Radiohead"):

• WebSearch: "[artist name] concert {city} 2026"
• If Ticketmaster available: python3 ${CLAUDE_PLUGIN_ROOT}/scripts/fetch_events.py --city "{city}" --artist "name" --format json

Venue-Specific

If user asks about a specific venue (e.g., /events metro):

• Find venue in data/venues.json
• If found with Ticketmaster ID: python3 ${CLAUDE_PLUGIN_ROOT}/scripts/fetch_events.py --venue {slug} --days 30 --format json
• If no Ticketmaster ID: WebSearch "[venue name] upcoming shows schedule"

Error Handling

• No API keys: Use WebSearch for all categories. Note: "Set up a Ticketmaster API key for better music/theater results. See README.md for setup."
• Not set up yet: Direct to /date-plan setup
• No events found: Suggest checking venue websites, WebSearch broader queries