timezone-tools
Get current time in any timezone and convert times between timezones. Use when working with time, dates, timezones, scheduling across regions, "what time is it in X", "convert 3pm Sydney to London", DST checks, or when the user mentions specific cities/regions for time queries. Supports IANA timezone names. Do NOT use for date arithmetic (adding days/months), recurring event scheduling, business-day calculations, or full calendar/booking logic - those need a dedicated date library or scheduling tool.
How do I install this agent skill?
npx skills add https://github.com/henkisdabro/wookstar-claude-plugins --skill timezone-toolsIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The timezone-tools skill provides local Python scripts for checking current times and converting between timezones using the IANA database. It uses standard Python libraries for all calculations and does not perform any network operations or sensitive file access.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
- Runlayerwarn
6/6 files flagged
What does this agent skill do?
Timezone Tools
Three standard-library Python scripts (3.9+, zoneinfo) over the IANA timezone database. Nothing to install on macOS or Linux.
Steps
-
Resolve each place to an IANA name (
America/New_York, notEST). If unsure, search:python3 "${CLAUDE_SKILL_DIR}/scripts/list_timezones.py" "perth"Done when every place in the question maps to one IANA name. data/common_timezones.json lists major cities.
-
Current time ("what time is it in Tokyo?"):
python3 "${CLAUDE_SKILL_DIR}/scripts/get_time.py" "Asia/Tokyo"Prints timezone, ISO datetime, weekday and DST status.
-
Conversion ("2pm New York in Perth?"): source zone, 24-hour
HH:MM, target zone, then an optionalYYYY-MM-DDdate of the source time:python3 "${CLAUDE_SKILL_DIR}/scripts/convert_time.py" "America/New_York" "14:00" "Australia/Perth" 2026-11-02Without the date the time is taken as today in the source zone. Pass the date whenever the question is about a specific day - offsets change at DST boundaries, so today's offset can be wrong for next week's meeting. Prints source and target datetimes with weekday, DST status, and the difference in hours.
On a DST changeover day the script adds a
Warning:line: a skipped time (clocks forward) is shifted to the real time it lands on, and a repeated time (clocks back) shows both readings and uses the first. Pass that warning on to the user.
Done when the answer quotes the script's output time, including the weekday if it crosses midnight.
Example
python3 "${CLAUDE_SKILL_DIR}/scripts/convert_time.py" "America/New_York" "14:00" "Australia/Perth" 2026-11-02
# Source: America/New_York - 2026-11-02T14:00:00-05:00 (Monday, DST: No)
# Target: Australia/Perth - 2026-11-03T03:00:00+08:00 (Tuesday, DST: No)
# Time difference: +13.0h
Troubleshooting
- "Invalid timezone" - use an IANA name; search with
list_timezones.py. On Windows, which ships no IANA database,zoneinfoneeds thetzdatapackage: run the scripts asuv run --with tzdata python .... - "Invalid time format" - 24-hour
HH:MM:14:30, not2:30 PM. - "Invalid date format" -
YYYY-MM-DD.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/henkisdabro/wookstar-claude-plugins/timezone-tools">View timezone-tools on skillZs</a>