Taiwan-md taiwanmd-search

install

source · Clone the upstream repo

git clone https://github.com/frank890417/taiwan-md

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/frank890417/taiwan-md "$T" && mkdir -p ~/.claude/skills && cp -r "$T/.claude/skills/taiwanmd-search" ~/.claude/skills/frank890417-taiwan-md-taiwanmd-search && rm -rf "$T"

manifest: .claude/skills/taiwanmd-search/SKILL.md

source content

taiwanmd-search: Search Taiwan.md Knowledge Base

Search 900+ curated articles about Taiwan across 13 categories: history, geography, culture, food, art, music, technology, nature, people, society, economy, lifestyle, about.

How to search

Quick search (via CLI)

cd "$(git rev-parse --show-toplevel)" && node cli/src/index.js search "<QUERY>" --limit 5

Replace

<QUERY>

with the user's search terms. Works with Chinese and English.

JSON output (for programmatic use)

cd "$(git rev-parse --show-toplevel)" && node cli/src/index.js search "<QUERY>" --json --limit 5

Read a specific article after searching

cd "$(git rev-parse --show-toplevel)" && node cli/src/index.js read "<SLUG>" --raw

The

--raw

flag outputs clean markdown, ideal for injecting into conversation context.

When to use

User asks about Taiwan — search for relevant articles, read the top match, use it to inform your answer
User is writing Taiwan-related content — search for reference articles to ensure accuracy
User references a specific topic (e.g., "珍珠奶茶", "TSMC", "228 incident") — find the authoritative article
User wants to explore — use
```
random
```
or
```
list
```
commands

Available commands

Command	Description
`search <query>`	Fuzzy search (中英雙語)
`read <slug>`	Read full article (--raw for plain markdown)
`list [category]`	List articles by category
`list --categories`	Show all 13 categories with counts
`random`	Random article discovery
`stats`	Project statistics + organism health

Example workflow

# 1. Search for relevant articles
node cli/src/index.js search "半導體" --json --limit 3

# 2. Read the most relevant one
node cli/src/index.js read "半導體產業" --raw

# 3. Use the content to answer the user's question

Notes

The knowledge base is in
```
knowledge/
```
(SSOT) — always prefer reading from there
Articles are in Traditional Chinese (zh-TW) as the source of truth
English translations are in
```
knowledge/en/
```
Each article has structured YAML frontmatter with title, description, date, tags