# Find Taiwan Postal Codes and English Address Names

Taiwan postal prefixes and English address names can be difficult to match across official tables. This skill guides lookups using public Chunghwa Post datasets.

## Install

```bash
npx skillstore add tahodev/postal-address
```

## Metadata

- Status: approved
- Slug: tahodev-postal-address
- Skillstore revision: r1
- Version status: missing
- Tree hash: b52d82d1d34901ccdf3fb04bae850e5f0ce50e6e2c4aa0580dc2ddb1b2f2c1f7
- Author: tahodev
- GitHub username: tahodev
- License: MIT
- Repository: https://github.com/tahodev/baodao-skill/tree/3ce4b58e4525f5a66390e1236b6d38702790225a/postal-address
- 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-postal-address
- Manifest: https://skillstore.pages.dev/api/skills/tahodev-postal-address/manifest

## Capabilities

- Look up three-digit postal code prefixes for Taiwan cities, townships, and districts.
- Find official English names for counties, cities, and townships in the public XML table.
- Look up village, named lane, road, and street translations in public text tables.
- Guide English address assembly from smaller address components to larger administrative areas.
- Explain Big5 text conversion and direct reading of UTF-8 XML files.
- Identify ambiguous road names and refer unsupported lookups to official postal resources.

## Use Cases

- Prepare an English mailing address: Find official English address components and a three-digit postal prefix before completing an international mailing label.
- Check customer address names: Compare road and district names with postal tables, and identify addresses requiring clarification or a six-digit lookup.
- Review address data mappings: Inspect county, village, and road translation datasets while accounting for encoding differences and duplicate names.

## Prompt Templates

### Find a postal prefix

```
Find the three-digit postal code for [city] and [district] in Taiwan. State the table date and any uncertainty.
```

### Translate a road name

```
Find the official English name for [Chinese road name] in [city and district]. Flag duplicate entries and missing matches.
```

### Assemble an English address

```
Convert [Taiwan address] using official county, village, and road tables. Preserve supplied numbers, identify missing components, and never invent six-digit codes.
```

### Review a dataset workflow

```
Plan lookups for [address list] using official tables. Use private temporary storage, verify downloads, convert Big5 text, and flag ambiguous names.
```

## Limitations

- Full six-digit delivery codes are outside scope; use the official postal query service.
- The three-digit table is dated 2014; administrative boundary changes require official confirmation.
- Translations use Hanyu Pinyin, not passport-specific or custom romanization.
- Lookups require network access and local command-line tools; duplicate names and changing download filenames can prevent definitive matches.

## Best Practices

- Provide the city and district alongside the road or village name to resolve duplicate names.
- Use a private temporary directory and verify download success before processing any table.
- Convert Big5 text to UTF-8, leave UTF-8 XML unchanged, and confirm boundary-sensitive codes through official queries.

## Anti Patterns

- Guessing the final three digits of a six-digit delivery code.
- Treating a road-name match without city context as a unique address.
- Substituting invented translations when the official tables contain no match.

## Security Audit

- Audited at: 2026-10-13T02:58:31.513\+00:00
- Summary: Four predictable temporary-file writes create overwrite and local symlink risks. Other alerts concern Markdown syntax, public postal downloads, extension descriptions, and expected data reads. No evidence found of prompt injection, credential access, or data exfiltration.

## Stats

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