← Back to Skills Marketplace
178
Downloads
0
Stars
2
Active Installs
1
Versions
Install in OpenClaw
/install chinese-holidays
Description
Query Chinese statutory holidays, check if a date is a working day/holiday, and get holiday schedules. Use when the user asks about Chinese holidays, working...
README (SKILL.md)
Chinese Holidays
Query Chinese statutory holidays and working day status.
Quick Start
python scripts/holidays.py today
python scripts/holidays.py check 2025-01-01
python scripts/holidays.py list 2025
Commands
today — Check today's status
Check if today is a working day, holiday, or weekend.
python scripts/holidays.py today
Output:
2025-01-01 (Wednesday)
Status: HOLIDAY - New Year's Day (元旦)
check \x3Cdate> — Check specific date
Check if a specific date is a working day or holiday.
python scripts/holidays.py check 2025-02-10
Output:
2025-02-10 (Monday)
Status: HOLIDAY - Spring Festival (春节)
list \x3Cyear> — List all holidays in a year
List all statutory holidays for a given year.
python scripts/holidays.py list 2025
Output:
=== 2025 Chinese Statutory Holidays ===
1. New Year's Day (元旦)
2025-01-01
2. Spring Festival (春节)
2025-01-28 to 2025-02-04 (8 days)
3. Qingming Festival (清明节)
2025-04-04 to 2025-04-06 (3 days)
4. Labor Day (劳动节)
2025-05-01 to 2025-05-05 (5 days)
5. Dragon Boat Festival (端午节)
2025-05-31 to 2025-06-02 (3 days)
6. Mid-Autumn Festival (中秋节)
2025-10-06 (1 day, combined with National Day)
7. National Day (国庆节)
2025-10-01 to 2025-10-07 (7 days)
next — Find next holiday
Find the next upcoming holiday.
python scripts/holidays.py next
Output:
Next holiday: Spring Festival (春节)
Date: 2025-01-28 to 2025-02-04
Days until: 15 days
Return Codes
| Code | Meaning |
|---|---|
| 0 | Working day |
| 1 | Weekend |
| 2 | Statutory holiday |
| 3 | Adjusted working day (调休) |
Data Source
Holiday data is based on official announcements from the State Council of China (国务院办公厅). The script includes:
- Statutory holiday dates
- Adjusted working days (调休)
- Holiday names in Chinese and English
Notes
- Adjusted working days (调休) are weekends that become working days due to holiday adjustments
- Some holidays may change based on official announcements - data is updated annually
- Supports dates from 2024 onwards
Usage Guidance
This skill is a small, local utility that hard-codes Chinese holiday dates for 2024–2026 and does not access the network or secrets, so it is coherent with its description. Before installing: ensure you only need static, local data (if you need future years or official updates, prefer a maintained API or update the data annually). Confirm you have a trusted Python runtime to run the script. Autonomous invocation is allowed by default, but in this case that poses low risk because the code has no external I/O or credential access.
Capability Analysis
Type: OpenClaw Skill
Name: chinese-holidays
Version: 1.0.0
The skill is a straightforward utility for querying Chinese statutory holidays using hardcoded data for the years 2024–2026. The Python script (scripts/holidays.py) uses only standard libraries, contains no network or file system access, and lacks any signs of obfuscation or malicious intent. The instructions in SKILL.md are consistent with the script's functionality.
Capability Assessment
Purpose & Capability
Name/description match the provided artifacts. The script and SKILL.md both implement date checks, listing, and next-holiday logic for Chinese statutory holidays.
Instruction Scope
Instructions simply run the included Python script. The script only uses hard-coded holiday data (2024–2026) and local date/time — so behavior is narrow and within scope. Note: data is static and limited to 2024–2026; queries for years beyond that will return no data.
Install Mechanism
No install spec; this is effectively an instruction-only skill with an included script. Nothing is downloaded or written during install.
Credentials
No environment variables, credentials, or config paths are requested or accessed. The code does not read external secrets or system config.
Persistence & Privilege
Skill is not always-on and uses the platform default allowing autonomous invocation. It does not modify other skills or system-wide agent settings.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install chinese-holidays - After installation, invoke the skill by name or use
/chinese-holidays - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release - Query Chinese statutory holidays
Metadata
Frequently Asked Questions
What is Chinese Holidays?
Query Chinese statutory holidays, check if a date is a working day/holiday, and get holiday schedules. Use when the user asks about Chinese holidays, working... It is an AI Agent Skill for Claude Code / OpenClaw, with 178 downloads so far.
How do I install Chinese Holidays?
Run "/install chinese-holidays" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Chinese Holidays free?
Yes, Chinese Holidays is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Chinese Holidays support?
Chinese Holidays is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Chinese Holidays?
It is built and maintained by anlinxi (@anlinxi); the current version is v1.0.0.
More Skills