# China Holiday Calc

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

- Skill: `lord1egypt/china-holiday-calc` (Agent Skill)
- Install (CLI): `npx skillmds@latest add lord1egypt/china-holiday-calc`
- Raw SKILL.md: https://api.skillmd.com/api/skills/lord1egypt/china-holiday-calc/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- License: MIT
- Author: Lord1Egypt (https://skillmd.com/u/lord1egypt)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/lord1egypt/china-holiday-calc

---


# China Holiday

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

## Features

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

## Usage

```bash
# 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

```python
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