China Holiday Calculator

Chinese mainland calendar service - identifies法定节假日, weekends, makeup workdays, and supports city-specific vacations

Security Scan

The skill largely matches its stated purpose (holiday/calendar checks) but contains mismatches (config file path and metadata) and minor packaging issues that should be fixed or verified before use.

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.

What to consider before installing

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.

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