truetime
by cccat6
Coding Agents & IDEsBrief
Ensure real-time accurate scheduling and planning across UTC, server time, NTP-sourced time, user local time.
Description
What This Skill Does
TrueTime handles accurate time calculations across timezones, DST boundaries, and calendar units. It reads the current clock before computing, resolves to UTC first, and converts for display. Supports relative durations, absolute timestamps, cross-timezone coordination, Chinese lunar dates, and NTP as an alternative time source.
It computes through UTC first and verifies the delta before execution, preventing wrong-offset errors that come from naive datetime arithmetic or copy-pasted example values.
When to Use It
- Scheduling a cron job in 3 hours from Tokyo time
- Converting a London meeting time to US East coast
- Setting a reminder 1.5 months from now
- Planning a deadline that crosses a DST transition
- Checking a Chinese lunar date alongside a Gregorian timestamp
Example Workflow
User asks: Remind me in 45 minutes, I'm in New York
- 1
Extracts timing intent: 45 minutes, America/New_York
- 2
Runs true_time.mjs --plus 45m --user-tz America/New_York to get current and target times
- 3
Verifies target_utc minus now_utc equals 2700 seconds
- 4
Returns now_utc, target_utc, target_user_tz, delta_seconds, and time_source
Reminder confirmed for 45 minutes from now, shown in both UTC and America/New_York with delta verification
Installation
clawhub install cccat6/truetimeRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.