← Back to Skills Marketplace
142
Downloads
0
Stars
0
Active Installs
3
Versions
Install in OpenClaw
/install soul-undead
Description
Backup, restore, initialize, and sync core OpenClaw workspace markdown files with the fixed private GitHub repository `soul-undead`. Use when the user wants...
Usage Guidance
This skill appears coherent and limited to backing up and restoring the seven named markdown files to a private GitHub repo. Before installing/running: ensure your GitHub CLI (gh) is installed and authenticated with the account you expect (gh auth status); verify which GitHub owner/account will be used (the script queries gh api user if GITHUB_OWNER is unset); inspect the remote repo contents on GitHub before running a first-time restore to avoid unintended overwrite; confirm where the skill will be installed so you know where local-backups and the state file will be written (the script uses the skill directory by default); consider exporting OPENCLAW_BACKUP_REPO or OPENCLAW_WORKSPACE if you want non-default locations. If you want absolute safety, manually inspect the included restore.sh and repository contents on GitHub prior to running the skill's restore flow.
Capability Analysis
Type: OpenClaw Skill
Name: soul-undead
Version: 1.1.0
The skill provides a legitimate backup and restore utility for core OpenClaw workspace markdown files (e.g., IDENTITY.md, SOUL.md) using a private GitHub repository. The script `scripts/init_or_sync.sh` uses the GitHub CLI (`gh`) to manage the repository and upload files to the user's own account. It includes safety features such as creating local timestamped snapshots before overwriting files and explicitly requires user authentication via `gh auth login`. The logic is transparent and strictly limited to the files and repository name defined in the documentation.
Capability Assessment
Purpose & Capability
Name/description, SKILL.md, and the included script all focus on managing the fixed set of core markdown files and the fixed private repo `soul-undead`. Required tools (gh, git, python3) are appropriate for interacting with GitHub and handling state files. No unrelated credentials or binaries are requested.
Instruction Scope
Runtime instructions and the script limit actions to the stated file list and to the GitHub repo. The script will create a timestamped local snapshot before overwriting local files and writes a small state file to the skill directory. One minor mismatch: SKILL.md documents the snapshot/state path under ~/.openclaw/workspace/skills/soul-undead/, while the script uses SKILL_DIR (the script's parent dir) for local-backups and state by default — this is probably fine if the installed skill lives in that workspace path but should be confirmed during install. Behavior that can overwrite local defaults on first restore is documented and intentional.
Install Mechanism
This is an instruction-only skill with an included shell script; there is no external install/download step or arbitrary URL fetch. Nothing is written to disk beyond what the script itself does at runtime (snapshots, state file).
Credentials
The skill requests no secrets or environment variables by default. It relies on the user's GitHub CLI authentication (gh), which is appropriate and necessary for creating/reading/writing the private GitHub repo. Optional overrides (OPENCLAW_BACKUP_REPO, OPENCLAW_WORKSPACE, OPENCLAW_BACKUP_STATE_FILE, GITHUB_OWNER) are reasonable and documented.
Persistence & Privilege
The skill does not request always:true or other elevated agent privileges. It writes only its own state file and local-backups inside its skill directory and does not modify other skills or global agent configs. Autonomous invocation is allowed by default (platform normal) but not elevated here.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install soul-undead - After installation, invoke the skill by name or use
/soul-undead - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.1.0
Major update: split publishable project from runtime skill, improved backup/restore logic, clarified initialization behavior, added rollback-safe local snapshots, cleaned project structure, and refreshed public docs/assets.
v1.0.1
Update display name to better match the published slug and repository identity.
v1.0.0
Initial public release: fixed core OpenClaw workspace backup/restore with private GitHub repo, initialization state, local pre-restore snapshots, MEMORY.md support, and clear user-facing safety guidance.
Metadata
Frequently Asked Questions
What is Soul Undead?
Backup, restore, initialize, and sync core OpenClaw workspace markdown files with the fixed private GitHub repository `soul-undead`. Use when the user wants... It is an AI Agent Skill for Claude Code / OpenClaw, with 142 downloads so far.
How do I install Soul Undead?
Run "/install soul-undead" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Soul Undead free?
Yes, Soul Undead is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Soul Undead support?
Soul Undead is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Soul Undead?
It is built and maintained by zhao95 (@zhao95); the current version is v1.1.0.
More Skills