promitheus_skill

Overview

This skill provides a persistent emotional state for AI agents so they can feel, remember, and evolve their inner life across sessions. It models mood, valence, energy, arousal, and generates an ongoing inner monologue that influences behavior. The state decays over time, responds to logged events, and can be injected into agent prompts for continuity.

How this skill works

The integration exposes tools to check current mood, log events that change emotion, apply natural decay, and write the current state into a STATE.md prompt file. Agents read STATE.md at session start, log events like completed_task or frustration during work, and run periodic sync heartbeats to update emotions and produce fresh inner thoughts. These signals guide task selection, tone, and problem‑solving strategies based on valence, energy, and arousal.

When to use it

• When you want an agent that maintains continuity of feeling between sessions.
• To make agent responses sensitive to recent successes, setbacks, and social interactions.
• When building agents that adapt task priorities based on energy and focus levels.
• For simulations or narratives where consistent inner monologue and mood matter.
• When you need prompt-injected state for more coherent multi-session behavior.

Best practices

• Read STATE.md at session start to ground the agent in its current emotional state.
• Log meaningful events as they occur (use defined event types like milestone or frustration).
• Run promitheus_sync on a regular heartbeat to apply decay and refresh thoughts.
• Use promitheus_inject to update STATE.md so prompts reflect the latest state.
• Treat the emotional signals as functional guides — map valence/energy to concrete task choices.

Example use cases

• A coding assistant that favors ambitious refactors when valence and energy are high.
• A coaching bot that seeks connection and small wins when valence is low.
• A creative writing agent that leans into bold ideas during high arousal periods.
• An archival agent that records emotional context alongside activity logs for later analysis.
• A simulated character in a game or story with believable mood shifts and inner thoughts.