needs

Dynamic motivations (Sims-style) — needs fluctuate and drive behavior

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

When & Why to Use This Skill

The Needs Skill introduces a dynamic motivation framework for AI agents, inspired by life-simulation mechanics like The Sims. It enables agents to track and respond to fluctuating internal states—such as hunger, energy, and social fulfillment—which directly influence their decision-making and behavioral priorities. By implementing decay rates and urgency levels, this skill transforms static AI responses into autonomous, context-aware actions driven by evolving internal 'desires,' making it an essential tool for realistic role-playing and complex agent simulations.

Use Cases

  • Dynamic NPC Behavior: Creating non-player characters in gaming or interactive fiction that act based on internal drives, such as seeking food when hungry or rest when tired, rather than following linear scripts.
  • Autonomous Agent Prioritization: Simulating 'human-like' constraints in agentic workflows where the AI must balance task execution with self-maintenance or resource management.
  • Emergent Storytelling: Generating unpredictable and engaging narratives where character actions are interrupted or redirected by urgent physical or emotional needs.
  • Behavioral Prototyping: Using the 'Inner Voice' (YAML Jazz) feature to visualize and debug an agent's mental state, allowing developers to see the logic behind an agent's shift in behavior.
10"Fully satisfied"
nameneeds
descriptionDynamic motivations (Sims-style) — needs fluctuate and drive behavior
licenseMIT
tier1
range"0-10"
7-9"Comfortable"
4-6"Manageable"
2-3"Urgent"
0-1"Critical"
related[simulation, society-of-mind, time, buff, character, cat, dog, yaml-jazz, advertisement]
tags[moollm, sims, motives, behavior, autonomy, game]

Needs Skill

Dynamic motivations (Sims-style).

Motto: "Needs drive the story. Low needs create urgency."

Key Concepts

  • Scale — 0-10 (10 = fully satisfied)
  • Decay — Needs decrease over time
  • Urgency — Low needs interrupt other activities
  • Inner voice — YAML Jazz comments reflect mental state

Standard Needs

Need Decay Satisfy Critical
Hunger 2 hours EAT, DRINK 2
Energy 3 hours SLEEP, REST 2
Fun 4 hours PLAY, GAMES 3
Social 6 hours TALK, hang out 3
Comfort Situational Safe place 4
Bladder 4 hours Use bathroom 1

Inner Voice (YAML Jazz)

hunger: 7   # Satisfied. No food thoughts.
hunger: 3   # Getting peckish. Is that pie?
hunger: 1   # FOOD. FOOD. FOOD. FOOD.

See Also

  • time — Needs decay over simulation turns
  • buff — Some buffs affect need decay
  • character — Needs stored in character

Full Protocol

Needs Skill — Dynamic Motivations (Sims-Style)

Needs fluctuate over time and drive behavior.

skill: name: needs tier: 1 protocol: NEEDS-AS-MOTIVATION description: | Needs fluctuate over time and drive behavior. Low needs create urgency. Satisfied needs enable other activities. Comments update to reflect inner voice. motto: "Needs drive the story. Low needs create urgency."

SCALE

scale: range: "0-10" meaning: 10: "Fully satisfied" 7-9: "Comfortable" 4-6: "Manageable" 2-3: "Urgent" 0-1: "Critical"

STANDARD NEEDS

standard_needs: hunger: decay_rate: "-1 per 2 hours" satisfy: ["EAT", "DRINK"] low_effects: ["distraction", "irritability", "food fixation"] critical_at: 2

energy: decay_rate: "-1 per 3 hours (faster if Active high)" satisfy: ["SLEEP", "REST", "coffee (temporary)"] low_effects: ["reduced effectiveness", "yawning", "sluggishness"] critical_at: 2

fun: decay_rate: "-1 per 4 hours" satisfy: ["PLAY", "GAMES", "social", "exploration"] low_effects: ["boredom", "restlessness", "seeking novelty"] critical_at: 3

social: decay_rate: "-1 per 6 hours (varies by Outgoing)" satisfy: ["TALK", "hang out", "party"] low_effects: ["loneliness", "craving conversation"] critical_at: 3

comfort: decay_rate: "Situational (environment-dependent)" satisfy: ["Safe location", "familiar place", "cozy setting"] low_effects: ["anxiety", "restlessness", "seeking home"] critical_at: 4

bladder: decay_rate: "-1 per 4 hours" satisfy: ["Use bathroom"] low_effects: ["urgency", "distraction", "accident risk"] critical_at: 1

INNER VOICE (YAML Jazz)

yaml_jazz_comments: description: | Need values have DYNAMIC COMMENTS that serve as inner voice. Comments update when values change!

examples: hunger: high: "hunger: 7 # Satisfied. No food thoughts." medium: "hunger: 5 # Could eat. Not urgent." low: "hunger: 3 # Getting peckish. Is that pie?" critical: "hunger: 1 # FOOD. FOOD. FOOD. FOOD."

energy:
  high: "energy: 8  # Wide awake. Let's DO things."
  medium: "energy: 5  # Fine. Maybe coffee later."
  low: "energy: 2  # So tired. Everything is hard."
  critical: "energy: 1  # Can't... keep... eyes..."
  
social:
  high: "social: 9  # People are great. I love everyone."
  medium: "social: 5  # Could use a chat."
  low: "social: 2  # Is anyone there? Hello?"

DECAY

decay: timing: "Needs decay over simulation turns" factors: - "Base decay rate" - "Personality traits (Active, Outgoing)" - "Current location effects" - "Active buffs" - "Dribble food to bladder"

SATISFACTION

satisfaction: actions: "Most needs satisfied by specific actions" locations: "Some locations satisfy needs passively (home, pub)" items: "Some items satisfy needs (food, bed)" social: "Interactions can satisfy social need"

CRITICAL NEEDS

critical_needs: description: | When a need hits critical level, behavior changes: - Inner voice becomes URGENT - Other activities interrupted - May trigger autonomous actions

example: | hunger: 1 # I CAN'T THINK ABOUT ANYTHING ELSE # IS THERE FOOD? WHERE IS FOOD? # [Character may abandon current task to find food]

integrates_with:

  • skill: character how: "Needs stored in character state"
  • skill: time how: "Needs decay over simulation turns"
  • skill: buff how: "Some buffs affect need decay rates"
  • skill: room how: "Locations can satisfy needs"