Skip to content

ShaunTsai/skill-current-time

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 

Repository files navigation

skill-current-time

An Agent Skill that gives coding agents accurate current date, time, and timezone information using portable POSIX command-line tools.

Built on Kiro, but compatible with any coding agent that supports the Agent Skills specification.

Why this exists

Many coding agents lack reliable awareness of the current time and timezone. This skill provides a zero-dependency, cross-platform solution using the POSIX date command — no runtimes, no packages, no API keys.

What it does

  • Reports current date and time with timezone offset (ISO 8601)
  • Provides epoch (Unix) timestamps
  • Detects system timezone configuration
  • Converts between time formats
  • Works on macOS, Linux, FreeBSD, and any POSIX-compliant system

Requirements

  • A POSIX-compliant date command (ships with every Unix-like OS)
  • No external dependencies

Installation

Kiro

Copy the skill folder into your Kiro skills directory:

cp -r current-time/ ~/.kiro/skills/current-time/

The skill will automatically activate when you ask about time, date, timezone, or timestamps.

Other Agent Skill-compatible agents

Place the current-time/ directory (containing SKILL.md) into your agent's designated skills folder. Refer to your agent's documentation for the exact path.

The skill follows the Agent Skills specification, so any agent that supports this standard can pick it up.

Usage

Once installed, the skill activates on natural language prompts like:

  • "What time is it?"
  • "What's the current epoch timestamp?"
  • "What timezone am I in?"
  • "Give me today's date in ISO 8601"
  • "What day of the week is it?"
  • "Show me the current time in UTC"

The agent will use the appropriate date command from the skill's instructions and return the result.

Supported formats

Format Command Example output
ISO 8601 date '+%Y-%m-%dT%H:%M:%S%z' 2026-02-12T00:00:57+0800
Human-readable date '+%Y-%m-%d %H:%M:%S %Z' 2026-02-12 00:00:57 CST
Date only date '+%Y-%m-%d' 2026-02-12
Epoch seconds date '+%s' 1770825657
UTC date -u '+%Y-%m-%dT%H:%M:%SZ' 2026-02-11T16:00:57Z
Day of week date '+%A' Thursday

License

MIT

About

Agent Skill for current time and timezone — built on Kiro, compatible with any agent supporting the Agent Skills spec

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors