current-date
Gets, checks, and verifies the current UTC date and time for unambiguous temporal reference. Use when starting tasks, verifying temporal context, ensuring date awareness before time-sensitive operations, or when incorrect date assumptions are detected.
When & Why to Use This Skill
The Current Date skill is a vital utility designed to provide Claude agents with an unambiguous temporal reference by executing real-time bash commands. It solves the common problem of 'date hallucination' caused by model training cutoffs, ensuring that the agent operates with a verified UTC timestamp. This skill is essential for maintaining context accuracy in time-sensitive workflows, logging, and automated documentation.
Use Cases
- Task Initialization: Establishing a reliable 'ground truth' for the current date at the start of a session to prevent temporal errors.
- Automated Documentation: Generating accurate 'Last Verified' or 'Created On' timestamps for technical docs and version history.
- Time-Sensitive Operations: Managing deadlines, schedules, and expiration dates where precise day/time awareness is non-negotiable.
- Context Correction: Rectifying a model's incorrect assumptions about 'today' during long-running conversations or complex sub-agent tasks.
- File Management: Creating unique, time-stamped filenames (e.g., YYYYMMDD-HHMMSS) for logs, backups, or exports.
| name | current-date |
|---|---|
| description | Gets, checks, and verifies the current UTC date and time for unambiguous temporal reference. Use when starting tasks, verifying temporal context, ensuring date awareness before time-sensitive operations, or when incorrect date assumptions are detected. |
| allowed-tools | Bash |
Current Date
Get the current UTC date and time to ensure correct temporal context for all operations.
CRITICAL EXECUTION REQUIREMENT
This skill requires COMMAND EXECUTION, not assumption-based answers.
When this skill loads, you MUST:
- EXECUTE the bash command shown in Quick Start section below
- REPORT the actual command output (not an assumed date)
- NEVER state a date from memory or assumptions
- NEVER skip execution thinking "I know the date"
Why this matters: This skill exists precisely because date assumptions are unreliable. Model training cutoffs, context issues, and stale information mean assumptions about "today" are frequently wrong. The ONLY reliable source is executing the date command and reporting actual output.
Overview
This skill provides a simple, reliable way to verify the current date and time. It addresses situations where Claude Code or subagents may have incorrect assumptions about the current date due to model training cutoffs.
Why a dedicated skill?
- Date/time assumptions are unreliable due to model training cutoffs
- This skill enforces execution-based verification instead of guessing
- Essential for time-sensitive operations (deadlines, versioning, temporal ordering)
What this skill does NOT do:
- Time zone conversions
- Time arithmetic or duration calculations
- Date parsing or validation
When to Use This Skill
IMPORTANT: This is an execution-only skill. Always run the command; never state dates from memory.
Use this skill when:
- Starting a new task or conversation
- Working on time-sensitive operations (deadlines, schedules, versioning)
- Verifying temporal context before making date-based decisions
- Correcting date misunderstandings during a conversation
- Needed by subagents to establish correct date context
- Creating timestamps or version numbers
- Writing documentation with "Last Verified" dates
Quick Start
Get current UTC date and time:
date -u +"%Y-%m-%d %H:%M:%S UTC (%A)"
Expected output:
2025-11-09 18:31:10 UTC (Sunday)
Format explanation:
2025-11-09- ISO 8601 date format (YYYY-MM-DD)18:31:10- 24-hour time with seconds (UTC)UTC- Coordinated Universal Time(Sunday)- Day of week
Execution Checklist:
- Execute the command (don't assume the date)
- Verify output includes UTC timezone
- Report actual output (not paraphrased)
Usage Patterns
At Task Start
date -u +"%Y-%m-%d %H:%M:%S UTC (%A)"
# Then proceed with task...
For Documentation
date -u +"%Y-%m-%d"
# Use for "Last Verified" dates
For Timestamps
date -u +"%Y%m%d-%H%M%S"
# Use in filenames
Best Practices
- Always use UTC: Avoid timezone confusion
- Run at task start: Verify date when beginning time-sensitive work
- Share with subagents: Include current UTC date in Task agent prompts
- Use ISO 8601 format: Unambiguous, internationally recognized
Reference Loading Guide
Load on demand based on context:
| Reference | When to Load |
|---|---|
| references/platform-alternatives.md | Windows users, PowerShell needed |
| references/format-reference.md | Need alternative output formats |
| references/troubleshooting.md | Errors or issues occur |
| references/testing/evaluations.md | During skill testing or audit |
| references/testing/model-notes.md | Multi-model testing |
Version History
- v1.3.0 (2025-11-25): Refactored to hub + references architecture
- Extracted platform alternatives, format reference, troubleshooting to references/
- Extracted evaluations and model testing notes to references/testing/
- SKILL.md reduced from ~420 lines to ~140 lines (67% reduction)
- v1.2.0 (2025-11-19): Added Table of Contents, enhanced Overview
- v1.1.1 (2025-11-17): Added evaluations, multi-model testing notes
- v1.1.0 (2025-11-17): Added PowerShell alternatives, cross-platform docs
- v1.0.1 (2025-11-12): Added action verbs to description
- v1.0.0 (2025-11-09): Initial release
Last Updated
Date: 2025-11-28 Model: claude-opus-4-5-20251101