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.