souls.directory

Give your agent a soul.

A curated directory of SOUL.md personality templates for AI agents.

What is souls.directory?

souls.directory is a curated collection of AI personality templates (SOUL.md files) for OpenClaw agents. Instead of starting from scratch, pick a personality that fits your needs—or mix and match to create something new.

Quick Start

Browse: Visit souls.directory to explore the collection.

Use a soul: Copy any SOUL.md from the website into your OpenClaw agent workspace, or use the raw content link on each soul’s page.

What is a SOUL.md?

A soul file defines how an AI agent behaves: core values, communication style, boundaries, and vibe. The difference between a chatbot and a companion is personality—this directory helps you build companions.

Contributing

We welcome contributions: new soul templates and improvements to the site. See CONTRIBUTING.md for guidelines and the submission process. AI-assisted PRs are welcome.

For Developers

Tech stack: Next.js 16, TypeScript, Tailwind CSS, Convex, GitHub OAuth, Vercel.

Local setup:

git clone https://github.com/thedaviddias/souls-directory.git
cd souls-directory
pnpm install
cp .env.example .env.local
# Add your Convex and GitHub OAuth credentials
pnpm dev

Open http://localhost:3000.

Project structure:

souls-directory/
├── apps/
│   ├── web/          # Next.js app (Convex, auth, souls UI)
│   └── e2e/          # Playwright E2E tests
└── .github/          # CI and workflows

Contributors

Thanks to everyone who contributes souls and code.

David Dias 💻

github-actions[bot] 💻

License

MIT — see LICENSE. Soul templates submitted to the directory are contributed under the same license.