A specialized skill for fetching and parsing official Chinese statutory holiday schedules and mandatory work-day adjustments.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install china-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 china-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 China Holidays?
The China Holidays skill provides AI agents with the ability to retrieve official holiday schedules directly from the State Council of the People's Republic of China (www.gov.cn). It ensures that users have access to the most authoritative data regarding public holidays and the unique adjustment system that defines compensatory work days. As part of the Openclaw Skills library, this tool is vital for any developer or user managing schedules, travel, or operations within the Chinese context.
By automating the retrieval and parsing of government notices, this skill eliminates the manual task of searching for official calendar releases. It supports data for the current year, historical records, and upcoming years as soon as they are officially announced, typically in the late fourth quarter of the preceding year.
China Holidays Use Cases
- Retrieving the full annual holiday schedule for specific years.
- Confirming specific dates for mandatory compensatory work days.
- Calculating the exact number of consecutive days off for major festivals like Lunar New Year.
- Automating calendar updates and project planning based on official vacation cycles.
How China Holidays Works
- The skill identifies the target year from user input or defaults to the current system year.
- It implements a cache-priority strategy, checking local markdown files for previously retrieved data.
- If the data is not cached, the skill accesses the official government portal to fetch the latest announcements.
- The raw announcement is processed by the AI agent to extract structured dates, holiday names, and adjustment instructions.
- The finalized data is presented to the user in their preferred format, such as a summary list or JSON object.
China Holidays Setup
To fetch holiday data for a specific year, run the following command in your terminal:
python scripts/fetch_holidays.py --year 2026
To force a data refresh from the official government source and bypass the local cache, use the force flag:
python scripts/fetch_holidays.py --year 2026 --force
China Holidays Data Schema & Taxonomy
The skill manages its data through a structured local asset system to ensure speed and reliability within Openclaw Skills:
| Component | Location | Description |
|---|---|---|
| Data Cache | assets/{year}.md |
Stores the raw markdown content of the official government notice. |
| Retrieval Logic | scripts/fetch_holidays.py |
Python script that handles URL discovery, fetching, and local storage. |
| Configuration | SKILL.md |
Defines the triggers and metadata for the AI agent. |
China Holidays Advanced Features
- Intelligent Cache-First Strategy: Provides millisecond response times by prioritizing local markdown assets for Openclaw Skills users.
- Multi-Format Output: Supports standard textual summaries, Markdown tables, and structured JSON for programmatic use.
- Differential Analysis: Capabilities to compare holiday lengths and dates between multiple years for historical trends.
- Official Source Integration: Direct scraping and parsing of official government bulletins to ensure legal and technical accuracy.
SKILL.md
Loading
Related Openclaw Skills
Chinese Copywriting Pro
A high-performance AI agent skill specialized in generating persuasive, platform-native Chinese marketing content for global and local markets.
Openclaw Peer Bridge
A professional framework for designing and operating secure, auditable communication patterns between multiple OpenClaw instances.
Plant Identifier
A privacy-focused plant identification engine that uses trait-based analysis and local memory to catalog botanical observations.
arXiv Paper Digest
A smart research assistant that fetches, ranks, and simplifies trending AI/ML papers for daily consumption.
Invoice Tracker
An AI-powered bookkeeping assistant that transforms natural language into structured financial ledgers and professional reports.
TransPrompt
An intelligent prompt engineering utility that converts natural language requests into structured, high-performance AI instructions.
Featured*
