Cn Holiday Checker

What This Skill Does

The Cn Holiday Checker is an essential OpenClaw agent skill designed to handle the complexities of the Chinese calendar system. Navigating China's unique holiday schedule—which includes shifting weekends to accommodate long public holidays—can be difficult for automated systems. This skill solves that by synchronizing with iCloud holiday data to distinguish between standard workdays, official public holidays, and makeup work-shift days. By utilizing a combination of explicit data sources and a logical fallback mechanism, the skill accurately identifies the status of any given date. It is highly automated, utilizing scheduled cron tasks to ensure the calendar data remains current without manual intervention.

Installation

To integrate this skill into your OpenClaw environment, execute the following command in your terminal: clawhub install openclaw/skills/skills/claudecaicai/cn-holiday-checker Ensure your system meets the requirements of Python 3.x and verify that the dependencies requests and icalendar are installed. Once installed, you can configure your specific data sources (primary and backup URLs) within the config.json file located in the skill directory.

Use Cases

This skill is perfect for professionals, team leads, and anyone coordinating cross-border projects involving Chinese colleagues. It is ideal for automatically filtering emails or tasks during off-days, scheduling meetings to avoid holiday conflicts, or building automated notification systems that respect regional work-life boundaries. Developers can integrate this into larger workflows to trigger logic based on whether a date is a business day or a holiday.

Example Prompts

1. "Is March 19, 2026 a working day according to the Chinese calendar?"
2. "Update my holiday database now to make sure I have the latest schedule."
3. "Check if next Monday is considered a workday or if there's a makeup shift scheduled."

Tips & Limitations

The tool excels at precision but depends on the availability of the configured PRIMARY_URL or BACKUP_URL. If the remote ICS files are unreachable, the skill will fall back to a standard Monday-Friday work schedule, which may not account for last-minute administrative changes. Always ensure your config.json is correctly placed, as the skill performs an upward traversal to locate it. If you suspect the data is outdated, manually trigger the update script before performing critical date-based calculations.