How do I install the Soulcraft skill?

Run npx skillmds@latest add ucsandman/soulcraft in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Soulcraft safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Soulcraft?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Soulcraft free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Soulcraft?

ucsandman (@ucsandman) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Soulcraft by ucsandman — Agent Skill

Name: Soulcraft
Author: ucsandman

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.

ucsandman 59b45ee 5 files · 9.2 KB Updated Sep 17, 2026

File contents

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

IDENTITY.md + USER.md — fill in together, 5 minutes. The agent may propose a name; the human decides.
First daily log — create memory/YYYY-MM-DD.md with today's context so tomorrow's session has a yesterday.
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).

Frequently asked questions