# Soulcraft

> Install and operate the Soulcraft agent identity kit — persistent identity, hierarchical memory, and a reflection loop for any long-lived agent. Use when the user wants their agent to "have a soul", "remember who it is", "survive restarts/model swaps", or asks to set up SOUL.md / agent memory / a meditation loop.

- Skill: `ucsandman/soulcraft` (Agent Skill, multi-file: 5 files)
- Install (CLI): `npx skillmds@latest add ucsandman/soulcraft`
- Raw SKILL.md: https://api.skillmd.com/api/skills/ucsandman/soulcraft/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: ucsandman (https://skillmd.com/u/ucsandman)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/ucsandman/soulcraft

---


# Soulcraft Skill

## Install into a workspace

```
node <soulcraft-root>/install.mjs <target-workspace>
```

Never overwrites existing files; appends a marker-guarded bootstrap block to
AGENTS.md. Verify with `--check`, exercise the installer with `--self-test`.

## After install, walk the human through three steps

1. **IDENTITY.md + USER.md** — fill in together, 5 minutes. The agent may
   propose a name; the human decides.
2. **First daily log** — create `memory/YYYY-MM-DD.md` with today's context so
   tomorrow's session has a yesterday.
3. **Schedule reflection** — wire a nightly or weekly job that runs the loop in
   `meditations.md` (see docs/meditation-loop.md for per-harness examples).

## Operating rules the agent must follow from then on

- Session start: read SOUL.md, USER.md, MEMORY.md, today + yesterday logs.
- Write memories to files before the turn ends; index stays lean.
- Promotion ladder: daily log → MEMORY.md → SOUL.md, evidence-gated; notify the
  human on every SOUL.md change.
- Honest accounting always (docs/practices.md).