{
  "schemaVersion": "1.0",
  "item": {
    "slug": "taiwan-calendar",
    "name": "Taiwan Calendar Plugin",
    "source": "tencent",
    "type": "skill",
    "category": "效率提升",
    "sourceUrl": "https://clawhub.ai/pigfoot/taiwan-calendar",
    "canonicalUrl": "https://clawhub.ai/pigfoot/taiwan-calendar",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/taiwan-calendar",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=taiwan-calendar",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "README.md",
      "SKILL.md",
      "scripts/taiwan_calendar.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-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.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/taiwan-calendar"
    },
    "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/taiwan-calendar",
    "agentPageUrl": "https://openagent3.xyz/skills/taiwan-calendar/agent",
    "manifestUrl": "https://openagent3.xyz/skills/taiwan-calendar/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/taiwan-calendar/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": "Taiwan Calendar Skill",
        "body": "Provides accurate Taiwan working day and holiday information by querying government open data APIs in real-time."
      },
      {
        "title": "Why This Skill Exists",
        "body": "Claude Code frequently makes errors with Taiwan date-related queries due to knowledge cutoff:\n\nGets weekdays wrong (e.g., saying Tuesday when it's Wednesday)\nDoesn't know current year's national holidays\nUnaware of make-up workdays (補班日)\n\nThis skill queries Taiwan's government administrative calendar API to provide accurate, up-to-date information."
      },
      {
        "title": "When to Use",
        "body": "Trigger actively when user asks about:\n\nDate queries: \"今天是幾號?\", \"What's today's date?\", \"現在台灣幾點?\"\nWorking day queries: \"今天是工作日嗎?\", \"Is tomorrow a working day?\", \"下週一要上班嗎?\"\nHoliday queries: \"1/1 是假日嗎?\", \"國慶日是哪天?\", \"下一個連假什麼時候?\"\nDate calculations: \"5 個工作日後是哪天?\", \"這個月有幾個工作日?\", \"deadline 是五個工作天\"\nMake-up workdays: \"有沒有補班?\", \"這週六要上班嗎?\"\n\nAlso use for:\n\nSchedule/timeline planning that requires working day awareness\nDeadline calculations mentioning \"工作日/工作天\"\nAny Taiwan calendar-related questions"
      },
      {
        "title": "Commands",
        "body": "All commands use: uv run --managed-python scripts/taiwan_calendar.py <command>"
      },
      {
        "title": "Basic Queries",
        "body": "today - Today's date and status\n\nuv run --managed-python scripts/taiwan_calendar.py today\n\nOutput example:\n\n2025-01-06 (週一) 是工作日。\n\ncheck <date> - Check specific date\n\nuv run --managed-python scripts/taiwan_calendar.py check 2025-01-01\nuv run --managed-python scripts/taiwan_calendar.py check 01/01\n\nOutput example:\n\n2025-01-01 (週三) 是非工作日 - 元旦。\n\nDate formats supported:\n\nYYYY-MM-DD (e.g., 2025-01-01)\nYYYY/MM/DD (e.g., 2025/01/01)\nMM/DD (assumes current year, e.g., 01/01)"
      },
      {
        "title": "Range Queries",
        "body": "range <start> <end> - Count working days in range\n\nuv run --managed-python scripts/taiwan_calendar.py range 2025-01-01 2025-01-31\n\nOutput example:\n\n2025-01-01 到 2025-01-31 共有 23 個工作日。\n\n期間假日：\n  - 2025-01-01 (週三) - 元旦\n  - 2025-01-29 (週三) - 春節"
      },
      {
        "title": "Advanced Calculations",
        "body": "add-days [date] <n> - Calculate N working days later\n\n# From today\nuv run --managed-python scripts/taiwan_calendar.py add-days 5\n\n# From specific date\nuv run --managed-python scripts/taiwan_calendar.py add-days 2025-01-06 5\n\nOutput example:\n\n從 2025-01-06 算起 5 個工作日後是 2025-01-13 (週一)。\n\nnext-working [date] - Find next working day\n\n# From today\nuv run --managed-python scripts/taiwan_calendar.py next-working\n\n# From specific date\nuv run --managed-python scripts/taiwan_calendar.py next-working 2025-01-03\n\nOutput example:\n\n下一個工作日是 2025-01-06 (週一)。\n\nnext-holiday [date] - Find next holiday\n\n# From today\nuv run --managed-python scripts/taiwan_calendar.py next-holiday\n\n# From specific date\nuv run --managed-python scripts/taiwan_calendar.py next-holiday 2025-01-06\n\nOutput example:\n\n下一個假日是 2025-01-29 (週三) - 春節。"
      },
      {
        "title": "Example 1: Simple Date Query",
        "body": "User: \"今天是幾號？\"\n\nResponse:\n[Run: uv run --managed-python scripts/taiwan_calendar.py today]\nOutput: 2025-01-06 (週一) 是工作日。\n\n\"今天是 2025 年 1 月 6 日（週一），是工作日。\""
      },
      {
        "title": "Example 2: Holiday Check",
        "body": "User: \"元旦是放假嗎？\"\n\nResponse:\n[Run: uv run --managed-python scripts/taiwan_calendar.py check 01/01]\nOutput: 2025-01-01 (週三) 是非工作日 - 元旦。\n\n\"是的，元旦（1/1）是國定假日。\""
      },
      {
        "title": "Example 3: Working Day Calculation",
        "body": "User: \"報告要 5 個工作天內交，今天開始算那是哪天？\"\n\nResponse:\n[Run: uv run --managed-python scripts/taiwan_calendar.py add-days 5]\nOutput: 從 2025-01-06 算起 5 個工作日後是 2025-01-13 (週一)。\n\n\"從今天算起 5 個工作日後是 1 月 13 日（週一）。\""
      },
      {
        "title": "Example 4: This Month's Working Days",
        "body": "User: \"這個月有幾個工作日？\"\n\nResponse:\n[Run: uv run --managed-python scripts/taiwan_calendar.py range 2025-01-01 2025-01-31]\nOutput: 2025-01-01 到 2025-01-31 共有 23 個工作日。\n\n期間假日：\n  - 2025-01-01 (週三) - 元旦\n\n\"這個月（1月）有 23 個工作日，期間有元旦（1/1）放假。\""
      },
      {
        "title": "Example 5: Next Holiday",
        "body": "User: \"下一個連假是什麼時候？\"\n\nResponse:\n[Run: uv run --managed-python scripts/taiwan_calendar.py next-holiday]\nOutput: 下一個假日是 2025-01-29 (週三) - 春節。\n\n\"下一個假日是春節，從 1 月 29 日（週三）開始。\""
      },
      {
        "title": "Data Source",
        "body": "Primary: Taiwan government open data platform (data.gov.tw)\nFallback: New Taipei City open data"
      },
      {
        "title": "Caching",
        "body": "Location: System temp directory (cross-platform via tempfile.gettempdir())\nFile: taiwan-calendar-cache.json\nExpiry: 1 hour\nBehavior: Automatically refreshes when expired"
      },
      {
        "title": "Timezone",
        "body": "All operations use Taiwan timezone (Asia/Taipei, UTC+8)\nCurrent time queries reflect Taiwan local time"
      },
      {
        "title": "Error Handling",
        "body": "Clear error messages if API unavailable\nAutomatic fallback to secondary API source\nUses expired cache with warning if network unavailable"
      },
      {
        "title": "When to Use This Skill",
        "body": "✅ DO use for:\n\nAny Taiwan date/calendar queries\nWorking day calculations\nHoliday information\nDate arithmetic involving working days\n\n❌ DON'T use for:\n\nNon-Taiwan regions/calendars\nLunar calendar queries (農曆)\n24 solar terms (二十四節氣)\nHistorical dates (use for current/future dates)"
      },
      {
        "title": "Natural Language Output",
        "body": "The script outputs Chinese (Traditional) responses. Use these directly when responding to users, or translate if needed."
      },
      {
        "title": "Command Execution",
        "body": "Always use the full command with uv run --managed-python:\n\nuv run --managed-python scripts/taiwan_calendar.py <command> [args]\n\nNEVER use:\n\npython scripts/taiwan_calendar.py ❌\ncd scripts && uv run taiwan_calendar.py ❌\n\nThe script path is relative to the skill directory."
      },
      {
        "title": "\"Failed to fetch calendar data\"",
        "body": "Cause: All API sources unavailable\n\nSolution:\n\nCheck network connection\nVerify government API status\nScript will use expired cache if available (with warning)"
      },
      {
        "title": "\"Invalid date format\"",
        "body": "Cause: Unrecognized date format\n\nSolution: Use supported formats:\n\nYYYY-MM-DD (e.g., 2025-01-06)\nYYYY/MM/DD (e.g., 2025/01/06)\nMM/DD (e.g., 01/06)"
      },
      {
        "title": "\"Unable to parse date\"",
        "body": "Cause: Ambiguous date input\n\nSolution: Be explicit with year for dates far from today"
      },
      {
        "title": "Progressive Disclosure",
        "body": "This is the main skill file. All essential information is included here for immediate use.\n\nFor implementation details, see: scripts/taiwan_calendar.py"
      }
    ],
    "body": "Taiwan Calendar Skill\n\nProvides accurate Taiwan working day and holiday information by querying government open data APIs in real-time.\n\nWhy This Skill Exists\n\nClaude Code frequently makes errors with Taiwan date-related queries due to knowledge cutoff:\n\nGets weekdays wrong (e.g., saying Tuesday when it's Wednesday)\nDoesn't know current year's national holidays\nUnaware of make-up workdays (補班日)\n\nThis skill queries Taiwan's government administrative calendar API to provide accurate, up-to-date information.\n\nWhen to Use\n\nTrigger actively when user asks about:\n\nDate queries: \"今天是幾號?\", \"What's today's date?\", \"現在台灣幾點?\"\nWorking day queries: \"今天是工作日嗎?\", \"Is tomorrow a working day?\", \"下週一要上班嗎?\"\nHoliday queries: \"1/1 是假日嗎?\", \"國慶日是哪天?\", \"下一個連假什麼時候?\"\nDate calculations: \"5 個工作日後是哪天?\", \"這個月有幾個工作日?\", \"deadline 是五個工作天\"\nMake-up workdays: \"有沒有補班?\", \"這週六要上班嗎?\"\n\nAlso use for:\n\nSchedule/timeline planning that requires working day awareness\nDeadline calculations mentioning \"工作日/工作天\"\nAny Taiwan calendar-related questions\nCommands\n\nAll commands use: uv run --managed-python scripts/taiwan_calendar.py <command>\n\nBasic Queries\ntoday - Today's date and status\nuv run --managed-python scripts/taiwan_calendar.py today\n\n\nOutput example:\n\n2025-01-06 (週一) 是工作日。\n\ncheck <date> - Check specific date\nuv run --managed-python scripts/taiwan_calendar.py check 2025-01-01\nuv run --managed-python scripts/taiwan_calendar.py check 01/01\n\n\nOutput example:\n\n2025-01-01 (週三) 是非工作日 - 元旦。\n\n\nDate formats supported:\n\nYYYY-MM-DD (e.g., 2025-01-01)\nYYYY/MM/DD (e.g., 2025/01/01)\nMM/DD (assumes current year, e.g., 01/01)\nRange Queries\nrange <start> <end> - Count working days in range\nuv run --managed-python scripts/taiwan_calendar.py range 2025-01-01 2025-01-31\n\n\nOutput example:\n\n2025-01-01 到 2025-01-31 共有 23 個工作日。\n\n期間假日：\n  - 2025-01-01 (週三) - 元旦\n  - 2025-01-29 (週三) - 春節\n\nAdvanced Calculations\nadd-days [date] <n> - Calculate N working days later\n# From today\nuv run --managed-python scripts/taiwan_calendar.py add-days 5\n\n# From specific date\nuv run --managed-python scripts/taiwan_calendar.py add-days 2025-01-06 5\n\n\nOutput example:\n\n從 2025-01-06 算起 5 個工作日後是 2025-01-13 (週一)。\n\nnext-working [date] - Find next working day\n# From today\nuv run --managed-python scripts/taiwan_calendar.py next-working\n\n# From specific date\nuv run --managed-python scripts/taiwan_calendar.py next-working 2025-01-03\n\n\nOutput example:\n\n下一個工作日是 2025-01-06 (週一)。\n\nnext-holiday [date] - Find next holiday\n# From today\nuv run --managed-python scripts/taiwan_calendar.py next-holiday\n\n# From specific date\nuv run --managed-python scripts/taiwan_calendar.py next-holiday 2025-01-06\n\n\nOutput example:\n\n下一個假日是 2025-01-29 (週三) - 春節。\n\nUsage Examples\nExample 1: Simple Date Query\nUser: \"今天是幾號？\"\n\nResponse:\n[Run: uv run --managed-python scripts/taiwan_calendar.py today]\nOutput: 2025-01-06 (週一) 是工作日。\n\n\"今天是 2025 年 1 月 6 日（週一），是工作日。\"\n\nExample 2: Holiday Check\nUser: \"元旦是放假嗎？\"\n\nResponse:\n[Run: uv run --managed-python scripts/taiwan_calendar.py check 01/01]\nOutput: 2025-01-01 (週三) 是非工作日 - 元旦。\n\n\"是的，元旦（1/1）是國定假日。\"\n\nExample 3: Working Day Calculation\nUser: \"報告要 5 個工作天內交，今天開始算那是哪天？\"\n\nResponse:\n[Run: uv run --managed-python scripts/taiwan_calendar.py add-days 5]\nOutput: 從 2025-01-06 算起 5 個工作日後是 2025-01-13 (週一)。\n\n\"從今天算起 5 個工作日後是 1 月 13 日（週一）。\"\n\nExample 4: This Month's Working Days\nUser: \"這個月有幾個工作日？\"\n\nResponse:\n[Run: uv run --managed-python scripts/taiwan_calendar.py range 2025-01-01 2025-01-31]\nOutput: 2025-01-01 到 2025-01-31 共有 23 個工作日。\n\n期間假日：\n  - 2025-01-01 (週三) - 元旦\n\n\"這個月（1月）有 23 個工作日，期間有元旦（1/1）放假。\"\n\nExample 5: Next Holiday\nUser: \"下一個連假是什麼時候？\"\n\nResponse:\n[Run: uv run --managed-python scripts/taiwan_calendar.py next-holiday]\nOutput: 下一個假日是 2025-01-29 (週三) - 春節。\n\n\"下一個假日是春節，從 1 月 29 日（週三）開始。\"\n\nTechnical Details\nData Source\nPrimary: Taiwan government open data platform (data.gov.tw)\nFallback: New Taipei City open data\nCaching\nLocation: System temp directory (cross-platform via tempfile.gettempdir())\nFile: taiwan-calendar-cache.json\nExpiry: 1 hour\nBehavior: Automatically refreshes when expired\nTimezone\nAll operations use Taiwan timezone (Asia/Taipei, UTC+8)\nCurrent time queries reflect Taiwan local time\nError Handling\nClear error messages if API unavailable\nAutomatic fallback to secondary API source\nUses expired cache with warning if network unavailable\nImportant Notes\nWhen to Use This Skill\n\n✅ DO use for:\n\nAny Taiwan date/calendar queries\nWorking day calculations\nHoliday information\nDate arithmetic involving working days\n\n❌ DON'T use for:\n\nNon-Taiwan regions/calendars\nLunar calendar queries (農曆)\n24 solar terms (二十四節氣)\nHistorical dates (use for current/future dates)\nNatural Language Output\n\nThe script outputs Chinese (Traditional) responses. Use these directly when responding to users, or translate if needed.\n\nCommand Execution\n\nAlways use the full command with uv run --managed-python:\n\nuv run --managed-python scripts/taiwan_calendar.py <command> [args]\n\n\nNEVER use:\n\npython scripts/taiwan_calendar.py ❌\ncd scripts && uv run taiwan_calendar.py ❌\n\nThe script path is relative to the skill directory.\n\nTroubleshooting\n\"Failed to fetch calendar data\"\n\nCause: All API sources unavailable\n\nSolution:\n\nCheck network connection\nVerify government API status\nScript will use expired cache if available (with warning)\n\"Invalid date format\"\n\nCause: Unrecognized date format\n\nSolution: Use supported formats:\n\nYYYY-MM-DD (e.g., 2025-01-06)\nYYYY/MM/DD (e.g., 2025/01/06)\nMM/DD (e.g., 01/06)\n\"Unable to parse date\"\n\nCause: Ambiguous date input\n\nSolution: Be explicit with year for dates far from today\n\nProgressive Disclosure\n\nThis is the main skill file. All essential information is included here for immediate use.\n\nFor implementation details, see: scripts/taiwan_calendar.py"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/pigfoot/taiwan-calendar",
    "publisherUrl": "https://clawhub.ai/pigfoot/taiwan-calendar",
    "owner": "pigfoot",
    "version": "0.0.1",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/taiwan-calendar",
    "downloadUrl": "https://openagent3.xyz/downloads/taiwan-calendar",
    "agentUrl": "https://openagent3.xyz/skills/taiwan-calendar/agent",
    "manifestUrl": "https://openagent3.xyz/skills/taiwan-calendar/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/taiwan-calendar/agent.md"
  }
}