← Back to Skills Marketplace
China Holiday Calculator
by
manucode2000-max
· GitHub ↗
· v1.0.0
· MIT-0
110
Downloads
0
Stars
1
Active Installs
1
Versions
Install in OpenClaw
/install china-holiday-calc
Description
Chinese mainland calendar service - identifies法定节假日, weekends, makeup workdays, and supports city-specific vacations
README (SKILL.md)
China Holiday
中国大陆日历服务，判断任意日期的假期状态。
Features
- 法定节假日: 元旦、春节、清明、五一、端午、中秋、国庆
- 调休: 识别补班日
- 周末: 自动识别周六、周日
- 寒暑假: 支持主要城市
- 春秋假: 部分地区学校
Usage
# Check if today is a holiday
python holiday.py today
# Check specific date
python holiday.py 2026-01-01
# Query Beijing summer vacation
python holiday.py vacation 北京
# List all holidays for a year
python holiday.py list 2026
API
from holiday import is_holiday, is_workday, get_holiday_name
# Check if holiday
is_holiday("2026-01-01") # True (New Year's Day)
# Check if workday
is_workday("2026-01-28") # True (Spring Festival makeup workday)
# Get holiday name
get_holiday_name("2026-01-01") # "元旦"
Supported Cities
- Beijing, Shanghai, Guangzhou, Shenzhen
- More cities to be added...
Implementation
Uses official Chinese government holiday schedules with local variations for schools and universities.
License
MIT License
Usage Guidance
This skill appears to do what it says (holiday/workday detection) and has no network calls or credential requests, but there are a couple of practical issues to check before installing: 1) The code expects regions.json to live in a 'config' subfolder, but the repository contains regions.json at the top level — either move regions.json into a config directory or patch load_regions() so vacation lookups work. 2) _meta.json uses a different owner/slug than the registry metadata; verify the source and provenance if you care about origin. 3) The dependency 'chinese-calendar' is a third-party package — inspect that package (or its source) if you want to ensure it has no unexpected behavior. 4) Test the skill in a sandboxed environment first (ensure pip installs the required package into an isolated environment) and confirm the vacation command returns expected results after fixing the regions path.
Capability Assessment
Purpose & Capability
Name/description match the implementation: the Python code and SKILL.md provide holiday/workday/vacation queries. However, the code expects a regions.json under a 'config' subdirectory (CONFIG_DIR = <skill>/config/regions.json) while the repository contains regions.json at the top level. That means region-specific vacation lookups (vacation command) will not find data as-is. Also _meta.json slug/owner differ from the registry metadata, suggesting repackaging or copy-paste errors.
Instruction Scope
SKILL.md instructs running the included Python script and importing the provided functions; runtime instructions are narrow and consistent with the code. The skill does not ask to read arbitrary system files, access environment variables, or transmit data to external endpoints in its instructions.
Install Mechanism
No install script or remote downloads are used. There's a requirements.txt declaring the third‑party dependency 'chinese-calendar' which is expected for this functionality. No suspicious URLs or archive extraction are present.
Credentials
The skill requires no environment variables, credentials, or special config paths. It only reads local files (regions.json) and uses a pure-Python library; there are no disproportionate secret requests.
Persistence & Privilege
The skill does not request permanent presence (always: false) and does not modify other skills or system settings. Autonomous invocation is allowed by default but not combined with other red flags.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install china-holiday-calc - After installation, invoke the skill by name or use
/china-holiday-calc - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release
Metadata
Frequently Asked Questions
What is China Holiday Calculator?
Chinese mainland calendar service - identifies法定节假日, weekends, makeup workdays, and supports city-specific vacations. It is an AI Agent Skill for Claude Code / OpenClaw, with 110 downloads so far.
How do I install China Holiday Calculator?
Run "/install china-holiday-calc" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is China Holiday Calculator free?
Yes, China Holiday Calculator is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does China Holiday Calculator support?
China Holiday Calculator is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created China Holiday Calculator?
It is built and maintained by manucode2000-max (@manucode2000-max); the current version is v1.0.0.
More Skills