time

Motto: Time flows as the story requires.

⭐4stars🔀1forks📁View on GitHub🕐Updated Jan 11, 2026⬇️1downloads

When & Why to Use This Skill

The Time Skill is a specialized Claude agent framework designed to manage the temporal logic of simulations and narrative environments. It solves the discrepancy between 'LLM iterations' (the number of AI responses) and 'Simulation turns' (the logical progression of time within a story or game). By providing a structured way to track durations, buffs, and resource decay, this skill ensures that the agent maintains a consistent and immersive world-state where time flows according to logical rules rather than just message counts.

Use Cases

  • Text-Based Adventure Games: Managing a game clock where specific actions like 'traveling' or 'searching' consume different amounts of in-game time, independent of the conversation length.
  • Dynamic State Tracking: Implementing status effects or 'buffs' that last for a specific number of simulation turns, ensuring they expire correctly as the narrative progresses.
  • Survival Mechanics: Simulating 'needs' systems (e.g., hunger, thirst, or fatigue) that decay based on the passage of simulation time, requiring the agent to track state changes across multiple turns.
  • Complex Task Orchestration: Handling 'Action Queues' where a single user request might trigger a sequence of events that span multiple logical time units within the simulation environment.
nametime
description"Motto: Time flows as the story requires."
licenseMIT
tier1
related[simulation, adventure, buff, needs, action-queue, speed-of-light, session-log]
tags[moollm, turns, duration, narrative, flow]

Time Skill

Simulation turns vs LLM iterations.

Motto: "Time flows as the story requires."

Key Concepts

  • Simulation turns — Game time, what mechanics track
  • LLM iterations — Meta-level, one response
  • They're not the same! One LLM response might be 0, 1, or many turns

Turn Definition

Action Turns
GO NORTH 1
PAT TERPIE 1
LOOK 0
INVENTORY 0
Pet all 8 kittens 8
Take a nap ~10

Duration Types

  • Turns — X simulation turns (primary unit)
  • Conditional — Until condition met
  • While present — While in location/with item
  • Permanent — Until explicitly removed

See Also

  • buff — Buff durations use simulation turns
  • needs — Needs decay over simulation turns