← Back to Skills Marketplace
udiedrichsen

Event Planner

by udiedrichsen · GitHub ↗ · v1.1.0
cross-platform ✓ Security Clean
2450
Downloads
6
Stars
8
Active Installs
2
Versions
Install in OpenClaw
/install event-planner
Description
Plan events (night out, weekend, date night, team outing, meals, trips) by searching venues via Google Places API. Auto-selects best restaurants, bars, activities based on location, budget, party size, and preferences. Generates detailed itinerary with timing and Google Maps link. Use when asked to plan an outing, create an itinerary, find places for events, or organize activities.
README (SKILL.md)

Event Planner

Plan events by searching venues and generating itineraries with Google Maps links.

Quick Start

Plan a night out:

uv run {baseDir}/scripts/plan_event.py "night out" \
  --location "Times Square, NYC" \
  --party-size 4 \
  --budget medium \
  --duration 4h

Plan a weekend day:

uv run {baseDir}/scripts/plan_event.py "weekend day" \
  --location "Central Park, NYC" \
  --party-size 2 \
  --budget "$100 per person" \
  --preferences "outdoors, casual dining"

Plan a date night:

uv run {baseDir}/scripts/plan_event.py "date night" \
  --location "SoHo, NYC" \
  --budget high \
  --duration 3h

Event Types

  • night-out: Dinner + 1-2 bars/lounges (3-4 hours)
  • weekend-day: Brunch/lunch + activity + dinner (6-8 hours)
  • date-night: Romantic restaurant + dessert/drinks spot (2-3 hours)
  • team-event: Group activity + dinner venue (3-5 hours)
  • lunch: Single restaurant recommendation
  • dinner: Single restaurant recommendation
  • trip: Multi-day itinerary with daily plans

Parameters

  • --location: City, address, or landmark (required)
  • --party-size: Number of people (default: 2)
  • --budget: "low/medium/high" or "$X per person" (default: medium)
  • --duration: Hours available (e.g., "3h", "full day")
  • --preferences: Comma-separated (e.g., "vegetarian, outdoor seating, live music")
  • --start-time: When to start (default: inferred from event type)
  • --output: text|json (default: text)
  • --date: Target date in YYYY-MM-DD format for day-specific checks (default: today)

Output Format

Default (text): Markdown itinerary with timeline, venue details, travel info, and Google Maps link

JSON: Structured data with all venue details, coordinates, and parsed metadata

Limitations

  • API limits: Google Places API has usage quotas (check your billing)
  • Real-time data: Venue hours may change; always confirm before going
  • Budget estimates: Based on Google's price level (0-4), not exact costs
  • Travel times: Uses Google Directions API when available; falls back to distance-based estimates with 30% buffer
  • Opening hours: Places without verified hours will show warnings; do not assume availability
  • Event venues: Cultural centers, theaters, and event spaces may have variable hours depending on scheduled events

API Requirements

The event planner uses:

  • Google Places API (New): Required for venue search
  • Google Directions API: Optional but recommended for accurate travel times

Both APIs can use the same GOOGLE_PLACES_API_KEY if enabled in Google Cloud Console.

Error Handling

  • Invalid location → Returns error with suggestions
  • No venues found → Relaxes filters and retries
  • API failures → Retry with exponential backoff (3 attempts)
Usage Guidance
This skill appears to do what it says: query Google Places and build itineraries. Before installing, verify the origin you trust (homepage is provided but source is 'unknown'). If you provide a GOOGLE_PLACES_API_KEY: restrict that key in Google Cloud Console to only the required APIs (Places, Directions/Maps), and apply application restrictions (HTTP referrers or IPs) and quota/billing limits. Inspect the included script if you can — I noticed a coding bug (a likely typo in the distance calculation) that could cause runtime errors; consider testing in a controlled environment. Finally, ensure your key has least privilege and monitor API usage after enabling the skill.
Capability Analysis
Type: OpenClaw Skill Name: event-planner Version: 1.1.0 The skill bundle is benign. The `SKILL.md` provides clear instructions for the AI agent without any prompt injection attempts or malicious directives. The `scripts/plan_event.py` script legitimately uses the `GOOGLE_PLACES_API_KEY` environment variable to interact with the Google Places and Directions APIs, as declared. There is no evidence of data exfiltration, unauthorized execution, persistence mechanisms, or obfuscation. All actions are aligned with the stated purpose of planning events and generating itineraries.
Capability Assessment
✓ Purpose & Capability
Name/description say it queries Google Places and builds itineraries; the code and SKILL.md only require GOOGLE_PLACES_API_KEY and a 'uv' runner. The required env var and the brew install of the 'uv' binary align with the usage examples.
✓ Instruction Scope
SKILL.md and the script direct only Google Places / Directions requests and local itinerary formatting. The runtime reads only GOOGLE_PLACES_API_KEY from the environment and does not request unrelated files, other credentials, or external endpoints beyond Google Maps APIs.
✓ Install Mechanism
Install is a single brew formula (uv) which matches the SKILL.md examples that call 'uv run'. No downloads from arbitrary URLs or archive extraction are present. The Python dependency (requests) is declared in the script header comments; this is expected for a Python script and not an install-time red flag.
✓ Credentials
Only one environment variable is required: GOOGLE_PLACES_API_KEY. That is proportional to a skill that calls Google Places/Directions. No other secrets, unrelated credentials, or config paths are requested.
✓ Persistence & Privilege
always is false and the skill does not request system-wide changes. It does not claim autonomous always-on privileges or modify other skills' configs.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install event-planner
  3. After installation, invoke the skill by name or use /event-planner
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.1.0
Add Google Directions API for accurate walking times/distances, venue deduplication, expanded search for sparse areas, opening hours warnings
v1.0.0
Initial release: event planning with Google Places API integration, multi-event support, smart venue selection, and Google Maps itineraries
Metadata
Slug event-planner
Version 1.1.0
License —
All-time Installs 8
Active Installs 8
Total Versions 2
Frequently Asked Questions

What is Event Planner?

Plan events (night out, weekend, date night, team outing, meals, trips) by searching venues via Google Places API. Auto-selects best restaurants, bars, activities based on location, budget, party size, and preferences. Generates detailed itinerary with timing and Google Maps link. Use when asked to plan an outing, create an itinerary, find places for events, or organize activities. It is an AI Agent Skill for Claude Code / OpenClaw, with 2450 downloads so far.

How do I install Event Planner?

Run "/install event-planner" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Event Planner free?

Yes, Event Planner is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Event Planner support?

Event Planner is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Event Planner?

It is built and maintained by udiedrichsen (@udiedrichsen); the current version is v1.1.0.

More Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463283 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259410 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200423 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191115 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190156 · by oswalpalash

💬 Comments