← All skills
Completed November 2026

Holidays of the Day

An Alexa skill that tells you what's being celebrated today: Italian national holidays, United Nations days, lesser-known world days and other countries' national days — from a dataset curated by hand, entry by entry.

Invocation: “Alexa, apri festività del giorno”

TypeScriptCloudflare WorkersPythonAlexaFlash BriefingDataset

The idea

“What’s being celebrated today?” Sometimes it’s a national holiday, often a United Nations day nobody has heard of, now and then a far-off country’s national day. I wanted Alexa to say it on its own in the morning, inside the daily briefing (the Flash Briefing), and on request by voice. It’s the twin of another skill of mine, the Day’s Almanac, but separate: the Almanac stays as it is, and I accepted a few repetitions in the briefing.

Documents first, then data, then code

As with the Almanac, I chose not to start from code: first requirements, architecture and data contracts with JSON schemas and examples validated by a script; then the dataset; only afterwards the program. It’s slower at the start, but has a concrete advantage: by the time you write the code, the hard questions already have a written answer. For the open choices (regional holidays and patron saints, duplicates with the Almanac, accents in the spoken text) I noted that they block nothing and can be revisited later.

A dataset, not a service

The basic decision is that nothing is consulted at runtime: no calls to external sites, no key-value store, no scheduled jobs. The dataset is a single file, bundled into the Worker on Cloudflare, and on each request the Worker works out for itself what falls today. Every entry has a date rule (fixed, tied to Easter, “the nth weekday of a month”, “the last day of…”, a list of dates year by year), a sentence ready to be read aloud, its sources and an approval flag. The Easter rule is written twice, in Python and in TypeScript, and the two are compared on 358 rules over 17 years: if the implementations don’t produce the same date, the test fails.

Gathering sources, and not trusting them

Candidates come from open sources, used only offline to build the dataset: the UN’s list of days (250 entries, English only, with the Italian names taken from UNRIC), Wikidata (625 entries, but only 169 with an Italian name), Wikipedia’s table of national days, which covers all 193 member states, a public-holiday calendar service and the list of holidays in Italy. Others I discarded as text because they have no clear licence or are commercial “days”. The traps were instructive:

I approve the dataset, one month at a time

The entries are written by the assistant, but I approve them one month at a time (twelve batches), under a simple rule: every entry has a source, and better one entry fewer than a wrong date. Empty days are filled with lesser-known days, only if verifiable; where there’s nothing certain, the day stays empty by choice, with a list of rejects. The result: 713 approved entries, and 327 of 365 days with a reading, 26 words on average (maximum 80). A short bulletin is fine: no minimum. Weeks are announced only on their first day, months and years are excluded, and three foreign national days are read per day.

From the Worker to the two skills

The day after the Worker, with my go-ahead, the two skills were born: a Flash Briefing (the morning bulletin, which reads the ready-made text from the Worker) and a voice skill hosted by Alexa, to ask for “festività del giorno” whenever you like. The invocation name has an accented vowel, something to check because not every accented name is accepted: the model compiled without a problem. I tried them in Alexa’s simulator before giving them an icon, and the text always opens with the date, “Festività di…”, so it’s clear which day it refers to.

Trying it by voice revealed a rookie flaw: after the reading Alexa asks “Want to know more?”, but the model didn’t know what to do with a plain “no” or “yes”, and answered with an error. Now “no”, “never mind, that’s fine”, “enough” and “I’m done” close the session, while “yes” keeps listening: the kind of gap no text test finds, and which only appears when you actually talk to the skill.

Status

The project is done. The Worker has been in production since 19 October 2026, with all 713 entries approved, and the two skills (Flash Briefing and custom) were checked in the simulator, given their icons and the “no” fix, and submitted for Store certification on 25 October. Both were certified on 26 October 2026, a day, far ahead of Amazon’s mid-November estimate, and are live. From now on the calendar’s content changes without recertification, because the Worker serves it; a change to the voice skill itself would need a new submission. What remains is optional: the yearly check for changes, the lunar holidays and four states with no clear national day.

Stack

TypeScript (Cloudflare Workers) · Python (dataset collection and validation) · JSON Schema · Alexa Flash Briefing API · Alexa Skills Kit