How to use the Pakistan Time Clock agent skill (time-skill)

What is an agent skill and what does time-skill do?

An agent skill is a folder containing a SKILL.md file that gives an AI agent extra instructions for a specific task. The agent reads the file when a request matches the skill's description.

time-skill is a small, single-purpose skill. When you ask for the time in Pakistan or PKT, it tells the agent to run one system command that reads the clock in the Asia/Karachi timezone. The agent then shows the result in a fixed format.

• Asks for: the current time, Pakistan time, or PKT
• Runs: TZ='Asia/Karachi' date '+%Y-%m-%d %H:%M:%S %Z'
• Replies with: Current Time in Pakistan (PKT): YYYY-MM-DD HH:MM:SS PKT (24-hour format, date included, no extra commentary)

How do you install time-skill?

Download the ZIP file for time-skill from our page. It contains the skill folder with SKILL.md.

For Claude Code, unzip the folder into ~/.claude/skills/ to make it available in all your projects, or into a project's .claude/skills/ folder to limit it to that project.

In the Claude apps, you can instead upload the ZIP under Settings → Capabilities → Skills.

• Personal install: unzip into ~/.claude/skills/
• Project install: unzip into the project's .claude/skills/ folder
• Claude apps: Settings → Capabilities → Skills, then upload the ZIP

How do you trigger time-skill with a natural request?

You do not need a special command. The skill's description tells the agent to use it when you ask for the current time, Pakistan time, or PKT. Phrase the request in plain language.

If the agent does not pick up the skill, name it directly in your message, for example by asking it to use the time-skill.

• What time is it in Pakistan?
• Give me the current PKT time.
• What's the time in PKT right now?
• Use the time-skill to tell me the Pakistan time.

What output should you expect?

The SKILL.md file asks for a fixed output format, so replies should look the same each time. The date and time are shown in 24-hour format with the timezone label PKT.

The example below shows the required format pattern, not a live reading.

What does time-skill need to run?

time-skill needs a bash-capable environment with the standard date command, and an agent runtime that supports SKILL.md skills. The source says it runs scripts and does not use the network.

Because it relies on the machine's system clock, the reading is only as accurate as that clock. Do not use it where a verified atomic clock or a legal timestamp is required.

• A bash-capable environment with the standard date command
• An agent runtime that supports SKILL.md skills
• Runs scripts: yes (one date command)
• Uses network: no

What are the safety notes?

The skill runs one shell command, so review the SKILL.md file before installing any skill, including this one. The command only reads the clock and sets the output timezone; it does not change files or send data, as shown in the source.

The skill only reports the current PKT time. It is not meant for converting times between many zones or scheduling events.

• Read SKILL.md before installing, since the skill runs a shell command
• The command reads the system clock with TZ='Asia/Karachi'
• Not suitable for scheduling or multi-zone conversion

What tips help you get the most out of it?

Ask in plain words and keep the request short, since the skill's output is meant to be concise.

If you need a time in another zone or a meeting time, ask the agent general questions separately. The skill itself will only return PKT.

• Keep requests short and specific
• Ask for PKT explicitly when you want the Pakistan time
• Use the skill as a simple example of how a skill runs a shell command