$npx -y skills add coleam00/custom-agent-with-skills --skill world_clockGet current time in any timezone and convert times between locations. Use when user asks about time in different cities, timezone conversions, or scheduling across timezones.
| 1 | # World Clock Skill |
| 2 | |
| 3 | Get the current time anywhere in the world and convert times between timezones. Useful for scheduling across timezones, checking times in other cities, and handling daylight saving time. |
| 4 | |
| 5 | ## When to Use |
| 6 | |
| 7 | - User asks "What time is it in [city]?" |
| 8 | - User needs to convert time between timezones |
| 9 | - User is scheduling a meeting across timezones |
| 10 | - User asks about daylight saving time |
| 11 | - User asks when business hours start/end in another timezone |
| 12 | |
| 13 | ## Available Operations |
| 14 | |
| 15 | 1. **Current Time**: Get the current time in any timezone |
| 16 | 2. **Time Conversion**: Convert a specific time from one timezone to another |
| 17 | 3. **DST Information**: Check if a location is currently in daylight saving time |
| 18 | 4. **Multiple Timezones**: Show current time in several locations at once |
| 19 | |
| 20 | ## Instructions |
| 21 | |
| 22 | When a user asks about time or timezones: |
| 23 | |
| 24 | ### Step 1: Identify the Request Type |
| 25 | |
| 26 | - **Current time query**: "What time is it in Tokyo?" |
| 27 | - **Conversion query**: "If it's 3pm in New York, what time is it in London?" |
| 28 | - **Scheduling query**: "When should I schedule a call for 9am PST for someone in Berlin?" |
| 29 | |
| 30 | ### Step 2: Get Timezone Identifier |
| 31 | |
| 32 | Use the WorldTimeAPI with the appropriate timezone identifier. |
| 33 | |
| 34 | **API Endpoint:** |
| 35 | ``` |
| 36 | https://worldtimeapi.org/api/timezone/{Area}/{Location} |
| 37 | ``` |
| 38 | |
| 39 | ### Step 3: Make the API Call |
| 40 | |
| 41 | **Example - Get Tokyo time:** |
| 42 | ``` |
| 43 | https://worldtimeapi.org/api/timezone/Asia/Tokyo |
| 44 | ``` |
| 45 | |
| 46 | **Example - Get New York time:** |
| 47 | ``` |
| 48 | https://worldtimeapi.org/api/timezone/America/New_York |
| 49 | ``` |
| 50 | |
| 51 | ### Step 4: Present Results |
| 52 | |
| 53 | Format clearly with: |
| 54 | - Current local time (12-hour and 24-hour format) |
| 55 | - Day of the week and date |
| 56 | - Timezone abbreviation (PST, EST, JST, etc.) |
| 57 | - UTC offset |
| 58 | - Whether DST is active |
| 59 | |
| 60 | ## Common Timezone Identifiers |
| 61 | |
| 62 | ### Americas |
| 63 | | City | Timezone ID | |
| 64 | |------|-------------| |
| 65 | | New York | `America/New_York` | |
| 66 | | Los Angeles | `America/Los_Angeles` | |
| 67 | | Chicago | `America/Chicago` | |
| 68 | | Denver | `America/Denver` | |
| 69 | | Toronto | `America/Toronto` | |
| 70 | | Vancouver | `America/Vancouver` | |
| 71 | | Mexico City | `America/Mexico_City` | |
| 72 | | Sao Paulo | `America/Sao_Paulo` | |
| 73 | | Buenos Aires | `America/Argentina/Buenos_Aires` | |
| 74 | |
| 75 | ### Europe |
| 76 | | City | Timezone ID | |
| 77 | |------|-------------| |
| 78 | | London | `Europe/London` | |
| 79 | | Paris | `Europe/Paris` | |
| 80 | | Berlin | `Europe/Berlin` | |
| 81 | | Amsterdam | `Europe/Amsterdam` | |
| 82 | | Rome | `Europe/Rome` | |
| 83 | | Madrid | `Europe/Madrid` | |
| 84 | | Moscow | `Europe/Moscow` | |
| 85 | | Istanbul | `Europe/Istanbul` | |
| 86 | | Dublin | `Europe/Dublin` | |
| 87 | |
| 88 | ### Asia & Pacific |
| 89 | | City | Timezone ID | |
| 90 | |------|-------------| |
| 91 | | Tokyo | `Asia/Tokyo` | |
| 92 | | Singapore | `Asia/Singapore` | |
| 93 | | Hong Kong | `Asia/Hong_Kong` | |
| 94 | | Shanghai | `Asia/Shanghai` | |
| 95 | | Beijing | `Asia/Shanghai` | |
| 96 | | Seoul | `Asia/Seoul` | |
| 97 | | Mumbai | `Asia/Kolkata` | |
| 98 | | Delhi | `Asia/Kolkata` | |
| 99 | | Dubai | `Asia/Dubai` | |
| 100 | | Sydney | `Australia/Sydney` | |
| 101 | | Melbourne | `Australia/Melbourne` | |
| 102 | | Auckland | `Pacific/Auckland` | |
| 103 | |
| 104 | ### Africa & Middle East |
| 105 | | City | Timezone ID | |
| 106 | |------|-------------| |
| 107 | | Cairo | `Africa/Cairo` | |
| 108 | | Johannesburg | `Africa/Johannesburg` | |
| 109 | | Lagos | `Africa/Lagos` | |
| 110 | | Tel Aviv | `Asia/Jerusalem` | |
| 111 | | Riyadh | `Asia/Riyadh` | |
| 112 | |
| 113 | ## Timezone Abbreviations Reference |
| 114 | |
| 115 | | Abbreviation | Full Name | UTC Offset | |
| 116 | |--------------|-----------|------------| |
| 117 | | PST | Pacific Standard Time | UTC-8 | |
| 118 | | PDT | Pacific Daylight Time | UTC-7 | |
| 119 | | MST | Mountain Standard Time | UTC-7 | |
| 120 | | MDT | Mountain Daylight Time | UTC-6 | |
| 121 | | CST | Central Standard Time | UTC-6 | |
| 122 | | CDT | Central Daylight Time | UTC-5 | |
| 123 | | EST | Eastern Standard Time | UTC-5 | |
| 124 | | EDT | Eastern Daylight Time | UTC-4 | |
| 125 | | GMT | Greenwich Mean Time | UTC+0 | |
| 126 | | BST | British Summer Time | UTC+1 | |
| 127 | | CET | Central European Time | UTC+1 | |
| 128 | | CEST | Central European Summer Time | UTC+2 | |
| 129 | | IST | India Standard Time | UTC+5:30 | |
| 130 | | JST | Japan Standard Time | UTC+9 | |
| 131 | | AEST | Australian Eastern Standard Time | UTC+10 | |
| 132 | | AEDT | Australian Eastern Daylight Time | UTC+11 | |
| 133 | |
| 134 | ## API Response Format |
| 135 | |
| 136 | The WorldTimeAPI returns: |
| 137 | |
| 138 | ```json |
| 139 | { |
| 140 | "abbreviation": "EST", |
| 141 | "datetime": "2024-01-15T14:30:00.123456-05:00", |
| 142 | "day_of_week": 1, |
| 143 | "day_of_year": 15, |
| 144 | "dst": false, |
| 145 | "dst_offset": 0, |
| 146 | "timezone": "America/New_York", |
| 147 | "unixtime": 1705343400, |
| 148 | "utc_datetime": "2024-01-15T19:30:00.123456+00:00", |
| 149 | "utc_offset": "-05:00", |
| 150 | "week_number": 3 |
| 151 | } |
| 152 | ``` |
| 153 | |
| 154 | **Key fields:** |
| 155 | - `datetime`: Current local time with offset |
| 156 | - `abbreviation`: Timezone abbreviation (EST, PST, etc.) |
| 157 | - `utc_offset`: Offset from UTC |
| 158 | - `dst`: Whether daylight saving time is active |
| 159 | - `day_of_week`: 0=Sunday, 1=Monday, etc. |
| 160 | |
| 161 | ## Examples |
| 162 | |
| 163 | ### Example 1: Current Time Query |
| 164 | User asks: "What time is it in Tokyo?" |
| 165 | |
| 166 | 1. Call: `https://worldtimeapi.org/api/timezone/Asia/Tokyo` |
| 167 | 2. Response format: |
| 168 | "It's currently **10:30 PM JST** (Japan Standard Time |