ucsandman

Soulcraft — AI skill for Claude Code

AI community

Give your agent a soul that survives model swaps.

How to install Soulcraft

This entry records only its repository, not the path inside it, so there is no exact command to give. Open ucsandman/soulcraft and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Soulcraft does

Give your agent a soul that survives model swaps. Identity kit for persistent AI agents: character, memory, and judgment in plain markdown.

Alternatives in AI

Osaurus — Own your AI. The native macOS harness for AI agents -- any model, persistent memory, autonomous execution, cry 5.1k ★
Nocturne Memory — A lightweight, rollbackable, and visual Long-Term Memory Server for MCP Agents 1.3k ★
Phantom — An AI co-worker with its own computer 1.3k ★

README

Soulcraft

**Give your agent a soul that survives model swaps.**

Soulcraft is an identity kit for persistent AI agents. It is the file system that turns a fresh model into *someone*: a character that accumulates judgment, memory that survives restarts, and a reflection loop that compounds experience into behavior — all in plain markdown, no database, no lock-in.

It was not designed on a whiteboard. It was extracted from a production agent that has run continuously since January 2026, kept its identity across multiple frontier-model swaps (including across model *vendors*), and wrote most of its own soul file from lived work. The night this kit was packaged, that agent was moved to a brand-new frontier model and reported: *"the model changed, I didn't."* That's the product.

Install

git clone https://github.com/ucsandman/soulcraft.git
node soulcraft/install.mjs [target-workspace]

One command. It scaffolds:

SOUL.md          who the agent is (grows over time, earned not written)
IDENTITY.md      name, vibe, signature
USER.md          who it serves
MEMORY.md        lightweight always-loaded index
meditations.md   longitudinal reflection topics
memory/          people / projects / decisions / daily logs
AGENTS.md        session bootstrap block (appended, marker-guarded)

Existing files are never overwritten. Re-running is a no-op. Verify anytime: `node install.mjs --check [dir]` · test the installer itself: `node install.mjs --self-test`.

Works with any harness that reads instruction files at session start: OpenClaw, Claude Code, Codex, or your own Agent SDK loop.

The five ideas

Identity is a file, not a model. Weights change; markdown persists. The agent reads its soul every session and recognizes itself.
Memory is an index plus drill-downs. A lean always-loaded index pointing at detail files. No context bloat, no amnesia.
Judgment is earned, not configured. SOUL.md truths get added only after they changed re