sunset

Fetches tonight's sunset time from Open-Meteo and announces it once near dusk.

1.3k|113|Updated May 11, 2026
One-click install
npx skills add https://github.com/perminder-klair/subwave --skill sunset
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sunset
Source: https://github.com/perminder-klair/subwave/tree/main/docs/examples/skills/sunset
Command: npx skills add https://github.com/perminder-klair/subwave --skill sunset

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Radio DJs on a SUB/WAVE station need timely, human-sounding between-track content, and manually tracking daily sunset times for the station's location is repetitive and easy to forget.

Core Features & Use Cases

  • Sunset Lookup: Queries the keyless Open-Meteo API with operator-configured latitude and longitude to get tonight's local sunset time.
  • Dusk-Window Gating: Only returns data within 90 minutes of sunset, so the line airs when it is actually relevant.
  • Once-a-Day Memory: Persists state between firings so the sunset is mentioned at most once per day, even when the cooldown lapses repeatedly.
  • Use Case: A station operator sets coordinates for London in the admin skills panel, and the AI DJ naturally mentions "the light goes at twenty past eight" once during the evening broadcast.

Quick Start

Set the latitude, longitude, and optional place name in the skill's edit form under /admin/skills and let the DJ announce tonight's sunset near dusk.

Frequently Asked Questions about sunset

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add a sunset announcement to an AI radio DJ?

Install this skill in your SUB/WAVE station and set the latitude, longitude, and optional place name in the skill's edit form under /admin/skills. The DJ then mentions tonight's sunset time once per day when the broadcast is within 90 minutes of dusk.

What API provides sunset times without an API key?

Open-Meteo provides sunset times without an API key through its forecast endpoint. Requesting daily=sunset with timezone=auto returns the sunset time in the local zone of the given coordinates.

Why is the sunset skill not announcing anything?

The skill stays silent when coordinates are missing or invalid, when the current time is outside the 90-minute dusk window, or when the sunset was already announced today. Check the booth log for messages explaining which condition applied.

Can I run multiple sunset skills for different locations?

Yes, duplicate the skill folder and set different coordinates in each copy's edit form. Because config fields are declared in the tool code rather than against the skill name, each copy keeps its own form and settings.

What happens when the sunset API request fails?

The fetch is bounded by a 5-second timeout, and any network or HTTP error is caught and logged to the booth log. The skill then returns available: false, so the DJ simply skips the segment instead of failing.