← Back to Skills Marketplace
violin

China Holiday

by joeyang · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ Security Clean
461
Downloads
0
Stars
3
Active Installs
1
Versions
Install in OpenClaw
/install china-holiday
Description
中国大陆日历服务 - 识别法定节假日、周末、调休,各地寒暑假、春秋假
README (SKILL.md)

China Holiday

中国大陆日历服务,判断任意日期的假期状态。

功能

  • 法定节假日:元旦、春节、清明、五一、端午、中秋、国庆
  • 调休:识别补班日
  • 周末:自动识别周六日
  • 寒暑假:支持主要城市
  • 春秋假:部分地区

使用示例

# 判断今天是否上班
python holiday.py today

# 判断指定日期
python holiday.py 2026-01-01

# 查询北京暑假时间
python holiday.py vacation 北京

# 查询某年所有节假日
python holiday.py list 2026

API 调用

from holiday import is_holiday, is_workday, get_holiday_name

# 判断是否为假日
is_holiday("2026-01-01")  # True (元旦)

# 判断是否上班
is_workday("2026-01-28")  # True (春节前调休)

# 获取假日名称
get_holiday_name("2026-01-01")  # "元旦"

支持城市

  • 北京、上海、广州、深圳
  • 更多城市陆续添加...
Usage Guidance
This appears to be a straightforward local calendar utility. Before installing or running it: (1) confirm you trust/verify the 'chinese-calendar' pip package source (e.g., PyPI listing, maintainer) to avoid supply-chain risks; (2) install and run in a normal user account or sandbox if you are cautious; (3) review config/regions.json if you rely on region-specific data; (4) if your environment auto-installs requirements, ensure pip actions meet your policy. No credentials or network activity are required by the code, so the main remaining risk is the upstream Python dependency.
Capability Analysis
Type: OpenClaw Skill Name: china-holiday Version: 1.0.0 The skill bundle provides a legitimate utility for checking Chinese statutory holidays, workdays, and school vacations. The implementation in holiday.py uses the standard chinese-calendar library and local configuration files (config/regions.json) without any network access, sensitive data retrieval, or suspicious execution patterns.
Capability Assessment
Purpose & Capability
Name/description match the included Python script and config. The skill only needs python3 and the 'chinese-calendar' package, which is appropriate for computing Chinese holidays and workdays.
Instruction Scope
SKILL.md and the code limit operations to local date computation and reading config/regions.json. There are no instructions to read arbitrary user files, access environment variables, or send data to external endpoints.
Install Mechanism
No install spec is provided (instruction-only in registry), but requirements.txt lists 'chinese-calendar' — the user/environment will need to pip install that package. There are no suspicious downloads or custom installers.
Credentials
The skill declares no required env vars or credentials and the code does not access secrets or external service tokens.
Persistence & Privilege
Skill is not always-on and does not modify other skills or system-wide configuration. It runs only when invoked and does not request elevated privileges.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install china-holiday
  3. After installation, invoke the skill by name or use /china-holiday
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
China Holiday 1.0.0 - Initial release of China Holiday skill. - Provides Chinese mainland calendar service: recognizes official holidays, weekends, adjusted workdays, and school vacations in major cities. - Supports command line usage and Python API. - Includes holiday and vacation date queries for specific cities (Beijing, Shanghai, Guangzhou, Shenzhen).
Metadata
Slug china-holiday
Version 1.0.0
License MIT-0
All-time Installs 3
Active Installs 3
Total Versions 1
Frequently Asked Questions

What is China Holiday?

中国大陆日历服务 - 识别法定节假日、周末、调休,各地寒暑假、春秋假. It is an AI Agent Skill for Claude Code / OpenClaw, with 461 downloads so far.

How do I install China Holiday?

Run "/install china-holiday" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is China Holiday free?

Yes, China Holiday is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does China Holiday support?

China Holiday is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created China Holiday?

It is built and maintained by joeyang (@violin); the current version is v1.0.0.

💬 Comments