From d9b56d8f2e70c55d007412743bb6b869375a48f4 Mon Sep 17 00:00:00 2001
From: rootiest <chris@rootiest.com>
Date: Mon, 1 Jun 2026 16:32:28 -0400
Subject: [PATCH] feat: add date-time skill

Allows the AI to get the current system datetime and use it when
relevant in a conversation/task.
---
 descriptions.json         |  1 +
 skills/date-time/SKILL.md | 35 +++++++++++++++++++++++++++++++++++
 2 files changed, 36 insertions(+)
 create mode 100644 skills/date-time/SKILL.md

diff --git a/descriptions.json b/descriptions.json
index 2ebada2..de275d7 100644
--- a/descriptions.json
+++ b/descriptions.json
@@ -1,4 +1,5 @@
 {
+  "date-time": "Get the current date and time when it is relevant to the task at hand, and use it to make informed decisions.",
   "git-publish-workflow": "Automate the full lifecycle from uncommitted local work to an open Pull Request, with built-in quality gates.",
   "readme-sync-audit": "Keep README.md accurate by programmatically aligning it with the current state of the codebase.",
   "ship-it": "Run a comprehensive pre-flight audit and publish changes to a new PR in a single command.",
diff --git a/skills/date-time/SKILL.md b/skills/date-time/SKILL.md
new file mode 100644
index 0000000..f3f9c41
--- /dev/null
+++ b/skills/date-time/SKILL.md
@@ -0,0 +1,35 @@
+# Skill Name: Current Date and Time Retrieval
+
+## Purpose
+Enables the assistant to retrieve the exact, real-time current date and time when addressing time-sensitive queries, scheduling tasks, calculating durations, or validating chronological context.
+
+## Trigger Conditions
+Activate this skill whenever the user's prompt:
+* Explicitly asks for the current date, day, time, or year.
+* References relative time expressions (e.g., "today", "yesterday", "next week", "recently").
+* Requires checking if an event has already occurred or is upcoming relative to the present moment.
+* Needs to calculate an age, duration, or countdown from the present day.
+
+## Tool Definition
+
+### `get_current_datetime`
+* **Description**: Executes the system `date` command to fetch the current local timestamp, timezone, and calendar date.
+* **Parameters**: None required.
+
+## Execution Workflow
+1. **Detect**: Recognize a time-sensitive trigger in the user's input.
+2. **Call**: Invoke the `get_current_datetime` tool before generating the final response.
+3. **Process**: Use the returned timestamp to anchor your temporal reasoning.
+4. **Respond**: Deliver an accurate answer reflecting the retrieved date/time naturally, without explicitly explaining that a tool was used unless asked.
+
+## Examples
+
+### Example 1
+* **User**: "What day of the week is it today?"
+* **Assistant Action**: Invoke `get_current_datetime`.
+* **Response**: "Today is [Day of Week], [Date]."
+
+### Example 2
+* **User**: "Is the 2026 World Cup happening this month?"
+* **Assistant Action**: Invoke `get_current_datetime`.
+* **Response**: Evaluates current month/year against the tournament schedule to provide an accurate "yes/no" or countdown.