taiwan-md-knowledge-base

What This Skill Does

The taiwan-md-knowledge-base skill serves as an interface for interacting with and managing the Taiwan.md knowledge repository. Built on an Astro v5 architecture, this skill allows users to query, navigate, and maintain a high-quality, bilingual (Traditional Chinese/English) dataset about Taiwan. It leverages a Single Source of Truth (SSOT) pattern where markdown files in the knowledge/ directory act as the primary content hub, which is then projected into the build environment. This skill is ideal for researchers, developers, or AI agents needing structured, curated information across 12 specific categories ranging from history and geography to technology and economy.

Installation

To integrate this knowledge base, use the following command in your terminal:

clawhub install openclaw/skills/skills/adisinghstudent/taiwan-md-knowledge-base

Ensure you have Node.js 18+ installed. Once installed, ensure the directory structure matches the required SSOT format. If you make modifications to the source markdown files, run bash scripts/sync.sh to update the src/content/ directory so that your changes reflect in the Astro build.

Use Cases

• Research Assistant: Quickly retrieve verified historical or cultural data about Taiwan for report writing.
• Content Pipeline: Use the SSOT architecture to generate automated site updates for a bilingual knowledge portal.
• Graph Visualization: Query the internal relationships between nodes in the knowledge base to visualize connections via the integrated D3.js engine.
• Data Localization: Maintain perfectly mirrored bilingual articles by leveraging the systematic folder structure (zh-TW and en directories).

Example Prompts

1. "Search the Taiwan.md knowledge base for information regarding the history of bubble tea and provide a summary in Traditional Chinese."
2. "Sync the latest markdown updates from the knowledge directory to the Astro content folder."
3. "List all articles within the 'Geography' category and show their corresponding English translation paths."

Tips & Limitations

• SSOT Rule: Never manually edit files within src/content/. Always perform your work in knowledge/ to ensure the integrity of the build-time projection.
• Bilingual Maintenance: When adding a new article, ensure you create the equivalent file in the en/ subdirectory to maintain the bilingual parity required for the site's design.
• Image Caching: The project uses public images from Wikimedia Commons; verify that any new imagery follows the public/images/wiki/ caching convention to avoid broken links.