holiday-checker

Check dates for holiday, workday, or weekend status via API.

Updated May 1, 2026
One-click install
npx skills add https://github.com/xiaoquqi/hermes-agent-skills --skill holiday-checker
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: holiday-checker
Source: https://github.com/xiaoquqi/hermes-agent-skills/tree/main/devops/holiday-checker
Command: npx skills add https://github.com/xiaoquqi/hermes-agent-skills --skill holiday-checker

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill helps users determine whether a specific date is a holiday, a working day, or a weekend by querying a curated public API and interpreting the result.

Core Features & Use Cases

  • Date lookup: Check the holiday status, type (holiday/workday) and related details for any date.
  • Next/Previous workday calculation: Find the nearest upcoming or previous workday for planning.
  • Automation-ready: Integrates with scripts to drive scheduling, reporting, and date-based workflows.

Quick Start

To check if a date is a holiday or workday, run the holiday-checker script with a date argument.

Frequently Asked Questions about holiday-checker

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check if a specific date is a Chinese holiday or workday?

To check if a specific date is a Chinese holiday or workday, you can run the holiday-checker script with a date argument. It queries an aggregated holiday API to resolve the date status.

How do I calculate the next or previous workday for date planning?

You can calculate the next or previous workday for date planning by using the holiday-checker script. It computes the nearest upcoming or previous workday by checking holiday and weekend data.

Do I need an API key to query the Chinese holiday calendar?

Yes, you need a JUHE_HOLIDAY_KEY environment variable to query the Chinese holiday calendar. You can configure this API key directly in your environment or store it in a .hermes/.env file.

Can I get lunar calendar details and Yi/Ji information for a holiday?

Yes, you can get lunar calendar details and Yi/Ji information by enabling the detailed mode in the holiday-checker script. This mode includes extra lunar data alongside the standard workday or holiday status.

How does the date lookup handle API errors and rate limits?

The date lookup handles API errors and rate limits using simple local caching combined with error handling mechanisms. This ensures reliable holiday status resolution even during temporary API connectivity issues.

How can I automate workday scheduling and reporting workflows?

You can automate workday scheduling and reporting workflows by integrating the holiday-checker script into your automation pipelines. It resolves workday and holiday statuses to drive date-based logic and reporting triggers.