taiwan-calendar

What This Skill Does

The taiwan-calendar skill provides a robust interface for interacting with Taiwan's government administrative calendar. It solves the common 'knowledge cutoff' issues inherent in AI agents by providing real-time access to accurate working day, national holiday, and make-up workday (補班日) data. By leveraging official Taiwan government open data APIs, the skill ensures that scheduling, deadline calculations, and holiday inquiries are precise and context-aware. It prevents errors regarding weekday identification and ensures that the agent is always aware of special calendar events unique to Taiwan.

Installation

To integrate this tool into your OpenClaw environment, execute the following command in your terminal:

clawhub install openclaw/skills/skills/pigfoot/taiwan-calendar

Ensure that you have uv installed, as the skill relies on the command uv run --managed-python scripts/taiwan_calendar.py for all operations. This dependency management ensures consistent execution across different environments.

Use Cases

This skill is indispensable for professionals working with Taiwan-based teams or operations. Use it for:

• Project Management: Calculating accurate delivery dates based on official working days rather than simple calendar dates.
• Operations: Confirming whether a specific date is a working day, a national holiday, or a make-up workday.
• General Scheduling: Quickly identifying the next upcoming public holiday for staff planning or checking if a meeting falls on a non-working day.
• Time-sensitive Planning: Determining exact deadlines when tasks are defined as a specific number of 'business days'.

Example Prompts

1. "我們的專案期限是五個工作天，從今天算起的話，截止日期是哪一天？"
2. "請問這個月有哪幾天是補班日？"
3. "我想安排下個月的會議，請問 10 月 10 日國慶日那天要上班嗎？"

Tips & Limitations

• Date Formats: The skill is flexible and supports YYYY-MM-DD, YYYY/MM/DD, and MM/DD formats. When using MM/DD, the skill defaults to the current year.
• Precision: Always prefer specific dates when querying for holiday lists, as the API performs real-time lookups to stay updated with administrative adjustments.
• Limitations: The skill depends on external government APIs. If the government server is temporarily unreachable, the skill may report a connectivity error. Ensure your network permits traffic to official government data endpoints.