AI agent skill collection for daily life queries in Taiwan (Baodao = a beautiful name for Taiwan). Uses only official APIs and public datasets: Ministry of Finance e-Invoice Platform, Taipei City Data Platform, New Taipei City Open Data Platform, Taichung City Government Open Data Platform, Taoyuan City Government Open Data Platform, YouBike public data and official map real-time feed, Open-Meteo, Central Weather Administration Open Data Platform, and National Science and Technology Center for Disaster Reduction (NCDR CAP). The core consists of query-only skills that require no login or API key for safe use; a few skills (cwa-weather) use a free, instantly issued API key.
Works with coding agents that support npx skills add such as Claude Code, Codex, and OpenCode.
Installation
# Install all skills
npx --yes skills add tahodev/baodao-skill --all -g
# Install a specific skill only
npx --yes skills add tahodev/baodao-skill --skill invoice-winning-numbers -g
Requires Node.js 18+ and npx. See the installation guide for details.
Features
The "Login" column only indicates whether the user personally needs an account or key.
| Feature | Skill Name | Description | Login | Docs |
|---|---|---|---|---|
| Check uniform invoice winning numbers | invoice-winning-numbers | Latest winning numbers, batch matching, cloud-invoice exclusive prizes (PDF list), and historical period guidance | Not required | invoice-winning-numbers guide |
| Real-time YouBike station lookup | youbike-realtime | Real-time available bikes and return docks for YouBike 2.0 stations across 14 service areas nationwide (Taipei, New Taipei, Taoyuan, Taichung, Tainan, Kaohsiung, etc.), including e-bike filtering | Not required | youbike-realtime guide |
| Taipei/New Taipei garbage truck routes | taiwan-garbage | Collection stops and times for Taipei (CSV) + New Taipei (JSON API); New Taipei includes weekday schedules to check if pickup happens today | Not required | taiwan-garbage guide |
| Central Weather Administration weather forecast | cwa-weather | 36-hour county and township forecasts using the CWA open-data API (official source) | Required (free instant key) | cwa-weather guide |
| Taiwan weather lookup | taiwan-weather | Keyless weather via Open-Meteo, plus keyless disaster alerts (typhoon, earthquake, tsunami) from the NCDR CAP feeds (keyless fallback for cwa-weather) | Not required | taiwan-weather guide |
The canonical source for each skill is <skill-name>/SKILL.md. The docs/features/ guides are summaries; always refer to SKILL.md for detailed steps, parameters, and error handling.
Scope notes:
- Services with heavy anti-scraping (Shopee, momo, 591, foodpanda, etc.) are out of scope.
- Does not change external state: no reservations, purchases, or posts; only lookups and calculations.
- Data is quoted as-is from official sources. For important decisions (claim deadlines, collection holidays, typhoon warnings, etc.), always verify on the official website.
30-Day Plan
This repository grows at a pace of one skill per day. Below are candidate skills in no fixed order; completed items are checked:
- Public holidays and long weekend lookup (Executive Yuan Personnel Administration Office calendar)
- Central Weather Administration weather forecast (free API key) →
cwa-weather - Cloud invoice exclusive prize winning numbers →
invoice-winning-numbers(PDF list parsing, 2026-09-09) - Garbage trucks in other cities (New Taipei →
taiwan-garbagesupported; Taoyuan, Taichung, Tainan, Kaohsiung pending) - HSR timetable and fares (TDX, free API key)
- TRA timetable (TDX, free API key)
- Real-time bus arrival (TDX)
- Air Quality Index (AQI)
- Earthquake alerts and typhoon updates →
taiwan-weatherNCDR CAP section (2026-09-09) - Parking lot availability
- Postal code lookup
- Taiwan Power Company supply/demand info
- Fuel price lookup (CPC)
- Exchange rate lookup
- Work/school suspension announcements
- Agricultural product trading prices
- Individual income tax estimation
- Business registration and national ID validation
- Hospital and clinic lookup
- Public library catalog search
- Real-time expressway traffic
- UV index
- Water outage announcements
- Solar terms and lunar calendar conversion
- Labor and health insurance rate calculation
- Postage calculation
English
baodao-skill (寶島, "baodao" = treasure island, an affectionate name for Taiwan) is a collection of AI-agent skills for daily life in Taiwan. It focuses on read-only lookups built only on official APIs and public datasets: no login walls, no API keys, no scraping.
Works with any coding agent that supports npx skills add (Claude Code, Codex, OpenCode, ...).
Install
# Install every skill
npx --yes skills add tahodev/baodao-skill --all -g
# Install a single skill
npx --yes skills add tahodev/baodao-skill --skill invoice-winning-numbers -g
Node.js 18+ and npx are required. See the install guide for details.
What you can do
| What you can do | Skill | Description | Login | Docs |
|---|---|---|---|---|
| Check Taiwan uniform-invoice winning numbers | invoice-winning-numbers | Latest winning numbers, batch matching, cloud-invoice exclusive prizes (PDF lists), and history pointers from the Ministry of Finance's public pages | Not required | invoice-winning-numbers guide |
| Look up YouBike station availability | youbike-realtime | Real-time rentable bikes and return docks for YouBike 2.0 stations across 14 service areas nationwide (Taipei, New Taipei, Taoyuan, Taichung, Tainan, Kaohsiung, and more), incl. e-bike filtering | Not required | youbike-realtime guide |
| Look up garbage truck routes | taiwan-garbage | Collection stops and times for Taipei (CSV) and New Taipei (JSON API with weekday schedules) | Not required | taiwan-garbage guide |
| Look up official CWA forecasts | cwa-weather | 36-hour county and township forecasts from the CWA open-data API (official source) | Free instant API key | cwa-weather guide |
| Look up weather in Taiwan | taiwan-weather | Keyless Open-Meteo weather plus keyless disaster alerts (typhoon, earthquake, tsunami) via the NCDR CAP feeds (fallback for cwa-weather) | Not required | taiwan-weather guide |
The canonical source for each skill is its <skill>/SKILL.md. The guides under docs/features/ are summaries only - always refer to SKILL.md for full procedures, parameters, and error handling.
Scope notes:
- Services with heavy anti-scraping are out of scope.
- Nothing here changes state: no reservations, purchases, or posts. Lookups and calculations only.
- Data is quoted as-is from official sources. Confirm anything important (claim deadlines, collection holidays, typhoon warnings) on the official site.
This repo grows one skill per day - see the roadmap above.