Taiwan Md Knowledge Base
Contribute bilingual Taiwan articles and knowledge-graph nodes to the open Taiwan.md Astro site using its Markdown SSOT workflow.
Overview
Taiwan MD Knowledge Base is an agent skill for the Build phase that teaches how to add bilingual articles, categories, and graph nodes to the Taiwan.md Astro knowledge base.
Install
npx skills add https://github.com/aradotso/trending-skills --skill taiwan-md-knowledge-baseWhat is this skill?
- SSOT architecture: all articles live under `knowledge/` as Markdown; site is a build-time projection
- Bilingual workflow with Traditional Chinese default plus English translation paths
- Interactive D3.js knowledge graph with node creation guidance
- 96+ curated articles across 12 categories in the upstream project
- Local dev via `npm run dev`, build/preview, and `scripts/sync.sh` to copy knowledge into content collections
- 96+ curated articles across 12 categories (upstream project)
- Astro v5 stack with D3.js knowledge graph
Adoption & trust: 1.2k installs on skills.sh; 31 GitHub stars; 2/3 security scanners passed (skills.sh audits).
What problem does it solve?
You want to contribute to Taiwan.md but do not know the SSOT folder layout, sync script, or bilingual and knowledge-graph conventions.
Who is it for?
Solo contributors and indie publishers maintaining structured, bilingual reference sites on the Taiwan.md stack.
Skip if: Builders who need a generic CMS skill with no Astro, or products unrelated to the Taiwan.md repository layout.
When should I use this skill?
User asks to add content to taiwan.md, contribute articles, translate, add categories, create graph nodes, or set up the repo locally.
What do I get? / Deliverables
You can run the site locally, add or translate Markdown in `knowledge/`, sync to content collections, and align new nodes with the D3 graph structure.
- New or updated Markdown articles under knowledge/
- Synced content collections ready for build
Recommended Skills
Journey fit
Canonical placement is build/docs because the skill governs content structure, sync scripts, and site contribution—not distribution or validation of a product idea. Taiwan.md is a docs-and-content codebase with Astro v5 and D3 graph projection from `knowledge/` Markdown.
How it compares
Repo-specific documentation workflow—not a general SEO or landing-page validator.
Common Questions / FAQ
Who is taiwan-md-knowledge-base for?
Developers and editors contributing to the Taiwan.md open knowledge base who work in Markdown, Astro v5, and optional English/zh-TW pairs.
When should I use taiwan-md-knowledge-base?
Use during build/docs when adding Taiwan articles, new categories, translations, knowledge graph nodes, or first-time local setup for taiwan-md.
Is taiwan-md-knowledge-base safe to install?
The skill describes standard npm dev and bash sync commands; review the Security Audits panel on this page before running scripts in your environment.
SKILL.md
READMESKILL.md - Taiwan Md Knowledge Base
# Taiwan.md Knowledge Base > Skill by [ara.so](https://ara.so) — Daily 2026 Skills collection. Taiwan.md is an open-source, AI-native knowledge base about Taiwan built with Astro v5. It uses a Single Source of Truth (SSOT) architecture where all content lives in the `knowledge/` directory as Markdown files, and the website is a build-time projection. Features include bilingual support (Traditional Chinese as default + English), an interactive D3.js knowledge graph, and 96+ curated articles across 12 categories. --- ## Installation & Setup ### Prerequisites - Node.js 18+ - npm or pnpm ### Clone and Install ```bash git clone https://github.com/frank890417/taiwan-md.git cd taiwan-md npm install ``` ### Development Server ```bash npm run dev # Site available at http://localhost:4321 ``` ### Build & Preview ```bash npm run build npm run preview ``` ### Sync Knowledge to Content ```bash bash scripts/sync.sh # Copies knowledge/ → src/content/ for Astro build ``` --- ## Project Architecture ``` taiwan-md/ ├── knowledge/ ← SSOT: ALL content lives here │ ├── History/ ← Chinese articles + _Hub.md │ ├── Geography/ │ ├── Culture/ │ ├── Food/ │ ├── Art/ │ ├── Music/ │ ├── Technology/ │ ├── Nature/ │ ├── People/ │ ├── Society/ │ ├── Economy/ │ ├── Lifestyle/ │ ├── About/ ← Meta content │ └── en/ ← English translations (mirrors zh-TW) │ ├── History/ │ ├── Geography/ │ └── ... ├── scripts/ │ └── sync.sh ← Syncs knowledge/ → src/content/ ├── src/ │ ├── pages/ ← Astro pages │ ├── layouts/ ← Shared layouts │ └── content/ ← Build-time projection (DO NOT EDIT) ├── public/ │ └── images/wiki/ ← Cached Wikimedia Commons images └── docs/ ← Architecture & roadmap docs ``` **Critical rule:** Never edit files in `src/content/` directly. Always edit `knowledge/` and run `scripts/sync.sh`. --- ## Content Structure ### The 12 Categories | Slug | Chinese | English | |------|---------|---------| | `history` | 歷史 | History | | `geography` | 地理 | Geography | | `culture` | 文化 | Culture | | `food` | 美食 | Food | | `art` | 藝術 | Art | | `music` | 音樂 | Music | | `technology` | 科技 | Technology | | `nature` | 自然 | Nature | | `people` | 人物 | People | | `society` | 社會 | Society | | `economy` | 經濟 | Economy | | `lifestyle` | 生活 | Lifestyle | ### Article File Naming ``` knowledge/ ├── Food/ │ ├── _Hub.md ← Category hub page (literary overview) │ ├── bubble-tea.md ← Individual article (zh-TW) │ └── beef-noodle.md └── en/ └── Food/ ├── _Hub.md ← English hub page ├── bubble-tea.md ← English translation └── beef-noodle.md ``` --- ## Writing Articles ### Chinese Article Template (`knowledge/[Category]/article-slug.md`) ```markdown --- title: 珍珠奶茶 description: 台灣最具代表性的飲料文化，從夜市攤車到全球連鎖，珍珠奶茶如何征服世界。 category: food date: 2024-01-15 tags: [飲食文化, 台灣之光, 夜市] image: /images/wiki/bubble-tea-abc123.jpg imageCaption: 台灣珍珠奶茶 | Wikimedia Commons | CC BY-SA 4.0 sources: - title: 珍珠奶茶的起源考證 url: https://example.com/boba-origin - title: 台灣飲料市場報告 url: https://example.com/beverage-report --- ## 30 秒認識 珍珠奶茶（波霸奶茶）誕生於 1980 年代台灣，現已成為全球年產值超過 30 億美元的飲料產業。 ## 深度閱讀 ### 起源爭議 台南翰林茶館與台中春水堂都聲稱是珍珠奶茶的發明者... ### 全球擴張 2010 年代，珍珠奶茶席捲歐美亞各大城市... ## 為什麼重要 珍珠奶茶不只是一杯飲料，它是台灣軟實力的最佳代言人——在沒有邦交的地方，台灣