| name | find-local-events |
| description | Search for local events, activities, and happenings in a specified location and timeframe. Use when the user asks about events, concerts, festivals, meetups, or things to do in a specific area. |
| license | MIT |
Find Local Events
Search for local events, activities, concerts, festivals, and happenings in a specified location and timeframe.
When to Use This Skill
Use this skill when:
- User asks about events in a specific location
- User wants to find things to do in an area
- User requests information about concerts, festivals, or activities
- User asks what's happening on a specific date or timeframe
- User wants to discover local happenings or meetups
Critical Parameters
Location
ALWAYS clarify the location before searching. Location can be specified as:
- City name (e.g., "Seattle", "Portland")
- City with state/country (e.g., "Portland, OR" vs "Portland, ME")
- Neighborhood or district (e.g., "Capitol Hill, Seattle")
- Venue name (e.g., "The Paramount Theatre")
- ZIP code or postal code
Location Disambiguation: If location is ambiguous or not provided:
- Check CONTEXT.md for user's default location
- If no default, ask user to specify location
- For common city names, ask for clarification (e.g., "Did you mean Portland, OR or Portland, ME?")
DateTime
ALWAYS clarify the timeframe before searching. TimeFrames include:
- Specific date (e.g., "December 15", "next Friday")
- Date range (e.g., "this weekend", "next week")
- Relative time (e.g., "tonight", "tomorrow", "this month")
- Open-ended (e.g., "upcoming events")
DateTime Handling:
- Current date/time is critical for interpreting relative dates
- Default to user's timezone (check CONTEXT.md)
- If timeframe is vague, ask for clarification
- Always convert relative dates to specific dates before searching
Examples of Date Clarification:
- "this weekend" → Confirm which Saturday/Sunday dates
- "next week" → Clarify Monday-Sunday date range
- "soon" → Ask if they mean this week, this month, etc.
Process
Step 1: Parse User Request
Extract key information:
- Location (required)
- DateTime/Timeframe (required)
- Event type (optional: concerts, sports, festivals, etc.)
- Additional filters (optional: free events, family-friendly, etc.)
Step 2: Verify Parameters with User
Before searching, confirm:
- Location is specific and unambiguous
- DateTime range is clear
- User's timezone is correct
- Event type preferences (check CONTEXT.md for user's interests)
Step 3: Search for Events
Use available tools to search:
- Web search for event listings
- Check event aggregator sites (Eventbrite, Meetup, etc.)
- Search local venue calendars
- Look for community calendars and listing sites
Search Strategy:
# Example web search query construction
"events in [LOCATION] on [DATE]"
"[EVENT_TYPE] in [LOCATION] [TIMEFRAME]"
"things to do in [LOCATION] [TIMEFRAME]"
Step 4: Filter and Personalize Results
- Filter by event type based on user interests (see CONTEXT.md)
- Prioritize events matching user's stated preferences
- Exclude event types user typically avoids
- Sort by date/relevance
Step 5: Present Results
Format event information clearly:
- Event name and type
- Date and time (in user's timezone)
- Location/venue with address
- Brief description
- Link for more information
- Price/cost if applicable
Examples
Example 1: Basic Event Search
User Input: "What events are happening in Seattle this weekend?"
Process:
- Extract location: "Seattle"
- Extract timeframe: "this weekend"
- Clarify: "This weekend is December 16-17, 2023. Is that correct?"
- Check CONTEXT.md for user's event preferences
- Search for events in Seattle on those dates
- Filter based on user interests
Expected Output:
Events in Seattle this weekend (Dec 16-17, 2023):
Saturday, December 16:
• Seattle Symphony - Holiday Pops Concert
When: 7:30 PM
Where: Benaroya Hall, 200 University St
Cost: $45-85
More info: seattlesymphony.org
• Capitol Hill Art Walk
When: 6:00 PM - 9:00 PM
Where: Various galleries on Capitol Hill
Cost: Free
More info: capitolhillartwalk.com
Sunday, December 17:
• Pike Place Market Festival
When: 10:00 AM - 4:00 PM
Where: Pike Place Market
Cost: Free
More info: pikeplacemarket.org
Example 2: Specific Event Type
User Input: "Are there any live music shows in Portland next Friday?"
Process:
- Location ambiguity detected
- Ask: "Which Portland - Portland, OR or Portland, ME?"
- User clarifies: "Portland, OR"
- Calculate next Friday's date
- Search specifically for live music/concerts
- Present results
Expected Output:
Live music in Portland, OR on Friday, December 22, 2023:
• The Decemberists
When: 8:00 PM
Where: Crystal Ballroom, 1332 W Burnside St
Cost: $35-50
Genre: Indie Folk
More info: crystalballroompdx.com
• Jazz Night at Jimmy Mak's
When: 9:00 PM
Where: Jimmy Mak's, 221 NW 10th Ave
Cost: $15
Genre: Jazz
More info: jimmymaks.com
Example 3: Open-Ended Discovery
User Input: "What's happening in Austin next month?"
Process:
- Extract location: "Austin" (assume Austin, TX)
- Timeframe: "next month" is January 2024
- Check CONTEXT.md for user preferences
- Broad search across event types
- Filter to user's top interests
- Present diverse selection
Expected Output:
Upcoming events in Austin, TX (January 2024):
Highlighted for you (based on your interests):
Tech Events:
• Austin Tech Meetup - AI in Practice
When: Jan 10, 6:30 PM
Where: Capital Factory
Cost: Free
Music:
• Austin City Limits - Winter Series
When: Jan 15, 7:00 PM
Where: ACL Live at the Moody Theater
Cost: $40-75
Food & Drink:
• Austin Food + Wine Festival
When: Jan 20-22
Where: Auditorium Shores
Cost: $75-150 per day
[Show 15 more events...]
Best Practices
Location Handling
- Always confirm location if ambiguous
- Use full city names with state/country for clarity
- Store user's default location in CONTEXT.md
- Handle neighborhood-level specificity when provided
DateTime Handling
- Never assume dates - always calculate from current date
- Confirm timezone (default to user's timezone from CONTEXT.md)
- Be explicit about date ranges
- Handle "this weekend" vs "next weekend" carefully
- Account for events spanning multiple days
Personalization
- Reference CONTEXT.md for user's event preferences
- Prioritize event types user enjoys
- Note dietary restrictions for food events
- Consider accessibility needs if specified
- Remember past event interests
Search Quality
- Use multiple sources for comprehensive results
- Verify event details are current (check date posted)
- Include both mainstream and niche events
- Filter out past events
- Note if events require registration/tickets
Common Pitfalls
- Ambiguous locations: Portland, Springfield, Cambridge - always clarify
- Timezone confusion: Event times vs user timezone
- Outdated information: Verify events are still happening
- Missing location: User says "here" - must clarify actual location
- Vague timeframes: "soon", "later" - get specific dates
- Sold out events: Check availability before recommending
- Recurring events: Clarify which occurrence user wants
Dependencies
- Web search capability
- Current date/time for relative date calculations
- CONTEXT.md for user preferences and default location
- Access to event aggregator sites
Error Handling
Location Not Specified:
I need to know the location to search for events.
Where would you like to find events?
Ambiguous Location:
There are multiple cities named "Springfield".
Did you mean Springfield, IL, Springfield, MA, or Springfield, MO?
No Events Found:
I couldn't find any [EVENT_TYPE] events in [LOCATION] on [DATE].
Would you like to:
1. Expand the date range?
2. Search for different event types?
3. Try a nearby location?
Timeframe Not Specified:
What timeframe are you interested in?
- Today/Tonight
- This weekend
- Next week
- Specific date
Past Date Specified:
That date has already passed. Did you mean [NEXT_OCCURRENCE]?
Or would you like to search for upcoming events instead?
Integration with CONTEXT.md
This skill relies heavily on CONTEXT.md for personalization:
- Default location: User's home city/preferred search area
- Event preferences: Types of events user typically enjoys
- Timezone: User's local timezone for date/time calculations
- Accessibility needs: Any requirements for venue accessibility
- Budget preferences: Free events only, price ranges, etc.
- Past interests: Events user has asked about before
Always check CONTEXT.md first to provide personalized, relevant results.