How do I install the Chinese Workdays skill?

Run npx skillmds@latest add lord1egypt/chinese-workdays in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Chinese Workdays safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Chinese Workdays?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Chinese Workdays free to use?

Yes. Installing skills from SkillMD is free. This skill is licensed under MIT.

Who published Chinese Workdays?

Lord1Egypt (@lord1egypt) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Chinese Workdays by lord1egypt — Agent Skill

Name: Chinese Workdays
Rating: 4.666666666666667 (3 reviews)
Author: Lord1Egypt

Chinese Workdays

Calculate legal working days in China according to official government holiday schedules. Uses State Council-published arrangements to exclude weekends, public holidays, and include makeup workdays. Supports date ranges, months, quarters, and full years with automatic holiday calendar management.

Lord1Egypt Updated Sep 8, 2026 2 repo stars

File contents

Chinese Workdays Calculator

Calculate the number of working days between two dates according to Chinese government holiday schedules.

Features

📅 Uses official Chinese holiday schedules published by the State Council
🔢 Calculates法定工作日 (legal working days) excluding weekends and public holidays
📊 Supports holiday makeup workdays (调休补班)
🗂️ Stores yearly holiday schedules in simple YAML data files
🔄 Can be updated when new annual holiday arrangements are released
📊 Provides monthly and yearly statistics
🤖 CLI tool for quick calculations

Quick Start

Basic calculation

from chinese_workdays import ChineseWorkdays

calc = ChineseWorkdays()
workdays = calc.count_workdays("2026-01-01", "2026-12-31")
print(f"2026年全年工作日: {workdays}天")

Monthly statistics

march_workdays = calc.get_workdays_in_month(2026, 3)  # 22天

Usage Examples

How many working days are there in March 2026?
Working days in Q1 2026?
Calculate workdays between 2026-02-10 and 2026-03-20
How many workdays in 2026?

Command Line

# Quick calculations
python workdays_cmd.py 2026-03          # March 2026
python workdays_cmd.py 2026-Q1          # Q1 2026
python workdays_cmd.py 2026             # Full year
python workdays_cmd.py 2026-01-01 2026-06-30  # Custom range

Data Format

Holiday schedules are stored in YAML format in the data/ directory:

year: 2026
country: "China"
holidays:
  - name: "元旦"
    start: "2026-01-01"
    end: "2026-01-03"
    days_off: ["2026-01-01", "2026-01-02"]  #放假日期
    makeup_workdays: ["2025-12-28", "2026-01-04"]  # 调休上班
    note: "官方通知原文"

Updating Schedules

The State Council releases next year's holiday arrangement in November. Update the YAML file accordingly:

Locate the official notice at https://www.gov.cn/gongbao/
Extract dates and makeup workdays
Edit data/2027.yaml (or the relevant year)

Implementation Details

Uses Python's datetime for date arithmetic
Holiday data stored as YAML for easy editing
Supports makeup workdays that override weekend status
Handles holidays that span multiple days

Limitations

Requires holiday schedules to be defined for the years being calculated
Only works for dates after 2000 (easily extendable)
Does not automatically fetch new schedules (manual update needed)
Data accuracy depends on correct YAML configuration

Examples of Output

📅 工作日统计
📊 期间: 2026-01-01 至 2026-12-31
📏 总天数: 365
💼 法定工作日: 248 天

工作日占比: 68.0%

📋 期间包含的节假日:
  • 元旦: 2026-01-01 ~ 2026-01-03
  • 春节: 2026-02-15 ~ 2026-02-23
  ...

Technical Notes

Calculation Priority

Makeup workdays (highest priority) → always counted as working days
Public holidays → excluded from working days
Weekends (Saturday/Sunday) → excluded unless makeup workday
Regular weekdays → counted as working days

Algorithm

for each day in date_range:
    if day in makeup_workdays:
        count += 1
    elif day in public_holidays:
        skip
    elif day is weekend:
        skip
    else:
        count += 1

Files Structure

chinese-workdays/
├── SKILL.md              # This file
├── __init__.py           # Package entry point
├── chinese_workdays.py   # Core calculation engine
├── workdays_cmd.py       # CLI tool
├── README.md             # User documentation (optional)
└── data/
    ├── 2026.yaml         # 2026 holiday schedule (official)
    └── 2027.yaml         # 2027 holiday schedule (template)

License

MIT License - Free to use and modify.

---name: chinese-workdaysdescription: Calculate legal working days in China according to official government holiday schedules. Uses State Council-published arrangements to exclude weekends, public holidays, and include makeup workdays. Supports date ranges, months, quarters, and full years with automatic holiday calendar management.license: MIT---# Chinese Workdays CalculatorCalculate the number of working days between two dates according to Chinese government holiday schedules.## Features- 📅 Uses official Chinese holiday schedules published by the State Council- 🔢 Calculates法定工作日 (legal working days) excluding weekends and public holidays- 📊 Supports holiday makeup workdays (调休补班)- 🗂️ Stores yearly holiday schedules in simple YAML data files- 🔄 Can be updated when new annual holiday arrangements are released- 📊 Provides monthly and yearly statistics- 🤖 CLI tool for quick calculations## Quick Start### Basic calculation```pythonfrom chinese_workdays import ChineseWorkdayscalc = ChineseWorkdays()workdays = calc.count_workdays("2026-01-01", "2026-12-31")print(f"2026年全年工作日: {workdays}天")```### Monthly statistics```pythonmarch_workdays = calc.get_workdays_in_month(2026, 3) # 22天```## Usage Examples```How many working days are there in March 2026?Working days in Q1 2026?Calculate workdays between 2026-02-10 and 2026-03-20How many workdays in 2026?```### Command Line```bash# Quick calculationspython workdays_cmd.py 2026-03 # March 2026python workdays_cmd.py 2026-Q1 # Q1 2026python workdays_cmd.py 2026 # Full yearpython workdays_cmd.py 2026-01-01 2026-06-30 # Custom range```## Data FormatHoliday schedules are stored in YAML format in the `data/` directory:```yamlyear: 2026country: "China"holidays: - name: "元旦" start: "2026-01-01" end: "2026-01-03" days_off: ["2026-01-01", "2026-01-02"] #放假日期 makeup_workdays: ["2025-12-28", "2026-01-04"] # 调休上班 note: "官方通知原文"```## Updating SchedulesThe State Council releases next year's holiday arrangement in November. Update the YAML file accordingly:1. Locate the official notice at `https://www.gov.cn/gongbao/`2. Extract dates and makeup workdays3. Edit `data/2027.yaml` (or the relevant year)## Implementation Details- Uses Python's `datetime` for date arithmetic- Holiday data stored as YAML for easy editing- Supports makeup workdays that override weekend status- Handles holidays that span multiple days## Limitations- Requires holiday schedules to be defined for the years being calculated- Only works for dates after 2000 (easily extendable)- Does not automatically fetch new schedules (manual update needed)- Data accuracy depends on correct YAML configuration## Examples of Output```📅 工作日统计📊 期间: 2026-01-01 至 2026-12-31📏 总天数: 365💼 法定工作日: 248 天工作日占比: 68.0%📋 期间包含的节假日: • 元旦: 2026-01-01 ~ 2026-01-03 • 春节: 2026-02-15 ~ 2026-02-23 ...```## Technical Notes### Calculation Priority1. **Makeup workdays** (highest priority) → always counted as working days2. **Public holidays** → excluded from working days3. **Weekends** (Saturday/Sunday) → excluded unless makeup workday4. **Regular weekdays** → counted as working days### Algorithm```pythonfor each day in date_range: if day in makeup_workdays: count += 1 elif day in public_holidays: skip elif day is weekend: skip else: count += 1```## Files Structure```chinese-workdays/├── SKILL.md # This file├── __init__.py # Package entry point├── chinese_workdays.py # Core calculation engine├── workdays_cmd.py # CLI tool├── README.md # User documentation (optional)└── data/ ├── 2026.yaml # 2026 holiday schedule (official) └── 2027.yaml # 2027 holiday schedule (template)```## LicenseMIT License - Free to use and modify.

Frequently asked questions