# Soul Pack

> Export and import SOUL packages for OpenClaw agents. Use when creating a reusable persona package (SOUL.md + preview.md + manifest.json), installing a soul package into a new/existing agent workspace, or batch listing local soul packages for a Soul marketplace workflow.

- Skill: `johnalbertini14-glitch/soul-pack` (Agent Skill, multi-file: 7 files)
- Install (CLI): `npx skillmds@latest add johnalbertini14-glitch/soul-pack`
- Raw SKILL.md: https://api.skillmd.com/api/skills/johnalbertini14-glitch/soul-pack/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: johnalbertini14-glitch (https://skillmd.com/u/johnalbertini14-glitch)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/johnalbertini14-glitch/soul-pack

---


# Soul Pack

Use bundled scripts for deterministic behavior.

## Export soul package

```bash
bash /Users/feifei/projects/soul-pack-skill/scripts/export-soul.sh \
  --workspace /Users/feifei/.openclaw/workspace \
  --out /Users/feifei/projects/soul-packages \
  --name edith-soul
```

## Import soul package + create agent

```bash
bash /Users/feifei/projects/soul-pack-skill/scripts/import-soul.sh \
  --package /Users/feifei/projects/soul-packages/edith-soul.tar.gz \
  --agent my-soul \
  --workspace /Users/feifei/projects/agents/my-soul
```

## List local soul packages

```bash
bash /Users/feifei/projects/soul-pack-skill/scripts/list-souls.sh \
  --dir /Users/feifei/projects/soul-packages
```

## Notes
- `manifest.json` is validated against `schema/manifest.schema.v0.1.json`.
- Import does not overwrite existing SOUL.md unless `--force` is provided.
- Agent registration uses `openclaw agents add` (or reuses existing agent id).