time
Motto: Time flows as the story requires.
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.
| name | time |
|---|---|
| description | "Motto: Time flows as the story requires." |
| license | MIT |
| tier | 1 |
| 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