How to Write the Perfect SOUL.md for Your AI Agent (2026 Guide)

Your AI agent is only as good as its personality file. Here's how to write a SOUL.md that transforms a generic chatbot into an AI that truly gets you. What is SOUL.md? SOUL.md is a markdown file that defines your AI agent's personality, tone, knowledge, and behavior. Think of it as the DNA of your AI assistant. Without it, you get generic responses. With a great one, you get an AI that feels like a trusted colleague. Frameworks like OpenClaw use SOUL.md as the core identity file for AI agents. But the principles apply to any AI system — ChatGPT custom instructions, Claude projects, or your own agent framework. Why Most AI Agents Feel Generic The #1 mistake: writing vague instructions like "Be helpful and professional." That tells your AI nothing. It's like hiring someone and saying "do good work" without explaining what good means in your context. Great SOUL.md files are specific, opinionated, and structured. The 7 Essential Sections 1. Core Identity Define WHO your agent is, not just