holiday

Determine if today is a public holiday in mainland China via GET /api/holiday.

Updated Apr 12, 2025
One-click install
npx skills add https://github.com/DavidKk/vercel-openapi --skill holiday
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: holiday
Source: https://github.com/DavidKk/vercel-openapi/tree/main/app/holiday
Command: npx skills add https://github.com/DavidKk/vercel-openapi --skill holiday

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill determines whether today is a public holiday in mainland China and provides the holiday name when applicable.

Core Features & Use Cases

  • Today-only holiday lookup for mainland China, returning a holiday status and name.
  • Agent-ready responses in the user’s language, with concise holiday information.
  • Use case: When a user asks “今天是不是放假?”, respond with a simple yes/no and the holiday name if available.

Quick Start

Ask the agent to call GET /api/holiday to retrieve today’s public-holiday status for mainland China.

Frequently Asked Questions about holiday

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

FAQPage Schema
How do I check if today is a public holiday in China via an API?▼

To check the China public holiday status, send a GET request to the /api/holiday endpoint. The API returns a JSON response containing the isHoliday boolean and the holiday name if applicable.

What information does the China holiday API return for today's date?▼

The holiday API returns a JSON envelope with an isHoliday field indicating today's holiday status. If today is a public holiday in mainland China, a name field provides the specific holiday name.

Can I use this holiday status API to automate chat assistant responses?▼

Yes, the holiday status API targets chat assistants and automation workflows. It provides clear language responses with today-only holiday information, allowing agents to answer user queries like whether today is a holiday.

Does the holiday API return dates beyond today's public holiday status?▼

No, the holiday API returns today-only holiday lookup information for mainland China. It determines whether the current date is a public holiday and returns the name, but does not provide future or past date queries.

What is the best way to get the mainland China public holiday name for today?▼

The best way to retrieve the mainland China public holiday name is calling the GET /api/holiday endpoint. It evaluates today's date and returns the specific holiday name alongside the isHoliday status in JSON format.

Are there limitations when using this API for Chinese holiday detection?▼

A key limitation is that the API provides today-only holiday detection for mainland China. It includes straightforward error handling but does not support querying arbitrary dates or regions outside of mainland China.