# Send Traditional Chinese Dictionary to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "tc-dict",
    "name": "Traditional Chinese Dictionary",
    "source": "tencent",
    "type": "skill",
    "category": "数据分析",
    "sourceUrl": "https://clawhub.ai/kai-tw/tc-dict",
    "canonicalUrl": "https://clawhub.ai/kai-tw/tc-dict",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/tc-dict",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=tc-dict",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "README.md",
      "SKILL.md",
      "references/DICTIONARY_SOURCES.md",
      "references/SCHEMA.md",
      "requirements.txt",
      "scripts/check_updates.py"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "tc-dict",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T09:34:29.304Z",
      "expiresAt": "2026-05-07T09:34:29.304Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=tc-dict",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=tc-dict",
        "contentDisposition": "attachment; filename=\"tc-dict-1.0.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "tc-dict"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/tc-dict"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/tc-dict",
    "downloadUrl": "https://openagent3.xyz/downloads/tc-dict",
    "agentUrl": "https://openagent3.xyz/skills/tc-dict/agent",
    "manifestUrl": "https://openagent3.xyz/skills/tc-dict/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/tc-dict/agent.md"
  }
}
```
## Documentation

### Installation

This skill requires Python dependencies. Install them with uv:

# Install dependencies (recommended: use uv for faster installation)
uv pip install -r requirements.txt

# Alternative: use pip if uv is not available
pip install -r requirements.txt

Required packages:

pandas>=2.0.0 — Data processing
openpyxl>=3.1.0 — Excel file reading

### Security

This skill implements the following security measures:

✅ TLS Certificate Verification — All HTTPS connections to MOE servers use proper SSL/TLS certificate validation (no disabled verification)

✅ Zip-Slip Protection — Dictionary downloads validate all zip file paths before extraction to prevent directory traversal attacks (path validation applied)

✅ Safe File Handling — Extracted files are validated and stored in user-isolated directory (~/.openclaw/dictionaries/)

⚠️ Cron/Automatic Updates — If you enable automatic updates via cron, the skill will download dictionary files from MOE on your specified schedule. Consider the frequency and enable notifications to track changes.

### Overview

This skill enables you to query Traditional Chinese dictionaries published by Taiwan's Ministry of Education. It provides:

Word lookup — Search for word definitions with automatic fuzzy matching
Dictionary management — Download, extract, and version-control dictionary data
Update automation — Automatic periodic checks (cron) + manual update requests
Extensible design — Currently supports "國語辭典簡編本" (Concised Dictionary), with room for other MOE dictionaries in the future

### 1. Query Words

Users can look up words using natural language like:

"請告訴我『蒼鷺』的意思" (Tell me the meaning of '蒼鷺')
"查『梅雨』" (Look up '梅雨')
"『破曉』是什麼意思？" (What does '破曉' mean?)

The skill returns the primary definition first. If the user asks for details, provide:

Full definition
Examples/usage
Related information from the dictionary

Implementation: See query_dictionary.py for the search logic.

### 2. Manage Dictionary Updates

Users can trigger updates in two ways:

Manual update:

"更新字典" (Update dictionary)
"重新下載國語辭典" (Re-download the dictionary)

Automatic update (cron):

Set up a cron job to check for updates monthly
Compare local version (stored in metadata.json) against MOE's latest version
Download and extract only if a newer version exists

Implementation: See download_dictionary.py for download/extraction logic and check_updates.py for version management.

### Configuration

The skill respects a configuration file at ~/.openclaw/dictionaries/config.json:

{
  "storage_path": "~/.openclaw/dictionaries",
  "auto_update_interval_days": 30,
  "dictionaries": {
    "concised": {
      "enabled": true,
      "name": "國語辭典簡編本",
      "source": "https://language.moe.gov.tw/001/Upload/Files/site_content/M0001/respub/dict_concised_download.html"
    }
  }
}

Users can customize storage_path to store dictionaries elsewhere. The default is ~/.openclaw/dictionaries/.

### Example 1: Simple word lookup

User: "請告訴我『藍寶石』的意思"
Response: 藍寶石：寶石名。紅玉髓的一種。（如需詳細資料，請告訴我）

### Example 2: Request with details

User: "『藍寶石』是什麼意思？告訴我更多"
Response: 藍寶石：寶石名。紅玉髓的一種。
例句：...
相關詞語：...

### Example 3: Manual update

User: "更新字典"
Response: 正在檢查最新版本...
當前版本：2025-12-29
最新版本：[Latest from MOE]
[如果有更新] 已更新字典至最新版本 (2025-12-29)
[如果無更新] 字典已是最新版本

### scripts/

download_dictionary.py — Download zip from MOE, extract, parse xlsx, store locally
query_dictionary.py — Search dictionary data, return definitions and optional details
check_updates.py — Query MOE website for version info, compare with local metadata

See DICTIONARY_SOURCES.md for data source URLs and version tracking.

### references/

DICTIONARY_SOURCES.md — All MOE dictionary sources, update URLs, version history
SCHEMA.md — xlsx structure documentation (columns, formats, data layout)

For setting up cron jobs to monitor updates, reference the scripts/check_updates.py documentation.
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: kai-tw
- Version: 1.0.1
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-04-30T09:34:29.304Z
- Expires at: 2026-05-07T09:34:29.304Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/tc-dict)
- [Send to Agent page](https://openagent3.xyz/skills/tc-dict/agent)
- [JSON manifest](https://openagent3.xyz/skills/tc-dict/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/tc-dict/agent.md)
- [Download page](https://openagent3.xyz/downloads/tc-dict)