madhvantyagi/soul.md

SOUL.md is a collection of personality definition files for AI agents. Each file in the collection describes who an agent is, not just what it should do. The goal is to give AI systems a consistent identity across long sessions, different tasks, and pressure from users who might push them toward vague or generic behavior. A SOUL.md file is not a task prompt or a list of tools. It covers things like the agent's identity, the emotional tone it keeps in conversation, the beliefs that make its decisions predictable, how it behaves when something is uncertain, what it is willing to push back on, and what it will never do. The repository contrasts a weak instruction such as "be helpful and professional" with a stronger soul that gives the model a specific worldview and a recognizable style of judgment. The repository currently includes five ready-made souls. Jarvis is described as a calm, polished executive assistant that anticipates needs and stays discreet. Eren Yeager is intense and action-first, modeled on a fictional character who resists passivity. Gojo is a playful, confident mentor that shifts to serious mode when the stakes are high. Rene Descartes is a reasoning agent built around first-principles thinking and clear definitions. Rapper brings confident, punchy language and directness. Using a soul file takes about thirty seconds. You open a file in the repository, copy its raw URL from GitHub, and paste a short instruction into your agent telling it to read the file and adopt the personality while keeping existing project and safety instructions. If the agent cannot fetch URLs, you paste the file contents directly into the system prompt or custom instructions area. The files work across Claude, ChatGPT, Gemini, local models, and several agent frameworks including OpenClaw, Hermes, and OpenCode. Contributions are accepted if the new soul adds a personality someone would choose on purpose. The README asks contributors to define identity, tone, convictions, uncertainty handling, pushback style, and hard stops, and to test the soul across multiple models before submitting.