{
  "schemaVersion": "1.0",
  "item": {
    "slug": "global-holidays",
    "name": "Global Holidays",
    "source": "tencent",
    "type": "skill",
    "category": "数据分析",
    "sourceUrl": "https://clawhub.ai/yting27/global-holidays",
    "canonicalUrl": "https://clawhub.ai/yting27/global-holidays",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/global-holidays",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=global-holidays",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md"
    ],
    "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. 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. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "slug": "global-holidays",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-29T17:40:14.804Z",
      "expiresAt": "2026-05-06T17:40:14.804Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=global-holidays",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=global-holidays",
        "contentDisposition": "attachment; filename=\"global-holidays-1.0.2.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "global-holidays"
      },
      "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/global-holidays"
    },
    "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/global-holidays",
    "agentPageUrl": "https://openagent3.xyz/skills/global-holidays/agent",
    "manifestUrl": "https://openagent3.xyz/skills/global-holidays/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/global-holidays/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. 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. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Overview",
        "body": "holidays is a Python library that generates country- and subdivision-specific sets of government-designated holidays on the fly. It covers 249 countries (ISO 3166-1) and supports subdivisions (states, provinces, regions) via ISO 3166-2 codes.\n\nThe central object is HolidayBase, which behaves like a Python dict mapping date → holiday name. All examples below can be run directly in the shell:\n\npython <<'EOF'\n# your code here\nEOF\n# OR (if the package is installed via uv)\nuv run - <<EOF\n# your code here\nEOF"
      },
      {
        "title": "Installation",
        "body": "IMPORTANT: Always use a virtual environment or --break-system-packages flag.\n\npip install holidays --break-system-packages\n\nFor production use, pin to a specific version:\n\npip install holidays==0.58 --break-system-packages"
      },
      {
        "title": "Quick Reference",
        "body": "TaskMethodAll holidays for a country/yearcountry_holidays('US', years=2024)Holidays for a subdivisioncountry_holidays('US', subdiv='CA', years=2024)Holidays in a date rangeholidays_obj['2024-01-01':'2024-01-31']Check if a date is a holidayholidays_obj.get('2024-12-25') → name or NoneAdd custom holidaysholidays_obj.update({'2024-07-10': 'My Birthday!'})List all supported countrieslist_supported_countries()List countries with localizationlist_localized_countries()"
      },
      {
        "title": "country_holidays() — Main Function",
        "body": "country_holidays(\n    country,          # ISO 3166-1 alpha-2 code, e.g. 'US', 'GB', 'DE'\n    subdiv=None,      # ISO 3166-2 subdivision code, e.g. 'CA', 'TX', 'BY'\n    years=None,       # int or list of ints, e.g. 2024 or [2023, 2024]\n    expand=True,      # auto-expand years when checking dates outside current range\n    observed=True,    # include observed holidays (e.g. holiday on weekend → Monday)\n    language=None,    # ISO 639-1 language code for holiday names, e.g. 'en', 'de'\n    categories=None,  # filter to specific holiday categories (country-dependent)\n)\n\nReturns a HolidayBase object (dict-like: {date: name})."
      },
      {
        "title": "1. Get All Holidays for a Country in a Year",
        "body": "from holidays import country_holidays\n\nus_holidays = country_holidays('US', years=2024)\nfor date, name in sorted(us_holidays.items()):\n    print(date, name)"
      },
      {
        "title": "2. Get Holidays for a Subdivision (State / Province)",
        "body": "Use the ISO 3166-2 subdivision code (e.g. 'CA' for California, 'BY' for Bavaria).\n\nfrom holidays import country_holidays\n\nca_holidays = country_holidays('US', subdiv='CA', years=2024)\nfor date, name in sorted(ca_holidays.items()):\n    print(date, name)"
      },
      {
        "title": "3. Get Holidays Within a Date Range",
        "body": "Slice the HolidayBase object with date strings ('YYYY-MM-DD'):\n\nfrom holidays import country_holidays\n\nca_holidays = country_holidays('US', subdiv='CA', years=2024)\nfor day in ca_holidays['2024-01-01':'2024-01-31']:\n    print(f\"{day}: {ca_holidays.get(day)}\")"
      },
      {
        "title": "4. Check if a Specific Date is a Holiday",
        "body": ".get() returns the holiday name if the date is a holiday, or None if it is not.\n\nfrom holidays import country_holidays\n\nca_holidays = country_holidays('US', subdiv='CA')\n\n# Is December 25 a holiday?\nname = ca_holidays.get('2024-12-25')\nprint(name)   # → 'Christmas Day'\n\n# Is December 26 a holiday?\nname = ca_holidays.get('2024-12-26')\nprint(name)   # → None\n\nTip: Use if date in holidays_obj: for a boolean check (faster than .get())."
      },
      {
        "title": "5. Working with Custom Holidays",
        "body": "SECURITY NOTE: Only use custom holidays if the user explicitly provides or requests them. Never assume a file location exists.\n\nALWAYS ask the user for the file path rather than using a default location. If they don't have a custom holidays file, skip this feature.\n\nExample workflow:\n\nAsk user: \"Do you have a custom holidays JSON file you'd like to include?\"\nIf yes, ask: \"What's the full path to your custom holidays file?\"\nOnly then load and merge:\n\nimport json\nfrom pathlib import Path\nfrom holidays import country_holidays\n\n# ONLY use this if user explicitly provided the path\ncustom_file = Path(\"/path/user/provided/custom-holidays.json\")\n\n# Verify file exists before reading\nif custom_file.exists():\n    with open(custom_file) as f:\n        custom_data = json.load(f)\n\n    holidays_2024 = country_holidays('US', years=2024)\n    holidays_2024.update(custom_data)\n\n    print(holidays_2024.get('2024-07-10'))  # → 'My Birthday!' (if defined)\nelse:\n    print(f\"File not found: {custom_file}\")\n\nCustom holidays file format:\n\n{\n  \"2024-07-10\": \"My Birthday!\",\n  \"2024-10-01\": \"Family Celebration\"\n}"
      },
      {
        "title": "6. List All Supported Countries and Subdivisions",
        "body": "from holidays import list_supported_countries\n\n# include_aliases=True also returns common aliases (e.g. 'UK' for 'GB')\nsupported = list_supported_countries(include_aliases=True)\nprint(supported['US'])   # → list of supported US subdivision codes"
      },
      {
        "title": "7. Use Localized (Translated) Holiday Names",
        "body": "Language codes:\n\nUse ISO 639-1 codes (e.g., en, de, fr)\nSome countries use locale-specific codes (e.g., en_US, zh_CN)\nIf an unsupported language is requested, the library falls back to the default language\n\nStep 1: Find countries with localization support\n\nfrom holidays import list_localized_countries\n\n# Get all countries that support multiple languages\nlocalized = list_localized_countries(include_aliases=True)\n\n# Check if a specific country supports localization\nif 'MY' in localized:\n    print(f\"Malaysia supports: {localized['MY']}\")\n    # Output: Malaysia supports: ['en_MY', 'ms_MY', 'zh_CN', ...]\n\nStep 2: Generate holidays in a specific language\n\nfrom holidays import country_holidays\n\n# Malaysia holidays in Malay language\nmy_holidays_ms = country_holidays('MY', years=2025, language='ms_MY')\nfor date, name in sorted(my_holidays_ms.items())[:3]:\n    print(f\"{date}: {name}\")\n\n# Same holidays in English\nmy_holidays_en = country_holidays('MY', years=2025, language='en_MY')\nfor date, name in sorted(my_holidays_en.items())[:3]:\n    print(f\"{date}: {name}\")"
      },
      {
        "title": "Key Behaviours to Know",
        "body": "observed=True (default): When a holiday falls on a weekend, the observed date (typically Monday) is included. Set observed=False to get only the statutory date.\nexpand=True (default): If you check a date outside the years range, the library automatically adds that year. Set expand=False to prevent this.\nMultiple years: Pass a list to years to load several years at once: years=[2023, 2024, 2025].\nDate keys: The HolidayBase dict accepts datetime.date, datetime.datetime, or 'YYYY-MM-DD' strings interchangeably as keys.\nCountry codes: Use ISO 3166-1 alpha-2 (e.g. 'US', 'GB', 'DE'). Aliases like 'UK' are supported when include_aliases=True."
      },
      {
        "title": "Dependencies",
        "body": "Python: 3.10+\nPackage: holidays (PyPI). Install with: pip install holidays --break-system-packages\nNo external system dependencies required"
      },
      {
        "title": "Security Considerations",
        "body": "Package installation: Use --break-system-packages flag (required in this environment) and consider pinning to a specific version\nCustom holidays files: Only load custom holidays when explicitly requested by the user with a user-provided path\nFile access: Verify file existence before reading to avoid exposing directory structure"
      }
    ],
    "body": "holidays — Python Holiday Library\nOverview\n\nholidays is a Python library that generates country- and subdivision-specific sets of government-designated holidays on the fly. It covers 249 countries (ISO 3166-1) and supports subdivisions (states, provinces, regions) via ISO 3166-2 codes.\n\nThe central object is HolidayBase, which behaves like a Python dict mapping date → holiday name. All examples below can be run directly in the shell:\n\npython <<'EOF'\n# your code here\nEOF\n# OR (if the package is installed via uv)\nuv run - <<EOF\n# your code here\nEOF\n\nInstallation\n\nIMPORTANT: Always use a virtual environment or --break-system-packages flag.\n\npip install holidays --break-system-packages\n\n\nFor production use, pin to a specific version:\n\npip install holidays==0.58 --break-system-packages\n\nQuick Reference\nTask\tMethod\nAll holidays for a country/year\tcountry_holidays('US', years=2024)\nHolidays for a subdivision\tcountry_holidays('US', subdiv='CA', years=2024)\nHolidays in a date range\tholidays_obj['2024-01-01':'2024-01-31']\nCheck if a date is a holiday\tholidays_obj.get('2024-12-25') → name or None\nAdd custom holidays\tholidays_obj.update({'2024-07-10': 'My Birthday!'})\nList all supported countries\tlist_supported_countries()\nList countries with localization\tlist_localized_countries()\nCore API\ncountry_holidays() — Main Function\ncountry_holidays(\n    country,          # ISO 3166-1 alpha-2 code, e.g. 'US', 'GB', 'DE'\n    subdiv=None,      # ISO 3166-2 subdivision code, e.g. 'CA', 'TX', 'BY'\n    years=None,       # int or list of ints, e.g. 2024 or [2023, 2024]\n    expand=True,      # auto-expand years when checking dates outside current range\n    observed=True,    # include observed holidays (e.g. holiday on weekend → Monday)\n    language=None,    # ISO 639-1 language code for holiday names, e.g. 'en', 'de'\n    categories=None,  # filter to specific holiday categories (country-dependent)\n)\n\n\nReturns a HolidayBase object (dict-like: {date: name}).\n\nCommon Tasks\n1. Get All Holidays for a Country in a Year\nfrom holidays import country_holidays\n\nus_holidays = country_holidays('US', years=2024)\nfor date, name in sorted(us_holidays.items()):\n    print(date, name)\n\n2. Get Holidays for a Subdivision (State / Province)\n\nUse the ISO 3166-2 subdivision code (e.g. 'CA' for California, 'BY' for Bavaria).\n\nfrom holidays import country_holidays\n\nca_holidays = country_holidays('US', subdiv='CA', years=2024)\nfor date, name in sorted(ca_holidays.items()):\n    print(date, name)\n\n3. Get Holidays Within a Date Range\n\nSlice the HolidayBase object with date strings ('YYYY-MM-DD'):\n\nfrom holidays import country_holidays\n\nca_holidays = country_holidays('US', subdiv='CA', years=2024)\nfor day in ca_holidays['2024-01-01':'2024-01-31']:\n    print(f\"{day}: {ca_holidays.get(day)}\")\n\n4. Check if a Specific Date is a Holiday\n\n.get() returns the holiday name if the date is a holiday, or None if it is not.\n\nfrom holidays import country_holidays\n\nca_holidays = country_holidays('US', subdiv='CA')\n\n# Is December 25 a holiday?\nname = ca_holidays.get('2024-12-25')\nprint(name)   # → 'Christmas Day'\n\n# Is December 26 a holiday?\nname = ca_holidays.get('2024-12-26')\nprint(name)   # → None\n\n\nTip: Use if date in holidays_obj: for a boolean check (faster than .get()).\n\n5. Working with Custom Holidays\n\nSECURITY NOTE: Only use custom holidays if the user explicitly provides or requests them. Never assume a file location exists.\n\nALWAYS ask the user for the file path rather than using a default location. If they don't have a custom holidays file, skip this feature.\n\nExample workflow:\n\nAsk user: \"Do you have a custom holidays JSON file you'd like to include?\"\nIf yes, ask: \"What's the full path to your custom holidays file?\"\nOnly then load and merge:\nimport json\nfrom pathlib import Path\nfrom holidays import country_holidays\n\n# ONLY use this if user explicitly provided the path\ncustom_file = Path(\"/path/user/provided/custom-holidays.json\")\n\n# Verify file exists before reading\nif custom_file.exists():\n    with open(custom_file) as f:\n        custom_data = json.load(f)\n\n    holidays_2024 = country_holidays('US', years=2024)\n    holidays_2024.update(custom_data)\n\n    print(holidays_2024.get('2024-07-10'))  # → 'My Birthday!' (if defined)\nelse:\n    print(f\"File not found: {custom_file}\")\n\n\nCustom holidays file format:\n\n{\n  \"2024-07-10\": \"My Birthday!\",\n  \"2024-10-01\": \"Family Celebration\"\n}\n\n6. List All Supported Countries and Subdivisions\nfrom holidays import list_supported_countries\n\n# include_aliases=True also returns common aliases (e.g. 'UK' for 'GB')\nsupported = list_supported_countries(include_aliases=True)\nprint(supported['US'])   # → list of supported US subdivision codes\n\n7. Use Localized (Translated) Holiday Names\n\nLanguage codes:\n\nUse ISO 639-1 codes (e.g., en, de, fr)\nSome countries use locale-specific codes (e.g., en_US, zh_CN)\nIf an unsupported language is requested, the library falls back to the default language\n\nStep 1: Find countries with localization support\n\nfrom holidays import list_localized_countries\n\n# Get all countries that support multiple languages\nlocalized = list_localized_countries(include_aliases=True)\n\n# Check if a specific country supports localization\nif 'MY' in localized:\n    print(f\"Malaysia supports: {localized['MY']}\")\n    # Output: Malaysia supports: ['en_MY', 'ms_MY', 'zh_CN', ...]\n\n\nStep 2: Generate holidays in a specific language\n\nfrom holidays import country_holidays\n\n# Malaysia holidays in Malay language\nmy_holidays_ms = country_holidays('MY', years=2025, language='ms_MY')\nfor date, name in sorted(my_holidays_ms.items())[:3]:\n    print(f\"{date}: {name}\")\n\n# Same holidays in English\nmy_holidays_en = country_holidays('MY', years=2025, language='en_MY')\nfor date, name in sorted(my_holidays_en.items())[:3]:\n    print(f\"{date}: {name}\")\n\nKey Behaviours to Know\nobserved=True (default): When a holiday falls on a weekend, the observed date (typically Monday) is included. Set observed=False to get only the statutory date.\nexpand=True (default): If you check a date outside the years range, the library automatically adds that year. Set expand=False to prevent this.\nMultiple years: Pass a list to years to load several years at once: years=[2023, 2024, 2025].\nDate keys: The HolidayBase dict accepts datetime.date, datetime.datetime, or 'YYYY-MM-DD' strings interchangeably as keys.\nCountry codes: Use ISO 3166-1 alpha-2 (e.g. 'US', 'GB', 'DE'). Aliases like 'UK' are supported when include_aliases=True.\nDependencies\nPython: 3.10+\nPackage: holidays (PyPI). Install with: pip install holidays --break-system-packages\nNo external system dependencies required\nSecurity Considerations\nPackage installation: Use --break-system-packages flag (required in this environment) and consider pinning to a specific version\nCustom holidays files: Only load custom holidays when explicitly requested by the user with a user-provided path\nFile access: Verify file existence before reading to avoid exposing directory structure"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/yting27/global-holidays",
    "publisherUrl": "https://clawhub.ai/yting27/global-holidays",
    "owner": "yting27",
    "version": "1.0.2",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/global-holidays",
    "downloadUrl": "https://openagent3.xyz/downloads/global-holidays",
    "agentUrl": "https://openagent3.xyz/skills/global-holidays/agent",
    "manifestUrl": "https://openagent3.xyz/skills/global-holidays/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/global-holidays/agent.md"
  }
}