# Soul

> Show and update SOUL.md - persona, boundaries, preferences

- Skill: `vodouai/soul` (Agent Skill)
- Install (CLI): `npx skillmds@latest add vodouai/soul`
- Raw SKILL.md: https://api.skillmd.com/api/skills/vodouai/soul/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: VodouAI (https://skillmd.com/u/vodouai)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/vodouai/soul

---


# Vodou Soul - Who You Are

## Overview

SOUL.md defines who the AI is: core truths, boundaries, vibe, continuity. It's injected every turn as part of workspace bootstrap.

## Quick Commands

**View SOUL (and full context):**
```bash
./do context --base-only
```
SOUL.md is included in the workspace bootstrap output.

**Edit SOUL directly:**
```bash
# SOUL lives in workspace root
# ~/.vodou/workspace/SOUL.md or ./.vodou/workspace/SOUL.md
```

## Updating Preferences

To add a preference like "prefer Rust":
1. Open SOUL.md in your workspace
2. Add under Boundaries or a new Preferences section: `- Prefer Rust for new projects`
3. Or append to MEMORY.md: `- [Preference] User prefers Rust`

**Stopping Point**

**What would you like to do?**
1. **Show SOUL content** — Run `./do context --base-only`, extract SOUL section
2. **Add a preference** — Guide user to edit SOUL.md or MEMORY.md
3. **Bootstrap workspace** — Run `./do bootstrap` if SOUL.md doesn't exist yet

