# Find Available YouBike Bicycles and Return Spaces

Finding a bicycle or an empty return space requires current station information. This skill guides public-feed queries for YouBike availability across Taiwan.

## Install

```bash
npx skillstore add tahodev/youbike-realtime
```

## Metadata

- Status: approved
- Slug: tahodev-youbike-realtime
- Skillstore revision: r1
- Version status: missing
- Tree hash: 990d9da132e0e283b20b5c414474cd4b2a705d0b9483b46737a5ea81cde859ba
- Author: tahodev
- GitHub username: tahodev
- License: MIT
- Repository: https://github.com/tahodev/baodao-skill/tree/3ce4b58e4525f5a66390e1236b6d38702790225a/youbike-realtime
- Ref: 2aab20a3878daa05021884e089a7dd7739e08581
- Supported tools: Claude, Codex, Claude Code
- Audit status: complete
- Agent install advisory: allowed
- Manual install advisory: allowed
- Artifact signature: available
- Audit attestation: unavailable
- Human verification: not\_verified
- Risk factors: external\_commands, network, filesystem
- Quality score: 77
- Quality tier: bronze
- Public page: https://skillstore.pages.dev/skills/tahodev-youbike-realtime
- Manifest: https://skillstore.pages.dev/api/skills/tahodev-youbike-realtime/manifest

## Capabilities

- Query the unified YouBike feed covering 14 documented service areas in Taiwan.
- Filter operating stations by service area, district, station name, bicycle availability, and return spaces.
- Identify stations with available electric bicycles using source-specific bicycle counts.
- Rank available stations approximately by proximity to supplied coordinates.
- Normalize Chinese station-name variants and combine Taipei and New Taipei municipal data.
- Use four municipal fallback feeds and report source update times in Taiwan local time.

## Use Cases

- Check Bicycles Before Commuting: Find operating stations near a district or landmark, compare bicycle counts, and confirm the data update time.
- Locate Electric Bicycles While Traveling: Find stations with electric bicycles in a supported service area and review available return spaces.
- Compare Cross-City Station Availability: Normalize Taipei and New Taipei feeds, compare station availability, and identify source failures or incomplete responses.

## Prompt Templates

### Check a District

```
Find operating YouBike stations in Taipei Daan District with bicycles available. Include return spaces and each source update time.
```

### Find Electric Bicycles

```
Find operating stations with electric bicycles in New Taipei Banqiao District. Show electric counts, return spaces, source, and update time.
```

### Rank Nearby Stations

```
Find five operating stations with bicycles nearest to latitude 25.033 and longitude 121.565. Include addresses and timestamps; label proximity ranking as approximate.
```

### Compare Fallback Feeds

```
Compare Taipei and New Taipei stations using municipal fallback feeds. Normalize fields, check pagination and freshness, and report failures without presenting stale data as live.
```

## Limitations

- Requires network access and a command-capable environment with curl and jq.
- The unified feed is undocumented, may change fields, and can block some source IP addresses.
- Municipal fallbacks cover only Taipei, New Taipei, Taichung, and Taoyuan; Taipei municipal data lacks electric-bicycle counts.
- Does not reserve bicycles, calculate fees, guarantee availability, or provide walking routes; proximity ranking is approximate.

## Best Practices

- Include the source update time in Taiwan local time and recheck availability before departure.
- Reuse a fresh response for one or two minutes and use private temporary storage for downloads.
- Validate response format, source-specific fields, operating status, and pagination before reporting availability.

## Anti Patterns

- Presenting stale, empty, or invalid feed responses as current station availability.
- Applying one city's field names or electric-bicycle parsing rules to every source.
- Polling continuously or treating approximate coordinate ranking as a walking route.

## Security Audit

- Audited at: 2026-10-13T04:29:33.994\+00:00
- Summary: Reviewed all 114 static findings: 109 are false positives from Markdown formatting, public-data URLs, read-only queries, and readable multilingual text. Five downloads use predictable shared temporary paths, allowing local symlink overwrite or cache tampering when another user controls those paths. No evidence found of prompt injection, credential access, or data exfiltration.

## Stats

- Views: 0
- Downloads: 0
- Favorites: 0
- Popularity score: 0