Conjunto de habilidades de agente de IA para consultas de la vida diaria en Taiwán (寶島 = "isla del tesoro", un apodo cariñoso para Taiwán). Utiliza exclusivamente API oficiales y datos abiertos: Plataforma de Servicios de Factura Electrónica del Ministerio de Finanzas, Plataforma Abierta de Datos de la Ciudad de Taipéi, Plataforma Abierta de Datos de Nuevo Taipéi, Plataforma Abierta de Datos del Gobierno de Taichung, Plataforma Abierta de Datos del Gobierno de Taoyuan, datos públicos de YouBike y feeds oficiales de mapas en tiempo real, Open-Meteo, Plataforma Abierta de Datos de la Agencia Meteorológica Central (CWA) y el Centro Nacional de Ciencia y Tecnología para la Reducción de Desastres (NCDR CAP). Se centra en habilidades de consulta seguras que no requieren inicio de sesión ni claves API; solo una habilidad (cwa-weather) utiliza una clave API gratuita emitida al instante.
Funciona con cualquier agente de codificación que admita npx skills add, como Claude Code, Codex, OpenCode, etc.
Instalación
# Instalar todas las habilidades
npx --yes skills add tahodev/baodao-skill --all -g
# Instalar una habilidad específica
npx --yes skills add tahodev/baodao-skill --skill invoice-winning-numbers -g
Se requiere Node.js 18 o superior y npx. Consulta la guía de instalación para más detalles.
Funcionalidades
La columna "Inicio de sesión" indica si el usuario necesita una cuenta o clave.
| Función | Nombre de la habilidad | Descripción | Inicio de sesión | Documentación |
|---|---|---|---|---|
| Verificar números ganadores de facturas unificadas | invoice-winning-numbers | Últimos números ganadores, verificación por lotes, premios exclusivos de facturas en la nube (listas PDF) e indicaciones de períodos anteriores | No requerido | Guía de invoice-winning-numbers |
| Consulta en tiempo real de estaciones YouBike | youbike-realtime | Bicicletas disponibles y espacios de estacionamiento libres en tiempo real para estaciones YouBike 2.0 en las 14 áreas de servicio (Taipéi, Nuevo Taipéi, Taoyuan, Taichung, Tainan, Kaohsiung, etc.), incluyendo filtro por bicicletas eléctricas | No requerido | Guía de youbike-realtime |
| Rutas de camiones de basura en Taipéi y Nuevo Taipéi | taiwan-garbage | Puntos de recolección y horarios de la ciudad de Taipéi (CSV) y Nuevo Taipéi (API JSON con horarios semanales), que permite saber si hay recolección hoy | No requerido | Guía de taiwan-garbage |
| Pronóstico meteorológico oficial de CWA | cwa-weather | Pronósticos a 36 horas para condados y municipios usando la API de datos abiertos de la Agencia Meteorológica Central (fuente oficial) | Requerido (clave gratuita emitida al instante) | Guía de cwa-weather |
| Consulta del clima en Taiwán | taiwan-weather | Clima de Open-Meteo (sin clave) y alertas de desastres (tifón, terremoto, tsunami) a través de los feeds NCDR CAP (sin clave) — alternativa sin clave para cwa-weather | No requerido | Guía de taiwan-weather |
La fuente canónica de cada habilidad es <nombre-de-habilidad>/SKILL.md. Las guías en docs/features/ son resúmenes; para procedimientos detallados, parámetros y manejo de errores, consulta siempre el SKILL.md.
Límites del alcance:
- Servicios con sistemas anti-scraping estrictos (Shopee, momo, 591, foodpanda, etc.) no están incluidos.
- No se modifica el estado externo: no se realizan reservas, compras ni publicaciones, solo consultas y cálculos.
- Los datos se presentan tal como los publican las fuentes oficiales. Cualquier decisión importante (plazos de reclamo, días sin recolección, alertas de tifón, etc.) debe verificarse en el sitio web oficial.
Plan de 30 días
Este repositorio crece al ritmo de "una habilidad por día". A continuación, las habilidades candidatas (pendientes de priorizar; se marcarán al completarse):
- Consulta de días festivos nacionales y fines de semana largos (calendario laboral de la Dirección General de Personal Administrativo)
- Pronóstico meteorológico de la Agencia Meteorológica Central (clave API gratuita) →
cwa-weather - Números ganadores de facturas electrónicas en la nube →
invoice-winning-numbers(análisis de lista PDF, 2026-09-09) - Camiones de basura de otros condados (Nuevo Taipéi ya compatible en
taiwan-garbage; pendientes: Taoyuan, Taichung, Tainan, Kaohsiung) - Horarios y tarifas del tren de alta velocidad (THSR) — TDX, clave API gratuita
- Horarios del tren convencional (TRA) — TDX, clave API gratuita
- Consulta dinámica de autobuses — TDX
- Índice de calidad del aire (AQI)
- Alertas de terremoto y seguimiento de tifones → sección NCDR CAP de
taiwan-weather(2026-09-09) - Disponibilidad de espacios de estacionamiento
- Consulta de códigos postales
- Información de oferta y demanda eléctrica de Taipower
- Consulta de precios de combustibles (CPC)
- Consulta de tipos de cambio
- Avisos de suspensión de trabajo y clases
- Cotizaciones de productos agrícolas
- Cálculo del impuesto sobre la renta
- Verificación de números de identificación fiscal y números de identidad
- Consulta de hospitales y clínicas
- Consulta de catálogos de bibliotecas públicas
- Estado del tráfico en autopistas nacionales
- Índice de radiación ultravioleta
- Avisos de corte de agua
- Conversión de términos solares y calendario lunar
- Cálculo de tarifas de seguro social y salud
- Cálculo de tarifas postales
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.