A specialized tool for querying Chinese public holidays, make-up workdays (Tiao Xiu), and official work schedules via the timor.tech API.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install cn-holiday
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 cn-holiday 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 CN-Holiday?
CN-Holiday is a technical skill designed for AI agents within the Openclaw Skills ecosystem to accurately identify Chinese calendar statuses. It bridges the gap between standard Gregorian calendars and the unique Chinese holiday system, which includes complex make-up workday (Tiao Xiu) arrangements and varying overtime wage multipliers. By leveraging this skill, developers can automate schedule-aware tasks that respect regional labor laws and government-mandated breaks.
This skill operates as a script-first utility, providing programmatic access to the State Council's official announcements. It allows AI agents to determine if a specific date is a workday, a weekend, a holiday, or a make-up shift without requiring any complex API authentication, making it an essential component for regional productivity workflows.
CN-Holiday Use Cases
- Determining if today or a future date is an official workday or holiday in China.
- Calculating project deadlines while accounting for Chinese make-up workdays.
- Verifying overtime wage eligibility (double or triple pay) for specific holiday shifts.
- Automating batch reports for annual holiday arrangements and long-term scheduling.
- Identifying the next upcoming public holiday for travel or maintenance planning.
How CN-Holiday Works
- The AI agent parses the user's natural language intent to extract specific dates or holiday names (e.g., Spring Festival or National Day).
- The system maps the intent to one of the core commands: info, year, batch, or next.
- The skill executes a request to the timor.tech API to fetch the most recent data published by the State Council.
- The raw data, including status codes (0-3) and wage multipliers, is processed by the script.
- The AI interprets the technical response and presents a human-readable summary to the user.
CN-Holiday Setup
CN-Holiday is a script-first tool that does not require an MCP server or API keys. To set up this Openclaw Skills component, use the following steps:
# Navigate to the skill directory
cd skills/cn-holiday
# View available commands and usage
bun scripts/holiday.ts --help
Ensure you have the Bun runtime installed to execute the TypeScript scripts provided in the package.
CN-Holiday Data Schema & Taxonomy
The skill organizes its output based on the official Chinese labor and holiday classification system. The primary data points are organized as follows:
Type Classifications
| Value | Category | Description |
|---|---|---|
| 0 | Workday | Standard working day |
| 1 | Weekend | Normal Saturday or Sunday off |
| 2 | Holiday | Official public holiday day off |
| 3 | Make-up | Special workday replacing a holiday shift |
Wage Multipliers
- 1: Standard daily wage.
- 2: Double pay (typically for weekend-adjacent holidays).
- 3: Triple pay (statutory public holiday).
Holiday Metadata
- holiday: Boolean (true for day off, false for make-up workday).
- name: The name of the specific holiday (e.g., Mid-Autumn Festival).
CN-Holiday Advanced Features
- Multi-year support: Capability to query schedules for the current year and adjacent years.
- Batch processing: Efficiently check multiple dates in a single execution to optimize performance.
- Next-event triggers: Specialized 'next' command to find the nearest upcoming schedule change.
- Zero-config integration: No-API-key requirement allows for instant deployment within Openclaw Skills environments.
- Precise Wage Logic: Built-in mapping for triple-pay vs. double-pay statutory requirements.
SKILL.md
Loading
Related Openclaw Skills
Smart-Speak
A professional-grade text-to-speech engine designed to generate seamless multi-language audio with perfect Pinyin accuracy.
OpenClaw Session Viewer
A powerful utility that transforms raw OpenClaw JSONL session logs into a searchable, interactive HTML interface for deep conversation analysis.
PyThesisPlot
A specialized Python workflow designed to automate the transition from raw research data to publication-quality scientific visualizations.
FT Share A-Share Announcement Data
A specialized tool for retrieving and downloading A-share market announcements and analyst research reports for specific dates or stocks.
Tavily Search
A powerful search engine integration designed specifically for AI agents to retrieve real-time web data, news, and research context.
Logic — Think from Structure
A structural reasoning system that forces AI agents to reduce problems to their first principles before providing a response.
Featured*
