← Back to Skills Marketplace
deusyu

cn-holiday

by Rainman · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ⚠ suspicious
261
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install cn-holiday
Description
中国节假日/调休查询 — 查某天是工作日还是休息日、是否调休补班、全年假期安排。 触发词: 节假日, 调休, 补班, 放假, 上班, holiday, workday, 今天上班吗, 明天放假吗, 春节放几天, 国庆放假, 下个工作日, 或任何 "[日期] 是否放假/上班" 格式的输入。
README (SKILL.md)

cn-holiday — Chinese Holiday & Work Schedule Skill

Query Chinese public holidays, 调休 (make-up workdays), and work schedules via the timor.tech API.

Quick Start

  1. No API key needed.
  2. Run bun scripts/holiday.ts --help in this skill directory.
  3. Pick the matching command from references/command-map.md.

Workflow

  1. Parse user intent — identify the date(s) and what they want to know.
  2. Select the right command: info, year, batch, or next.
  3. Run the script and return the result.
  4. Interpret the result for the user in natural language.

Response Interpretation

type.type field meanings

Value Meaning
0 工作日 (workday)
1 周末 (weekend)
2 节日 (holiday)
3 调休补班 (make-up workday)

wage field meanings (加班工资倍率)

Value Meaning
1 正常工资
2 双倍工资
3 三倍工资

holiday.holiday field

  • true = 放假 (day off)
  • false = 补班 (make-up workday)

Notes

  • This skill is script-first and does not run an MCP server.
  • Data source: timor.tech (based on State Council holiday announcements).
  • No API key required.
  • Covers current year and adjacent years' holiday schedules.
Usage Guidance
This skill appears to do what it says (query timor.tech for Chinese holiday info) and does not request secrets, but note the following before installing: (1) The SKILL.md tells you to run 'bun scripts/holiday.ts' but the metadata does not list bun or any runtime as a required binary — ensure you trust the included scripts and have a suitable runtime (bun/node) if you intend to execute them. (2) The skill will make outbound HTTPS requests to https://timor.tech and will send the dates/parameters you ask about — consider privacy implications of those queries. (3) Because the package includes runnable code, inspect the scripts locally before use (they appear benign and only call the holiday API, but you should verify there are no modifications you don't expect). (4) If you need stricter guarantees, ask the maintainer for a declared runtime requirement and an explicit install spec or run the scripts in an isolated environment.
Capability Analysis
Type: OpenClaw Skill Name: cn-holiday Version: 1.0.0 The skill is a legitimate utility for querying Chinese public holidays and work schedules via the timor.tech API. The code follows standard CLI patterns, includes robust input validation for dates and years (scripts/lib/validators.ts), and contains no evidence of data exfiltration, malicious execution, or prompt injection.
Capability Assessment
Purpose & Capability
The name/description match the code: the scripts call the timor.tech holiday API and implement the documented commands. However SKILL.md tells users to run 'bun scripts/holiday.ts' while the skill metadata lists no required binary/runtime; that is an inconsistency (the skill actually needs a JS runtime like bun). Otherwise there are no unexpected capabilities (no cloud credentials, no system-wide access).
Instruction Scope
Runtime instructions and the included code stick to the stated purpose: parsing dates/commands, validating inputs, and issuing HTTPS GET requests to https://timor.tech/api/holiday. The instructions do not request unrelated files, additional environment variables, or exfiltrate arbitrary data beyond the query parameters (dates/type).
Install Mechanism
There is no install spec (no packages downloaded or installed), which reduces risk, but the bundle includes TypeScript scripts (scripts/*.ts) and expects them to be executed. The absence of a declared required binary/runtime (bun) and an install step is an implementation gap the user should notice.
Credentials
The skill does not request environment variables, credentials, or config paths. The code sends no secret or token; it only issues unauthenticated GET requests to timor.tech. The requested environment access is proportionate to the task.
Persistence & Privilege
always: false and the skill does not attempt to modify other skills or system-wide agent configuration. It has no installation hook or autorun privilege in the metadata.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install cn-holiday
  3. After installation, invoke the skill by name or use /cn-holiday
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release
Metadata
Slug cn-holiday
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is cn-holiday?

中国节假日/调休查询 — 查某天是工作日还是休息日、是否调休补班、全年假期安排。 触发词: 节假日, 调休, 补班, 放假, 上班, holiday, workday, 今天上班吗, 明天放假吗, 春节放几天, 国庆放假, 下个工作日, 或任何 "[日期] 是否放假/上班" 格式的输入。 It is an AI Agent Skill for Claude Code / OpenClaw, with 261 downloads so far.

How do I install cn-holiday?

Run "/install cn-holiday" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is cn-holiday free?

Yes, cn-holiday is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does cn-holiday support?

cn-holiday is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created cn-holiday?

It is built and maintained by Rainman (@deusyu); the current version is v1.0.0.

💬 Comments