← Back to Skills Marketplace
pigfoot

Taiwan Calendar Plugin

by pigfoot · GitHub ↗ · v0.0.1
cross-platform ✓ Security Clean
1048
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install taiwan-calendar
Description
Taiwan calendar query for accurate working day/holiday information. Use when user asks about Taiwan dates, working days, holidays, make-up workdays, or needs date calculations. Solves Claude's knowledge cutoff issues with Taiwan's administrative calendar.
Usage Guidance
This skill appears to do what it claims: query public Taiwan calendar APIs and compute working-day math. Before installing, consider: 1) Network access — the script makes outbound HTTPS requests to data.gov.tw, data.ntpc.gov.tw and a jsdelivr (GitHub CDN) URL; if your environment restricts network egress or you distrust third-party CDNs, review or host the source data yourself. 2) SSL handling — the code contains logic that may disable SSL verification for some endpoints (which increases MITM risk); if you are concerned, inspect and modify the script to enforce verify=True. 3) Local cache — the script writes a small JSON cache to the system temp directory (no secrets expected), so ensure that is acceptable. 4) Autonomy — the skill runs a shell command when used; only enable it if you trust the author or have reviewed the included script. If you want extra assurance, run the script locally and inspect network requests it makes before enabling the plugin for autonomous use.
Capability Analysis
Type: OpenClaw Skill Name: taiwan-calendar Version: 0.0.1 The skill bundle is benign. It provides Taiwan calendar information by querying government open data APIs. The `SKILL.md` correctly defines the `Bash` tool usage to execute the Python script with specific arguments, preventing arbitrary shell command injection from user input. The `scripts/taiwan_calendar.py` fetches data from legitimate government sources (cdn.jsdelivr.net/gh/ruyut/TaiwanCalendar, data.ntpc.gov.tw) and caches it in the system's temporary directory. While the script uses `verify=False` for one API source, which is a minor security vulnerability (MITM risk for that specific API call), it is a common workaround for problematic public APIs and does not indicate malicious intent. There is no evidence of data exfiltration, persistence mechanisms, or prompt injection attempts designed to mislead the agent into performing unauthorized actions.
Capability Assessment
Purpose & Capability
Name, description, CLI usage, and included Python script all align: the script fetches Taiwan calendar data from public open-data endpoints, performs date arithmetic, and caches results. No unrelated credentials, binaries, or system-wide config access are requested.
Instruction Scope
SKILL.md instructs the agent to run the included script via a managed Python runner. The runtime behavior is limited to HTTP queries to public APIs, local caching in the system temp directory, timezone handling, and printing results. The instructions do not ask the agent to read arbitrary user files, environment secrets, or to transmit data to unknown third-party endpoints beyond the declared data sources.
Install Mechanism
There is no install spec (instruction-only plus an included script), so nothing is written to disk by an installer. Dependencies are standard Python packages (requests, python-dateutil) and are expected for HTTP + date parsing. One data source uses a CDN (jsdelivr/GitHub CDN) which is a third-party host rather than a government domain — this is reasonable for static JSON but worth noting.
Credentials
The skill declares no required environment variables or credentials and the code does not require secrets. It only needs network access to public APIs and permission to write a small cache file in the system temp directory.
Persistence & Privilege
The skill is not marked always:true and is user-invocable only. It writes a temporary cache file (taiwan-calendar-cache.json) to the system temp directory and does not modify other skills or global agent configuration. Note: the agent will execute the script (via Bash/uv run) when invoked or if autonomously selected — autonomous invocation is the platform default.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install taiwan-calendar
  3. After installation, invoke the skill by name or use /taiwan-calendar
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.0.1
Taiwan Calendar Skill v0.0.1 — Initial release - Provides real-time, accurate Taiwan working day and holiday information by querying government open data APIs. - Supports commands for checking today’s date/status, verifying if a specific date is a working day or holiday, counting working days in a range, date calculations (add working days), and finding next holidays or working days. - Handles special cases like make-up workdays (補班日) and public holidays per the official administrative calendar. - Uses caching for efficiency and reliability, with fallback to secondary API and expired cache on network failure. - All outputs reflect Taiwan's time zone (Asia/Taipei) and are returned in Traditional Chinese. - Detailed examples and troubleshooting guidance included for users and developers.
Metadata
Slug taiwan-calendar
Version 0.0.1
License
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Taiwan Calendar Plugin?

Taiwan calendar query for accurate working day/holiday information. Use when user asks about Taiwan dates, working days, holidays, make-up workdays, or needs date calculations. Solves Claude's knowledge cutoff issues with Taiwan's administrative calendar. It is an AI Agent Skill for Claude Code / OpenClaw, with 1048 downloads so far.

How do I install Taiwan Calendar Plugin?

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

Is Taiwan Calendar Plugin free?

Yes, Taiwan Calendar Plugin is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Taiwan Calendar Plugin support?

Taiwan Calendar Plugin is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Taiwan Calendar Plugin?

It is built and maintained by pigfoot (@pigfoot); the current version is v0.0.1.

💬 Comments