system-time

Get accurate system time in various formats and timezones. Use when the user needs to know the current time, date, timestamp, or wants to convert between tim...

Security Scan

Instructions only; the skill's requirements and commands are consistent with a simple 'get system time and convert timezones' utility and do not request extra credentials or installs.

Purpose & Capability

The name/description (system time and timezone conversion) matches the instructions: shell date commands, TZ environment usage, listing zoneinfo, and a small Python snippet. No unrelated credentials, binaries, or installs are requested.

Instruction Scope

SKILL.md only instructs running local date commands, setting TZ, listing /usr/share/zoneinfo, and running a short Python snippet for time formats—these stay within the stated purpose and do not ask for unrelated file reads or network exfiltration.

Install Mechanism

No install spec or code files are present; this is instruction-only so nothing will be written to disk by an installer.

Credentials

No environment variables, credentials, or config paths are required beyond using TZ temporarily in commands; requested access is proportional to the task.

Persistence & Privilege

Skill is not always-enabled and does not request persistent presence or modify other skills/system settings. It only instructs transient local commands.

Assessment

This is an instruction-only skill that runs local date and simple Python commands to show/convert times and may list your system's zoneinfo directory. It does not request credentials, install software, or make network calls. If you permit the agent to execute shell/Python commands, it will run these local commands; if you prefer no local execution, do not invoke the skill or restrict the agent's execution privileges. Also note timezone data paths may differ on non-Linux systems (e.g., macOS or minimal containers).

Get accurate system time information in multiple formats.

Quick Usage

Current Time (Local)

date                                    # Human readable
date -Iseconds                          # ISO 8601 with seconds
date +%s                                # Unix timestamp

Current Time (UTC)

date -u                                 # UTC human readable
date -u -Iseconds                       # UTC ISO 8601
date -u +%s                             # UTC Unix timestamp (same as local)

Specific Timezone

TZ=Asia/Shanghai date                   # Shanghai time
TZ=America/New_York date                # New York time
TZ=Europe/London date                   # London time

Common Formats

Format	Command	Example Output
ISO 8601	date -Iseconds	2024-03-11T16:30:00+08:00
Unix timestamp	date +%s	1710145800
RFC 2822	date -R	Mon, 11 Mar 2024 16:30:00 +0800
Custom	date "+%Y-%m-%d %H:%M:%S"	2024-03-11 16:30:00

Timezone Conversion

Convert from one timezone to another:

# Convert specific time from Shanghai to New York
TZ=America/New_York date -d "2024-03-11 16:30:00 CST"

# List available timezones
ls /usr/share/zoneinfo/

Python Alternative (for scripting)

from datetime import datetime, timezone

# Current UTC time
utc_now = datetime.now(timezone.utc)
print(utc_now.isoformat())

# Current local time
local_now = datetime.now()
print(local_now.isoformat())

# Unix timestamp
print(int(utc_now.timestamp()))

Notes

• Unix timestamp is always UTC (timezone-independent)
• ISO 8601 format includes timezone offset
• Use timedatectl on Linux systems for system clock info