A Python-powered skill for identifying, listing, and managing public holidays across 249 countries and their subdivisions.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install global-holidays
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install global-holidays using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Global Holidays?
The Global Holidays skill leverages the robust Python holidays library to provide AI agents with real-time access to government-designated public holidays. By integrating this capability into Openclaw Skills, developers can build agents that understand regional calendar nuances, allowing for smarter scheduling and more accurate business day calculations.
This tool supports the ISO 3166-1 alpha-2 country standard and ISO 3166-2 subdivision codes, covering states, provinces, and regions globally. Whether you need to verify if a specific date is a holiday in California or list all observed dates in Japan for the upcoming year, this skill provides a dictionary-like interface for seamless data retrieval.
Global Holidays Use Cases
- Determining if a specific date is a public holiday before scheduling meetings or deadlines.
- Generating comprehensive lists of annual holidays for specific countries or regions.
- Calculating business days by identifying and skipping government-designated holidays.
- Merging official public holiday data with custom organizational or personal holiday dates.
- Handling localized holiday names for international teams and global applications.
How Global Holidays Works
- The agent invokes the skill when a query involves dates, holidays, or business day logic.
- The skill initializes a HolidayBase object using the country_holidays function with specified parameters like country code and year.
- It optionally filters data by subdivisions or specific categories to narrow down the relevant dates.
- The system queries the dictionary-like structure to return the holiday name or determine if a date is a work day.
- Results are formatted and returned to the agent to complete the scheduling or reporting task.
Global Holidays Setup
To use this skill within your Openclaw Skills environment, ensure Python 3.10+ is installed and run the following command:
pip install holidays --break-system-packages
For production stability, it is recommended to pin the version:
pip install holidays==0.58 --break-system-packages
Global Holidays Data Schema & Taxonomy
The skill organizes data using a dictionary-like mapping of dates to holiday names. Below is the primary structure:
| Property | Type | Description |
|---|---|---|
| Date Key | datetime.date or str | The specific date in YYYY-MM-DD format. |
| Holiday Value | str | The name of the holiday (e.g., 'Christmas Day'). |
| Metadata | dict | Optional ISO country and subdivision codes. |
Custom holidays can be integrated via JSON files with the following format:
{
"2024-07-10": "Company Anniversary",
"2024-10-01": "Internal Holiday"
}
Global Holidays Advanced Features
- Multilingual Support: Retrieve holiday names in various languages using ISO 639-1 language codes via the language parameter.
- Subdivision Accuracy: Drill down into regional holidays for specific states or provinces using ISO 3166-2 codes.
- Observed Date Logic: Toggle between statutory dates and observed dates (e.g., Monday holidays for weekend events) using the observed flag.
- Dynamic Expansion: Automatically load holiday data for new years as they are queried without manual reconfiguration.
- Custom Merging: Securely update the holiday set with user-provided JSON files to include personal or corporate events within Openclaw Skills.
SKILL.md
Loading
Related Openclaw Skills
Library Book Monitor
An automated library tracking tool that notifies you the moment a desired book becomes available for borrowing.
Library Book Monitor
A smart automation tool to monitor library book availability and send notifications when books become available for borrowing.
Gemini Image Proxy
A lightweight utility to generate and edit images using Gemini models through an OpenAI-compatible interface.
Ollama Local Model Integration
A skill that integrates local Ollama models into your AI workflow for private, offline intelligence.
Search Realtime Information
This skill enables AI agents to bypass training data cutoffs by performing live web searches for the latest information.
Document Converter
A high-efficiency conversion tool that transforms complex document formats into clean, structured Markdown text.
METADATA
Featured*
