relative-time-formatter

Convert absolute timestamps into relative time expressions for UI display.

Updated May 15, 2026
One-click install
npx skills add https://github.com/ruskibeats/t1d --skill relative-time-formatter
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: relative-time-formatter
Source: https://github.com/ruskibeats/t1d/tree/main/.pi/skills-archive/relative-time-formatter
Command: npx skills add https://github.com/ruskibeats/t1d --skill relative-time-formatter

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill addresses the challenge of displaying timestamps in a user-friendly, relative format for UI activity timestamps, enhancing the user experience by providing immediate recency cues.

Core Features & Use Cases

  • Relative Time Formatting: Converts timestamps into relative time expressions like "just now", "5m ago", "2h ago", and "11:48" for today's events, and "05-20" for older events.
  • UI Activity Timestamps: Ideal for terminal UIs, boards, dashboards, and activity logs where absolute dates are less useful than recency cues.
  • Use Case: When displaying the last activity on a dashboard, instead of showing "2026-05-21T10:30:00Z", show "just now" or "5m ago" for a more intuitive user interface.

Quick Start

Use the relative-time-formatter skill to format the last activity timestamp from a task.

Frequently Asked Questions about relative-time-formatter

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

FAQPage Schema
How do I format timestamps into relative time for UI activity display?

To format timestamps into relative time for UI activity display, this Skill converts absolute timestamps into relative expressions like "just now" or "5m ago". It uses Python date-time calculations to provide immediate recency cues for terminal UIs, dashboards, and activity logs.

What is relative time formatting and when do I need it for a dashboard?

Relative time formatting converts absolute timestamps into intuitive expressions such as "2h ago" for today or "05-20" for older events. You need it for dashboards and activity logs where users benefit from immediate recency cues rather than parsing raw date-time strings.

Do I need Python to convert timestamps into relative time expressions?

Yes, you need Python to convert timestamps into relative time expressions with this Skill. It relies on Python execution and date-time calculations to transform absolute timestamps into UI-friendly relative formats without requiring any external dependencies.

Can I use relative time formatting for terminal UIs and activity logs?

Yes, you can use relative time formatting for terminal UIs and activity logs. This Skill is specifically designed for boards, dashboards, and terminal interfaces, converting timestamps like "2026-05-21T10:30:00Z" into user-friendly recency cues such as "just now".

What is the best way to show recency cues instead of absolute dates in Python?

The best way to show recency cues instead of absolute dates in Python is using a dedicated relative time formatter. This Skill automatically applies contextual rules, showing "just now" for recent events, "5m ago" for past hours, and "05-20" for older dates.

What are the limitations of relative time formatting for timestamps?

A limitation of relative time formatting for timestamps is its focus on UI activity display rather than precise chronological tracking. It converts absolute dates into approximate recency cues like "2h ago", which may lack the exact precision needed for strict audit logging.