WindSensei - Wind Forecast Assistant

Check wind conditions at your favorite spots and take action on good forecasts.

When to Use This Skill

Activate when the user asks about:

• Wind conditions, wind forecast, or weather for wind sports
• "How's the wind?", "Should I go kiting?", "Any good wind this weekend?"
• "What's it looking like at [spot name]?", "Wind report"
• Kiting, kitesurfing, wingfoiling, windsurfing, surfing conditions
• Blocking off time or adding sessions to their calendar based on wind
• Finding spots near a location or exploring new spots
• Session history, stats, or activity logs
• What friends are riding right now (live sessions)

Configuration

Credentials

• WINDSENSEI_API_KEY: An API key starting with ss_. Optional — the skill works fully without it. Without it, you can still query any public spot by name, search for spots, and find spots nearby. With it, you get personalized forecasts, dashboard overview, session history, and social features.
• No other credentials are required. This skill only makes HTTPS requests to the WindSensei API. Calendar features (if requested by the user) use the host agent's own calendar tools — this skill does not request or store any calendar credentials.

Getting an API Key

If the user wants personalized forecasts, guide them:

1. Sign up at windsensei.com
2. Add their favorite spots and set activity preferences
3. Go to their Profile page at windsensei.com/dashboard/profile — the API key manager is at the bottom of that page
4. Click "Create API Key", give it a name (e.g., "Claude" or "OpenClaw"), and copy the key
5. The key starts with ss_ — set it as WINDSENSEI_API_KEY in the agent's environment config

Direct link: https://windsensei.com/dashboard/profile (scroll to "API Keys" section)

Two Modes

Public Mode (no API key)

• Query any public spot by name using the spot parameter
• Search for spots by name
• Find spots near a latitude/longitude
• Uses default kiting preferences (12-40kt, 8am-8pm)
• Response includes a hint field suggesting signup for personalized results

Authenticated Mode (with API key)

• Everything in public mode, plus:
• Dashboard overview of all favorite spots in one call
• Personalized forecasts using the user's activity preferences, wind speed ranges, time windows
• Session history and stats
• Live session feed from followed users
• Favorites list
• No signup hint in response

Authentication

For all authenticated endpoints, include the API key as a Bearer token:

Authorization: Bearer {WINDSENSEI_API_KEY}

The API also accepts X-API-Key: {key} header or ?api_key={key} query param.

API Endpoints

1. Wind Report (Quick Summary)

The simplest way to check conditions. Returns a natural language summary plus structured data.

GET https://windsensei.com/api/v1/wind-report?when={when}