A specialized Python utility that identifies Mainland China workdays and public holidays by applying official makeup-workday rules.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install check-workday-cn
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install check-workday-cn using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Check Workday CN?
The Check Workday CN skill provides AI agents with the logic required to navigate the complex holiday system of mainland China. Unlike standard Western calendars, China utilizes a makeup-workday (tiaoxiu) system where weekends are often swapped for workdays to create longer holiday breaks. This Openclaw Skills integration solves the problem of inaccurate scheduling by fetching real-time yearly data from reliable holiday repositories.
By using this skill, developers can build agents that understand exactly when a user should be at work or on vacation. It moves beyond simple weekday/weekend checks to incorporate official government-mandated overrides, ensuring that automated reminders, task executions, and business logic remain synchronized with the local labor calendar.
Check Workday CN Use Cases
- Validating if a specific date in mainland China is a business day or a public holiday.
- Triggering automated workflows only on official workdays to avoid off-hour notifications.
- Building customer service bots that can answer user queries regarding holiday work schedules.
- Synchronizing project management deadlines with the specific Chinese holiday calendar.
How Check Workday CN Works
- The script identifies the target date, either via user input or by defaulting to the current date in the Asia/Shanghai timezone.
- It programmatically fetches the official yearly JSON data from the holiday-cn repository via the jsDelivr CDN.
- The skill checks if the target date is explicitly defined in the data as an off-day or a makeup-workday.
- If the date is not found in the override list, it falls back to standard weekday rules (Monday through Friday as workdays).
- It returns a structured response including the workday boolean status and the logic used for the determination.
Check Workday CN Setup
To implement this within your Openclaw Skills environment, ensure you have a Python 3 environment ready. The script is self-contained and communicates with the holiday-cn API.
# Check if today is a workday
python3 scripts/check_today_workday.py
# Validate a specific future date
python3 scripts/check_today_workday.py --date 2026-02-15
# Output as JSON for agent consumption
python3 scripts/check_today_workday.py --json
Check Workday CN Data Schema & Taxonomy
The skill provides a clear contract for data output, ensuring compatibility with other automation tools.
| Attribute | Type | Description |
|---|---|---|
| date | String | The queried date in YYYY-MM-DD format |
| is_workday | Boolean | True if it is a working day, false if it is an off-day |
| reason | String | Indicates if the result came from a holiday override or weekday fallback |
| data_source | String | The URL of the specific JSON data used for the check |
Check Workday CN Advanced Features
- Support for historical and future date validation based on available data files.
- Machine-readable JSON output flag for easy integration into multi-agent Openclaw Skills workflows.
- Accurate timezone handling for Asia/Shanghai to prevent date-drift errors.
- Dynamic data fetching to ensure the latest official holiday announcements are respected.
SKILL.md
Loading
Related Openclaw Skills
Web Search
A powerful search and crawling skill that enables AI agents to access real-time internet data from multiple search engines without requiring API keys.
Skill Sharpener
Skill Sharpener is a quality assurance auditor designed to evaluate, diagnose, and optimize Openclaw Skills for maximum performance and reliability.
Seedream5 Image Generation
A powerful AI image generation skill leveraging Volcengine Seedream 5.0 for high-resolution visual creation and editing.
OpenRouter Rankings Tracker
An automated utility to fetch, track, and report OpenRouter AI model rankings, token usage trends, and market share distribution.
Video Downloader
A versatile tool for AI agents to download and merge high-quality videos from major platforms using yt-dlp.
Signup Flow CRO
An expert AI agent skill designed to audit and optimize signup, registration, and trial activation flows to maximize user conversion and reduce friction.
Featured*
