temporal-evaluation

What problem does it solve?

This skill provides automated evaluation of task timing, classifying tasks by overdue, urgent, upcoming, and soon statuses and generating human-friendly relative time displays to support time management and prioritization.

Core Features & Use Cases

• Temporal status calculation: Determine overdue, urgent, upcoming, and soon for each task based on due dates.
• Timezone-aware comparisons: All time math respects the user's local timezone to avoid misclassifications.
• Relative time display: Produce human-friendly strings like "in 2 hours" or "3 days ago" for task due dates.
• Continuous evaluation: Update statuses on a 60-second interval and on task creation or modification.
• Display integration: Provide status data for prioritization, notifications, filtering, and sorting.

Quick Start

Configure your app to evaluate temporal status every 60 seconds and whenever a task's due date is created or updated. Use the status utility to annotate tasks (temporalStatus) and the relativeTime helper to render human-friendly strings.