How do I install the Temporal skill?

Run npx skillmds@latest add gabrielmoreira/temporal in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Temporal safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Temporal?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Temporal free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Temporal?

gabrielmoreira (@gabrielmoreira) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Temporal by gabrielmoreira — Agent Skill

Name: Temporal
Rating: 4.5 (4 reviews)
Author: gabrielmoreira

Temporal

Resolve ANY named time window — today, yesterday, thisWeek, lastWeek, last7Days, last30Days, last90Days, thisMonth, lastMonth, thisQuarter, lastQuarter, thisYear, lastYear, last12Months — or an arbitrary range (lastNdays / lastNweeks / lastNmonths) to a concrete ISO date range relative to your run time. Read-only: no writes, no network. Use whenever a task is time-scoped and you need exact start/end dates without computing them by hand.

gabrielmoreira Updated Sep 21, 2026 17 repo stars

File contents

/temporal — concrete date ranges, relative to now

This is the single source of truth for "what dates does mean right now?". It resolves named windows to concrete ISO date ranges relative to your run time (new Date() at the moment you invoke it), so you never re-derive dates manually. It only reads the clock and prints — no files written, no network.

Run it

# all windows at once (a quick temporal-context dump)
node "$AGENT_DIR/.claude/skills/temporal/when.mjs"

# one or several specific windows
node "$AGENT_DIR/.claude/skills/temporal/when.mjs" last30Days thisQuarter

# JSON only (machine-readable), or list the supported keywords
node "$AGENT_DIR/.claude/skills/temporal/when.mjs" --json last7Days
node "$AGENT_DIR/.claude/skills/temporal/when.mjs" --list

If $AGENT_DIR is somehow unset, the script also lives under ~/.claude/skills/temporal/when.mjs.

Windows

Keyword	Meaning
`today` / `yesterday`	the single civil day
`thisWeek` / `lastWeek`	ISO week (Mon-start); this = Mon→today, last = the full prior Mon→Sun
`last7Days` / `last30Days` / `last90Days`	rolling N-day window ending today (inclusive)
`thisMonth` / `lastMonth`	this = 1st→today; last = the full prior calendar month
`thisQuarter` / `lastQuarter`	this = quarter-start→today; last = the full prior quarter
`thisYear` / `lastYear`	this = Jan 1→today (YTD); last = the full prior year
`last12Months`	rolling 12 months ending today
`lastNdays` / `lastNweeks` / `lastNmonths`	arbitrary rolling window, e.g. `last45days`, `last2weeks`, `last6months`

Aliases: ytd, qtd, mtd, wtd, 7d, 30d, 90d, 12m.

Convention: this* windows are period-start → today (to-date); last* named periods are the full prior complete period.

Output

Each window prints a human line plus a JSON record:

start / end — inclusive civil dates (YYYY-MM-DD) in your local timezone
startUtc / endExclusiveUtc — the same span as a half-open [start, end) range of exact UTC instants, ideal for timestamp / createdAt-style queries
days, inclusive, timezone, tzOffsetMinutes, asOf — span, tz, and the instant the range was resolved

Use the returned dates as the time bounds for the task. The named shortcuts /today, /yesterday, /last30Days, /lastQuarter, … each call this same resolver for their one window.

---name: temporaldescription: Resolve ANY named time window — today, yesterday, thisWeek, lastWeek, last7Days, last30Days, last90Days, thisMonth, lastMonth, thisQuarter, lastQuarter, thisYear, lastYear, last12Months — or an arbitrary range (lastNdays / lastNweeks / lastNmonths) to a concrete ISO date range relative to your run time. Read-only: no writes, no network. Use whenever a task is time-scoped and you need exact start/end dates without computing them by hand.---## /temporal — concrete date ranges, relative to nowThis is the single source of truth for "what dates does *<window>* mean rightnow?". It resolves named windows to **concrete ISO date ranges relative to yourrun time** (`new Date()` at the moment you invoke it), so you never re-derivedates manually. It only reads the clock and prints — no files written, no network.### Run it```bash# all windows at once (a quick temporal-context dump)node "$AGENT_DIR/.claude/skills/temporal/when.mjs"# one or several specific windowsnode "$AGENT_DIR/.claude/skills/temporal/when.mjs" last30Days thisQuarter# JSON only (machine-readable), or list the supported keywordsnode "$AGENT_DIR/.claude/skills/temporal/when.mjs" --json last7Daysnode "$AGENT_DIR/.claude/skills/temporal/when.mjs" --list```If `$AGENT_DIR` is somehow unset, the script also lives under`~/.claude/skills/temporal/when.mjs`.### Windows| Keyword | Meaning || --- | --- || `today` / `yesterday` | the single civil day || `thisWeek` / `lastWeek` | ISO week (Mon-start); *this* = Mon→today, *last* = the full prior Mon→Sun || `last7Days` / `last30Days` / `last90Days` | rolling N-day window ending today (inclusive) || `thisMonth` / `lastMonth` | *this* = 1st→today; *last* = the full prior calendar month || `thisQuarter` / `lastQuarter` | *this* = quarter-start→today; *last* = the full prior quarter || `thisYear` / `lastYear` | *this* = Jan 1→today (YTD); *last* = the full prior year || `last12Months` | rolling 12 months ending today || `lastNdays` / `lastNweeks` / `lastNmonths` | arbitrary rolling window, e.g. `last45days`, `last2weeks`, `last6months` |Aliases: `ytd`, `qtd`, `mtd`, `wtd`, `7d`, `30d`, `90d`, `12m`.Convention: `this*` windows are **period-start → today** (to-date); `last*`named periods are the **full prior complete period**.### OutputEach window prints a human line plus a JSON record:- `start` / `end` — inclusive civil dates (`YYYY-MM-DD`) in your local timezone- `startUtc` / `endExclusiveUtc` — the same span as a half-open `[start, end)` range of exact UTC instants, ideal for timestamp / `createdAt`-style queries- `days`, `inclusive`, `timezone`, `tzOffsetMinutes`, `asOf` — span, tz, and the instant the range was resolvedUse the returned dates as the time bounds for the task. The named shortcuts`/today`, `/yesterday`, `/last30Days`, `/lastQuarter`, … each call this sameresolver for their one window.

Frequently asked questions