Timezone Toolkit

Convert times between timezones, show world clocks, find meeting overlap across zones, and look up UTC offsets and DST status. Use when converting between ti...

Security Scan

The skill's code, instructions, and requirements are consistent with a local timezone conversion/meeting-planning tool and do not request unrelated credentials or network access.

Purpose & Capability

Name/description match the included Python script and SKILL.md. The code implements convert/now/meeting/list/offset functionality using Python's zoneinfo and common aliases; nothing requested or installed is disproportionate to the stated purpose.

Instruction Scope

SKILL.md instructs the agent to run the bundled Python script with obvious CLI arguments. The script operates on local time data, does not read arbitrary files, environment variables, or external endpoints, and exits on parse/lookup failures. No scope creep detected.

Install Mechanism

No install spec (instruction-only). However, the skill includes a runnable script (scripts/timezone_toolkit.py) that will be executed when invoked. This is expected for an instruction-only tool but means the included code will run on the host when used—no network downloads or package installs are performed.

Credentials

The skill declares no environment variables, credentials, or config paths. The script likewise does not access secrets or external services.

Persistence & Privilege

always is false and there is no request to modify other skills or system-wide configs. The skill runs only when invoked.

Assessment

This skill appears to be what it claims: a local timezone toolkit implemented in Python. Before installing/using: 1) Ensure you run it with a trusted Python interpreter (it requires Python 3.9+ for zoneinfo). 2) Review the included script if you are on a shared or sensitive machine—although the code is short and local-only, running any bundled script executes code as your user. 3) Note a few behavioral details: common abbreviations (e.g., CST) map to specific zones (CST→America/Chicago; there is a separate CST_CN alias for Asia/Shanghai), time-only inputs use today's date, parse errors or unknown timezones cause the script to exit with an error, and the list command writes the final count to stderr. If those behaviors are acceptable, the skill is reasonable to install and use.

Convert times, show world clocks, find meeting overlaps, and check offsets. Zero dependencies (Python 3.9+).

Quick Start

# Convert time between zones
python3 scripts/timezone_toolkit.py convert 15:30 --from EST --to PST JST UTC

# World clock (default cities)
python3 scripts/timezone_toolkit.py now

# Find meeting overlap
python3 scripts/timezone_toolkit.py meeting EST PST JST

Commands

convert

Convert a time from one timezone to one or more others:

python3 scripts/timezone_toolkit.py convert "3:30 PM" --from PST --to EST IST
python3 scripts/timezone_toolkit.py convert now --from UTC --to EST PST JST
python3 scripts/timezone_toolkit.py convert 2026-03-15T10:00 --from EST --to GMT

Accepts: HH:MM, H:MM AM/PM, YYYY-MM-DD HH:MM, now.

now

Show current time across timezones:

python3 scripts/timezone_toolkit.py now                    # Major world cities
python3 scripts/timezone_toolkit.py now EST PST Tokyo London

meeting

Find overlapping work hours between timezones:

python3 scripts/timezone_toolkit.py meeting EST IST JST
python3 scripts/timezone_toolkit.py meeting EST PST --start 8 --end 18

list

List available timezones with optional filter:

python3 scripts/timezone_toolkit.py list --filter America
python3 scripts/timezone_toolkit.py list --filter Asia

offset

Show UTC offset and DST status for a timezone:

python3 scripts/timezone_toolkit.py offset Asia/Tokyo
python3 scripts/timezone_toolkit.py offset EST

Aliases

Supports common abbreviations: EST, PST, CST, MST, GMT, UTC, BST, CET, IST, JST, KST, SGT, HKT, AEST, NZST, BRT, ART, and more.