datetime

# DateTime Natural Language Parser

Parse natural language date and time expressions using GNU `date` command (native Linux utility).

## IMPORTANT: For Claude Code

**DO NOT invoke slash commands** (`/datetime:parse`, `/datetime:now`, `/datetime:calc`) - those are for users only.

**Instead, use the `date` command directly via the Bash tool:**

```bash
# Get current date/time
date '+%Y-%m-%d %H:%M:%S (%A)'

# Parse natural language
date -d "tomorrow" '+%Y-%m-%d %H:%M:%S (%A)'
date -d "next monday at 9am" '+%Y-%m-%d %H:%M:%S (%A)'
date -d "3 days" '+%Y-%m-%d %H:%M:%S (%A)'
```

This skill provides the command patterns and when to use them. The slash commands are for users to invoke manually.

## Quick Example

```bash
date -d "next Friday" '+%Y-%m-%d %H:%M:%S (%A)'
# 2026-02-06 00:00:00 (Friday)
```

## When to Use This Skill

Automatically invoke when:
- User mentions temporal expressions: "tomorrow", "next week", "in 3 days"
- Need to verify current date/time
- User references deadlines or time-sensitive tasks
- <env> context shows incorrect dates

## How to Use

Use the Bash tool with `date -d` command:

**Get current date/time:**
```bash
date '+%Y-%m-%d %H:%M:%S (%A)'
```

**Parse natural language:**
```bash
date -d "tomorrow" '+%Y-%m-%d %H:%M:%S (%A)'
date -d "next wednesday" '+%Y-%m-%d %H:%M:%S (%A)'
date -d "3 days" '+%Y-%m-%d %H:%M:%S (%A)'
date -d "next monday 9am" '+%Y-%m-%d %H:%M:%S (%A)'
```

**Important**: The `date` command doesn't understand "in" keyword. When user says "in 3 days", use `"3 days"` instead.

## Output Format

Returns single line: `YYYY-MM-DD HH:MM:SS (DayName)`

Example: `2024-10-29 14:23:45 (Tuesday)`

## Supported Expressions

- Relative: "today", "tomorrow", "yesterday"
- Named days: "next monday", "this wednesday", "last friday"
- Offsets: "3 days", "2 weeks", "5 months ago"
- Complex: "tomorrow 3pm", "next monday at 9am"
- Past: "3 days ago", "last week"

## Error Handling

If `date -d` fails with an invalid expression:

1. **Reco