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...

Security Scan

The skill is internally consistent with its stated purpose: it contains a small local Python tool and documentation to check Chinese statutory holidays and does not request credentials, perform network I/O, or modify system state.

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.

Assessment

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.

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 <date> — 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 <year> — 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