temporal-evaluation

Calculate time-based task statuses with timezone-aware comparisons and relative time formatting.

3|Updated Dec 14, 2025
One-click install
npx skills add https://github.com/Syedaashnaghazanfar/full-stack-todo-app --skill temporal-evaluation
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: temporal-evaluation
Source: https://github.com/Syedaashnaghazanfar/full-stack-todo-app/tree/main/.claude/skills/temporal-evaluation
Command: npx skills add https://github.com/Syedaashnaghazanfar/full-stack-todo-app --skill temporal-evaluation

SYSTEM DOCUMENTATION & REQUIREMENTS

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.

Frequently Asked Questions about temporal-evaluation

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automatically classify tasks as overdue or upcoming based on due dates?

Temporal evaluation classifies tasks into overdue, urgent, upcoming, and soon statuses by comparing due dates against the current time. Configure periodic evaluation every 60 seconds and on task creation or update to keep statuses current and support prioritization workflows.

Can I display task due dates in relative time format like "in 2 hours" or "3 days ago"?

Yes, the skill generates human-friendly relative time strings automatically. Use the relativeTime helper to render due dates as readable phrases, making task timing immediately clear without requiring users to calculate time differences manually.

Does temporal task status work correctly across different timezones?

Temporal evaluation performs all time comparisons with full timezone awareness, respecting each user's local timezone. This prevents misclassification of task urgency and ensures overdue and upcoming statuses remain accurate regardless of geographic location.

How do I handle tasks that don't have due dates assigned?

The skill includes safe handling for tasks without due dates, preventing errors during status calculation. Tasks missing due dates are excluded from temporal classification while remaining accessible for other task management operations.

What happens if I need task status to update continuously throughout the day?

The skill supports continuous evaluation through automatic 60-second interval updates plus immediate recalculation whenever a task's due date is created or modified. This ensures status displays and urgency indicators reflect real-time changes without manual refresh.

Can I use temporal status data for filtering, sorting, or notification triggers?

Yes, temporal status output integrates with display components for prioritization, filtering, sorting, and notifications. The calculated statuses enable you to build workflows that automatically highlight urgent tasks, trigger alerts, or reorder task lists based on time urgency.