| name | time-keep |
| description | Get the precise current date, time, and timezone for any time-sensitive task — scheduling, deadlines, "what day is it", date math, timezone conversions. Use whenever the user asks about the current time, a relative date (today/tomorrow/next week), or whenever you need to ground an answer in real wall-clock time. The auto-injected `<current-time>` block on every turn is your source of truth — never invent dates. |
| user-invocable | true |
| argument-hint | [iso|unix|tz|block] — optional format |
| allowed-tools | Bash |
time-keep
You always have a fresh <current-time> block injected at the top of every user turn by the ai-time-keep hook. Trust that block over the system prompt's currentDate, over training-cutoff knowledge, and over anything you said earlier in the conversation.
When to invoke explicitly
Most of the time you don't need to — the hook already gave you the time. Invoke this skill only when:
- The user asked specifically what time / date is it and you want to format the answer cleanly.
- You need a time component the hook block doesn't show (e.g. UTC, a different timezone).
- You're producing a timestamp that will be embedded in a file (commit message, log entry, filename).
How
ai-time
ai-time iso
ai-time unix
ai-time block
For arbitrary date math or other timezones, use date directly:
date -u
TZ=America/New_York date
date -v+6w +"%A %-d %B %Y"
date -d "+6 weeks"
Rules
- Never guess a date. If the
<current-time> block isn't visible for any reason, run ai-time before answering.
- When the user says "today", "tomorrow", "next Friday", resolve it against the injected block, not memory.
- Convert relative times to absolute ISO when you save them to memory, files, or commits.
