# Send Meetup Planner to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "meetup-planner",
    "name": "Meetup Planner",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/apresmoi/meetup-planner",
    "canonicalUrl": "https://clawhub.ai/apresmoi/meetup-planner",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/meetup-planner",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=meetup-planner",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "BOOTSTRAP.md",
      "README.md",
      "SKILL.md",
      "package.json"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "meetup-planner",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-05T11:36:15.483Z",
      "expiresAt": "2026-05-12T11:36:15.483Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=meetup-planner",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=meetup-planner",
        "contentDisposition": "attachment; filename=\"meetup-planner-0.1.5.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "meetup-planner"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/meetup-planner"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/meetup-planner",
    "downloadUrl": "https://openagent3.xyz/downloads/meetup-planner",
    "agentUrl": "https://openagent3.xyz/skills/meetup-planner/agent",
    "manifestUrl": "https://openagent3.xyz/skills/meetup-planner/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/meetup-planner/agent.md"
  }
}
```
## Documentation

### Meetup Planner

An intelligent assistant that helps you discover, track, and never miss events that match your interests.

### One-time Setup

IMPORTANT: After installing this skill, the agent will automatically run the bootstrap setup process from BOOTSTRAP.md.

The bootstrap process:

Checks for web search and crawling capabilities
Collects your event preferences
Sets up automated daily searches (optional)
Creates workspace structure

If you don't have search/crawling capabilities, I'll ask you to provide the necessary tools.

### What This Skill Does

After setup:

Daily Search: Automatically searches for events matching your profile every morning (if enabled)
Event Discovery: Uses available search and scraping tools to find events across the web
Event Tracking: Saves and presents new events for your review
Smart Reminders: Sets up notifications 24 hours and 2 hours before confirmed events
Preference Management: Updates your interests and search criteria anytime

### First Time Setup

When you first run this skill, I will guide you through setup by following BOOTSTRAP.md.

The setup process is interactive and friendly:

✅ Check for web search and crawling capabilities
🎯 Learn your event preferences through a friendly conversation
⏰ Set up automated daily searches (optional)
📁 Create workspace structure with proper permissions

Setup takes 2-3 minutes. If you don't have search/crawling tools installed, I'll ask you to provide them.

### Initial Run

Run the meetup-planner skill to begin setup

### Daily Operations

Once set up, the skill will:

Search for events every morning automatically
Save findings to events.json
Present new events for your review
Track events you're interested in

### When You Find an Event You Like

Tell me "I'm interested in [event name]" and I will:

Mark it as confirmed
Send you the registration link
Set up reminders (24h and 2h before the event)

### Commands

update preferences - Modify your event preferences
show upcoming - Display all tracked events
remove event [name] - Stop tracking an event
pause search - Temporarily stop daily searches
resume search - Resume daily searches

### Data Storage

The skill maintains:

user-preferences.json - Your event preferences
events.json - All discovered and tracked events
event-reminders.json - Scheduled reminders

### Technical Details

Capabilities Required:

Web search capability (any search tool or skill)
Web crawling/scraping capability (any scraping tool or skill)

Scheduling:

Uses system cron jobs (or equivalent) for daily searches
Uses scheduled tasks for event reminders

### Privacy Note

All data is stored locally on your machine. Your preferences and tracked events are never sent anywhere except to search for new events via the configured APIs.

### Data Transmission & External API Usage

This skill makes external network requests to search and scrape event information. The exact services depend on what search/crawling tools you have installed.

What is sent:

Search query strings constructed from your preferences (e.g., "AI meetup San Francisco February 2026")
URLs of event pages to scrape
Your IP address (automatically sent by your network stack)
Any authentication credentials required by the search/crawling tools you use

What is NOT sent:

Your complete preference profile
Event registration status or history
Personal notes or modifications
Other tracked events

Purpose: To discover public events matching your interests and extract structured event details.

### Data Minimization Practices

Only essential data is transmitted to accomplish the task
All credentials are transmitted securely over HTTPS only
No telemetry, analytics, or usage tracking is performed
No data is sent to any services beyond your configured search/crawling tools

### Agent Instructions

IMPORTANT: After installing this skill, ALWAYS run the bootstrap setup from BOOTSTRAP.md before first use.

When this skill is invoked:

### Phase 0: Check Bootstrap Status (ALWAYS RUN THIS FIRST)

Before doing anything else, check if bootstrap is complete:

# Check if bootstrap config exists
cat ~/.openclaw/workspace/meetup-planner/config.json 2>/dev/null

If file doesn't exist OR bootstrapComplete: false:

Tell human: "👋 Welcome to Meetup Planner! I need to set up a few things first. This will only take a couple of minutes."
Follow BOOTSTRAP.md step-by-step (all steps in order)
Do NOT proceed to Phase 1/2/3 until bootstrap is complete

If file exists AND bootstrapComplete: true:

Bootstrap is done, proceed to the appropriate phase based on what human asked for:

"search now" → Phase 2 (Daily Search Routine)
"show upcoming" → Phase 3 (Event Confirmation & Tracking)
"update preferences" → Re-run the preference collection from BOOTSTRAP.md
No specific request → Ask: "What would you like to do? I can search for events, show upcoming events, or update your preferences."

### Phase 1: Setup

All setup is handled by BOOTSTRAP.md. See Phase 0 above.

### Phase 2: Daily Search Routine

Load preferences:

Read ~/.openclaw/workspace/meetup-planner/user-preferences.json
Parse the human's interests, location, preferred event types, etc.



Search for events:

Use your available search tool or skill to search for events matching preferences
Search queries should be constructed like:

"{topic} meetup {location} {current_month}"
"{topic} conference {location} upcoming"
"{topic} workshop {location}"


Run multiple searches covering all their topics of interest



Extract event details:

For each promising search result, use your available scraping tool or skill to scrape the event page
Extract: event name, date, time, location, description, registration link, cost
Look for: Eventbrite, Meetup.com, Luma, conference sites, etc.



Filter and save:

Load existing events from ~/.openclaw/workspace/meetup-planner/events.json
Filter out duplicates and events that don't match criteria
Add new events to the file
Mark each event with: {id, name, date, time, location, url, description, cost, added_date, status: "new"}



Present to human:

Format new events nicely with all key details
Ask: "I found X new events that match your interests. Would you like to hear about them?"
Share event details one by one or as a list
For each event, ask if they're interested

### Phase 3: Event Confirmation & Tracking

When human expresses interest:

Update event status to "interested" in events.json
Provide the registration link: "Here's the link to register: {url}"
Ask: "Let me know when you've registered!"



When human confirms registration:

Update event status to "registered" in events.json
Schedule reminders in ~/.openclaw/workspace/meetup-planner/reminders.json:
{
  "event_id": "abc123",
  "event_name": "...",
  "reminders": [
    {"time": "24_hours_before", "sent": false},
    {"time": "2_hours_before", "sent": false}
  ]
}


Confirm: "Great! I'll remind you 24 hours before and 2 hours before the event."

### Phase 4: Reminder System

Check for due reminders (run this check every hour):

Load ~/.openclaw/workspace/meetup-planner/reminders.json
Check current time against event time
If within 24-25 hours before event and 24h reminder not sent:

Notify human: "Reminder: {event_name} is tomorrow at {time}! Location: {location}"
Mark 24h reminder as sent


If within 2-3 hours before event and 2h reminder not sent:

Notify human: "Heads up! {event_name} starts in 2 hours at {time}. Time to get ready!"
Mark 2h reminder as sent





Post-event cleanup:

After event date passes, move event to "past" status
Optionally ask: "How was {event_name}? Would you like me to look for similar events?"

### Phase 5: Ongoing Commands

Support these commands from your human:

"update preferences" / "change preferences": Re-run the preference collection interview
"show upcoming": Display all events with status "interested" or "registered"
"show new events": Display events with status "new" that haven't been reviewed
"remove event [name]": Remove an event from tracking
"pause search": Stop daily automated searches (update config)
"resume search": Resume daily automated searches
"search now": Run the search routine immediately
"list past events": Show events that have already occurred

### Error Handling

If skills fail to install: Provide manual instructions and the GitHub links
If API keys are invalid: Ask human to verify and provide new keys
If searches return no results: Try broader search terms or suggest different topics
If cron setup fails: Offer to search manually when user requests
If event scraping fails: Fall back to showing just the search result link
Always preserve data: Never overwrite events.json or preferences.json without backing up

### File Structure

~/.openclaw/workspace/meetup-planner/
├── user-preferences.json    # Human's event preferences
├── events.json              # All discovered and tracked events
├── reminders.json           # Scheduled reminders
├── config.json              # Skill configuration (cron schedule, etc.)
└── backups/                 # Automatic backups of data files
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: apresmoi
- Version: 0.1.5
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-05T11:36:15.483Z
- Expires at: 2026-05-12T11:36:15.483Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/meetup-planner)
- [Send to Agent page](https://openagent3.xyz/skills/meetup-planner/agent)
- [JSON manifest](https://openagent3.xyz/skills/meetup-planner/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/meetup-planner/agent.md)
- [Download page](https://openagent3.xyz/downloads/meetup-planner)