{
  "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": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/tc-dict",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=tc-dict",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "README.md",
      "SKILL.md",
      "references/DICTIONARY_SOURCES.md",
      "references/SCHEMA.md",
      "requirements.txt",
      "scripts/check_updates.py"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "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."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "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."
        },
        {
          "label": "Upgrade existing",
          "body": "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."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-23T16:43:11.935Z",
      "expiresAt": "2026-04-30T16:43:11.935Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
        "contentDisposition": "attachment; filename=\"4claw-imageboard-1.0.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "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."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/tc-dict",
    "agentPageUrl": "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"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "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."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "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."
      },
      {
        "label": "Upgrade existing",
        "body": "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."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Installation",
        "body": "This skill requires Python dependencies. Install them with uv:\n\n# Install dependencies (recommended: use uv for faster installation)\nuv pip install -r requirements.txt\n\n# Alternative: use pip if uv is not available\npip install -r requirements.txt\n\nRequired packages:\n\npandas>=2.0.0 — Data processing\nopenpyxl>=3.1.0 — Excel file reading"
      },
      {
        "title": "Security",
        "body": "This skill implements the following security measures:\n\n✅ TLS Certificate Verification — All HTTPS connections to MOE servers use proper SSL/TLS certificate validation (no disabled verification)\n\n✅ Zip-Slip Protection — Dictionary downloads validate all zip file paths before extraction to prevent directory traversal attacks (path validation applied)\n\n✅ Safe File Handling — Extracted files are validated and stored in user-isolated directory (~/.openclaw/dictionaries/)\n\n⚠️ 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."
      },
      {
        "title": "Overview",
        "body": "This skill enables you to query Traditional Chinese dictionaries published by Taiwan's Ministry of Education. It provides:\n\nWord lookup — Search for word definitions with automatic fuzzy matching\nDictionary management — Download, extract, and version-control dictionary data\nUpdate automation — Automatic periodic checks (cron) + manual update requests\nExtensible design — Currently supports \"國語辭典簡編本\" (Concised Dictionary), with room for other MOE dictionaries in the future"
      },
      {
        "title": "1. Query Words",
        "body": "Users can look up words using natural language like:\n\n\"請告訴我『蒼鷺』的意思\" (Tell me the meaning of '蒼鷺')\n\"查『梅雨』\" (Look up '梅雨')\n\"『破曉』是什麼意思？\" (What does '破曉' mean?)\n\nThe skill returns the primary definition first. If the user asks for details, provide:\n\nFull definition\nExamples/usage\nRelated information from the dictionary\n\nImplementation: See query_dictionary.py for the search logic."
      },
      {
        "title": "2. Manage Dictionary Updates",
        "body": "Users can trigger updates in two ways:\n\nManual update:\n\n\"更新字典\" (Update dictionary)\n\"重新下載國語辭典\" (Re-download the dictionary)\n\nAutomatic update (cron):\n\nSet up a cron job to check for updates monthly\nCompare local version (stored in metadata.json) against MOE's latest version\nDownload and extract only if a newer version exists\n\nImplementation: See download_dictionary.py for download/extraction logic and check_updates.py for version management."
      },
      {
        "title": "Configuration",
        "body": "The skill respects a configuration file at ~/.openclaw/dictionaries/config.json:\n\n{\n  \"storage_path\": \"~/.openclaw/dictionaries\",\n  \"auto_update_interval_days\": 30,\n  \"dictionaries\": {\n    \"concised\": {\n      \"enabled\": true,\n      \"name\": \"國語辭典簡編本\",\n      \"source\": \"https://language.moe.gov.tw/001/Upload/Files/site_content/M0001/respub/dict_concised_download.html\"\n    }\n  }\n}\n\nUsers can customize storage_path to store dictionaries elsewhere. The default is ~/.openclaw/dictionaries/."
      },
      {
        "title": "Example 1: Simple word lookup",
        "body": "User: \"請告訴我『藍寶石』的意思\"\nResponse: 藍寶石：寶石名。紅玉髓的一種。（如需詳細資料，請告訴我）"
      },
      {
        "title": "Example 2: Request with details",
        "body": "User: \"『藍寶石』是什麼意思？告訴我更多\"\nResponse: 藍寶石：寶石名。紅玉髓的一種。\n例句：...\n相關詞語：..."
      },
      {
        "title": "Example 3: Manual update",
        "body": "User: \"更新字典\"\nResponse: 正在檢查最新版本...\n當前版本：2025-12-29\n最新版本：[Latest from MOE]\n[如果有更新] 已更新字典至最新版本 (2025-12-29)\n[如果無更新] 字典已是最新版本"
      },
      {
        "title": "scripts/",
        "body": "download_dictionary.py — Download zip from MOE, extract, parse xlsx, store locally\nquery_dictionary.py — Search dictionary data, return definitions and optional details\ncheck_updates.py — Query MOE website for version info, compare with local metadata\n\nSee DICTIONARY_SOURCES.md for data source URLs and version tracking."
      },
      {
        "title": "references/",
        "body": "DICTIONARY_SOURCES.md — All MOE dictionary sources, update URLs, version history\nSCHEMA.md — xlsx structure documentation (columns, formats, data layout)\n\nFor setting up cron jobs to monitor updates, reference the scripts/check_updates.py documentation."
      }
    ],
    "body": "OpenClaw Traditional Chinese Dictionary Skill\nInstallation\n\nThis skill requires Python dependencies. Install them with uv:\n\n# Install dependencies (recommended: use uv for faster installation)\nuv pip install -r requirements.txt\n\n# Alternative: use pip if uv is not available\npip install -r requirements.txt\n\n\nRequired packages:\n\npandas>=2.0.0 — Data processing\nopenpyxl>=3.1.0 — Excel file reading\nSecurity\n\nThis skill implements the following security measures:\n\n✅ TLS Certificate Verification — All HTTPS connections to MOE servers use proper SSL/TLS certificate validation (no disabled verification)\n\n✅ Zip-Slip Protection — Dictionary downloads validate all zip file paths before extraction to prevent directory traversal attacks (path validation applied)\n\n✅ Safe File Handling — Extracted files are validated and stored in user-isolated directory (~/.openclaw/dictionaries/)\n\n⚠️ 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.\n\nOverview\n\nThis skill enables you to query Traditional Chinese dictionaries published by Taiwan's Ministry of Education. It provides:\n\nWord lookup — Search for word definitions with automatic fuzzy matching\nDictionary management — Download, extract, and version-control dictionary data\nUpdate automation — Automatic periodic checks (cron) + manual update requests\nExtensible design — Currently supports \"國語辭典簡編本\" (Concised Dictionary), with room for other MOE dictionaries in the future\nCore Capabilities\n1. Query Words\n\nUsers can look up words using natural language like:\n\n\"請告訴我『蒼鷺』的意思\" (Tell me the meaning of '蒼鷺')\n\"查『梅雨』\" (Look up '梅雨')\n\"『破曉』是什麼意思？\" (What does '破曉' mean?)\n\nThe skill returns the primary definition first. If the user asks for details, provide:\n\nFull definition\nExamples/usage\nRelated information from the dictionary\n\nImplementation: See query_dictionary.py for the search logic.\n\n2. Manage Dictionary Updates\n\nUsers can trigger updates in two ways:\n\nManual update:\n\n\"更新字典\" (Update dictionary)\n\"重新下載國語辭典\" (Re-download the dictionary)\n\nAutomatic update (cron):\n\nSet up a cron job to check for updates monthly\nCompare local version (stored in metadata.json) against MOE's latest version\nDownload and extract only if a newer version exists\n\nImplementation: See download_dictionary.py for download/extraction logic and check_updates.py for version management.\n\nConfiguration\n\nThe skill respects a configuration file at ~/.openclaw/dictionaries/config.json:\n\n{\n  \"storage_path\": \"~/.openclaw/dictionaries\",\n  \"auto_update_interval_days\": 30,\n  \"dictionaries\": {\n    \"concised\": {\n      \"enabled\": true,\n      \"name\": \"國語辭典簡編本\",\n      \"source\": \"https://language.moe.gov.tw/001/Upload/Files/site_content/M0001/respub/dict_concised_download.html\"\n    }\n  }\n}\n\n\nUsers can customize storage_path to store dictionaries elsewhere. The default is ~/.openclaw/dictionaries/.\n\nUsage Examples\nExample 1: Simple word lookup\nUser: \"請告訴我『藍寶石』的意思\"\nResponse: 藍寶石：寶石名。紅玉髓的一種。（如需詳細資料，請告訴我）\n\nExample 2: Request with details\nUser: \"『藍寶石』是什麼意思？告訴我更多\"\nResponse: 藍寶石：寶石名。紅玉髓的一種。\n例句：...\n相關詞語：...\n\nExample 3: Manual update\nUser: \"更新字典\"\nResponse: 正在檢查最新版本...\n當前版本：2025-12-29\n最新版本：[Latest from MOE]\n[如果有更新] 已更新字典至最新版本 (2025-12-29)\n[如果無更新] 字典已是最新版本\n\nBundled Resources\nscripts/\ndownload_dictionary.py — Download zip from MOE, extract, parse xlsx, store locally\nquery_dictionary.py — Search dictionary data, return definitions and optional details\ncheck_updates.py — Query MOE website for version info, compare with local metadata\n\nSee DICTIONARY_SOURCES.md for data source URLs and version tracking.\n\nreferences/\nDICTIONARY_SOURCES.md — All MOE dictionary sources, update URLs, version history\nSCHEMA.md — xlsx structure documentation (columns, formats, data layout)\n\nFor setting up cron jobs to monitor updates, reference the scripts/check_updates.py documentation."
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/kai-tw/tc-dict",
    "publisherUrl": "https://clawhub.ai/kai-tw/tc-dict",
    "owner": "kai-tw",
    "version": "1.0.1",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "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"
  }
}