time — Claude Code skill: what it does, how to install
Checks current time across IANA timezones and converts hours between regions via a standalone Python CLI script.
MIT 1 installs ★ 64 updated 2026-10-27
npx skills add Dianel555/DSkills --skill time -a claude-codeWhat time does
The skill runs scripts/time_cli.py directly in Bash without relying on an MCP server. It handles two operations: reading current local time with daylight saving status and converting 24-hour time values between two regions.
Responses arrive as structured JSON objects containing ISO 8601 timestamps, daylight saving flags, and computed hour offsets. The CLI can also print available IANA identifiers filtered by region keyword.
Execution relies on Python 3.9+ with native zoneinfo or a separate pip install pytz package. Passing casual city names instead of standard IANA identifiers will trigger an error.
What it helps with
- retrieve current timestamp and DST status for an IANA location
- convert meeting hours between two regions in 24-hour format
- list available timezone identifiers filtered by continent name
- calculate exact time differences for multi-region scheduling
Example prompts for the agent
- What is the current time in
Asia/Shanghai? - List all available timezone names filtered by
Europe. - Convert 16:30 from
America/New_YorktoAsia/Tokyo.
How to install time
1Skills CLI (Vercel)
npx skills add Dianel555/DSkills --skill time -a claude-code2Manually: put the files in place
~/.claude/skills/time/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/time/
1Skills CLI (Vercel)
npx skills add Dianel555/DSkills --skill time -a codex2Manually: put the files in place
.agents/skills/time/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add Dianel555/DSkills --skill time -a cursor2Manually: put the files in place
.cursor/skills/time/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install Dianel555/DSkills skills/time2Manually: put the files in place
.github/skills/time/SKILL.md1Skills CLI (Vercel)
npx skills add Dianel555/DSkills --skill time -a gemini-cli2Platform CLI
gemini skills install https://github.com/Dianel555/DSkills --path skills/timeManually: put the files in place
.devin/skills/time/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add Dianel555/DSkills --skill time -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about time
How to install time in Claude Code?
Run npx skills add Dianel555/DSkills --skill time -a claude-code in your terminal. The configuration is stored at ~/.claude/skills/time/SKILL.md.
What does the time skill do?
It queries the current local time in any standard IANA timezone and calculates offsets when translating hours between different regions.
What dependencies are required?
You need Python 3.9+ with built-in zoneinfo. On older Python versions, install the pytz package using pip install pytz.
Source text
SKILL.md · MIT
---
name: time
description: |
Time and timezone utilities for getting current time and converting between timezones. Use when: (1) Getting current time in any timezone, (2) Converting time between different timezones, (3) Working with IANA timezone names, (4) Scheduling across timezones, (5) Time-sensitive operations. Triggers: "what time is it", "current time", "convert time", "timezone", "time in [city]".
---
# Time
Time and timezone conversion utilities. Standalone CLI only (no MCP dependency).
## Execution Methods
Run `scripts/time_cli.py` via Bash:
```bash
# Prerequisites: pip install pytz (or use Python 3.9+ with zoneinfo)
# Get current time in a timezone
python scripts/time_cli.py get --timezone "Asia/Shanghai"
python scripts/time_cli.py get --timezone "America/New_York"
python scripts/time_cli.py get # Uses system timezone
# Convert time between timezones
python scripts/time_cli.py convert \
--time "16:30" \
--from "America/New_York" \
--to "Asia/Tokyo"
# List available timezones
python scripts/time_cli.py list [--filter "Asia"]
```
## Tool Capability Matrix
| Tool | Parameters | Output |
|------|------------|--------|
| `get_current_time` | `timezone` (required, IANA name) | `{timezone, datetime, is_dst}` |
| `convert_time` | `source_timezone`, `time` (HH:MM), `target_timezone` | `{source, target, time_difference}` |
## Common IANA Timezone Names
| Region | Timezone |
|--------|----------|
| China | `Asia/Shanghai` |
| Japan | `Asia/Tokyo` |
| Korea | `Asia/Seoul` |
| US East | `America/New_York` |
| US West | `America/Los_Angeles` |
| UK | `Europe/London` |
| Germany | `Europe/Berlin` |
| France | `Europe/Paris` |
| Australia | `Australia/Sydney` |
| UTC | `UTC` |
## Workflow
### Getting Current Time
1. Identify target timezone (use IANA name)
2. Call `get_current_time` with timezone parameter
3. Response includes ISO 8601 datetime and DST status
### Converting Time
1. Identify source timezone and time (24-hour format HH:MM)
2. Identify target timezone
3. Call `convert_time` with all parameters
4. Response includes both times and time difference
## Output Format
### get_current_time Response
```json
{
"timezone": "Asia/Shanghai",
"datetime": "2024-01-01T21:00:00+08:00",
"is_dst": false
}
```
### convert_time Response
```json
{
"source": {
"timezone": "America/New_York",
"datetime": "2024-01-01T16:30:00-05:00",
"is_dst": false
},
"target": {
"timezone": "Asia/Tokyo",
"datetime": "2024-01-02T06:30:00+09:00",
"is_dst": false
},
"time_difference": "+14.0h"
}
```
## Error Handling
| Error | Recovery |
|-------|----------|
| Invalid timezone | Check IANA timezone name spelling |
| Invalid time format | Use 24-hour format HH:MM |
| MCP unavailable | Fall back to CLI script |
## Anti-Patterns
| Prohibited | Correct |
|------------|---------|
| Use city names directly | Use IANA timezone names (e.g., `Asia/Tokyo` not `Tokyo`) |
| Use 12-hour format | Use 24-hour format (e.g., `16:30` not `4:30 PM`) |
| Assume timezone | Always specify timezone explicitly |
© Dianel555 · MIT · Dianel555/DSkills