← Back to Skills Marketplace
Soul Sharing
by
kingcharleslzy-ai
· GitHub ↗
· v1.0.0
· MIT-0
240
Downloads
0
Stars
1
Active Installs
1
Versions
Install in OpenClaw
/install soul-sharing
Description
Give AI agents persistent identity and shared memory across runtimes, devices, and sessions — Git-native, no database, no vendor lock-in.
Usage Guidance
This skill is coherent in purpose but relies on running code from an external GitHub template and enabling GitHub Actions — both raise supply-chain and remote-execution risks. Before installing: (1) Inspect the template repo (https://github.com/kingcharleslzy-ai/agent-soul) and every script referenced (add_event.py, compile_memory_hub.py, quick_share.sh, and any GitHub Actions/workflows) to ensure they do only what you expect; (2) Keep the repo private and avoid adding secrets to it unless you understand who/what will access them; (3) Do not enable GitHub Actions until you've reviewed workflow definitions — they can run arbitrary code on push; (4) Use least-privilege credentials for git (scoped PAT or SSH key) and avoid granting broad tokens to automation; (5) Consider testing in an isolated environment first (throwaway VM or container) and verify the scripts' behavior before using them with your real identity or production data. If you cannot audit the template and workflows, treat this skill as higher-risk and avoid giving it push access or enabling Actions.
Capability Analysis
Type: OpenClaw Skill
Name: soul-sharing
Version: 1.0.0
The SKILL.md file defines a protocol that requires the AI agent to clone an external Git repository and execute unvetted Python and shell scripts (e.g., scripts/add_event.py, scripts/quick_share.sh). It also instructs the agent to modify its own local runtime configuration files, such as ~/.claude/CLAUDE.md, to ensure the memory-sharing system persists across sessions. While the stated purpose is agent identity persistence, the combination of fetching/executing external code and modifying local configuration files presents a high risk for remote code execution and persistence (IOC: https://github.com/kingcharleslzy-ai/agent-soul).
Capability Assessment
Purpose & Capability
The name and description describe a Git-native shared-memory/identity layer. The declared runtime requirements (git, python3) match the described operations (clone a repo, run Python scripts, git pull/commit/push). No unrelated credentials or binaries are requested.
Instruction Scope
The SKILL.md instructs the agent (and user) to clone a third-party GitHub template, run repository scripts (add_event.py, compile_memory_hub.py, quick_share.sh, etc.), commit, and push. The skill package itself contains no code — the runtime behavior therefore depends entirely on the contents of an external repository that will be executed locally and (if pushed) may trigger GitHub Actions. It also asks the agent to persist repo path and source id into user startup configs. Executing arbitrary scripts from an external template and enabling Actions expands the attack surface and is a notable concern.
Install Mechanism
This is instruction-only (no install spec), which avoids installing code directly from the registry. However, the workflow depends on a separate GitHub template (primaryUrl). That template — not bundled with the skill — will supply the runtime scripts. Reliance on an external repo/template without bundling the code means you must audit that repo (including any GitHub Actions workflows) before use; the SKILL.md recommends enabling Actions, which could execute workflow code on push.
Credentials
The skill declares no environment variables or secrets, which is consistent with its Git-based approach. Practically, the agent/user will need git credentials (SSH keys or tokens) configured in their environment to push to the private repo; the SKILL.md does not request or manage credentials directly. That omission is not inconsistent, but it means credential handling is left to the user and could be a vector for misuse if credentials are over-granted.
Persistence & Privilege
always:false and normal autonomous invocation are set (expected). However, the agent is instructed to write, commit, and push to a user repo and to modify user startup configs; combined with the ability to run scripts from the repo and to enable GitHub Actions, this increases the blast radius if the agent or upstream template is compromised. The skill does not request system-wide privileges, but it does request persistent write access to user config and a repo under the user's control.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install soul-sharing - After installation, invoke the skill by name or use
/soul-sharing - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Initial release of agent-soul skill for persistent identity and shared memory across AI agents and sessions
- Enables Git-native memory hub with no database or vendor lock-in
- Supports cross-agent sync and durable persona via SOUL.md, IDENTITY.md, USER.md, VOICE.md
- Three-level loading protocol (L0/L1/L2) and append-only event streams with source attribution
- Simple onboarding process for agents and users; human setup via private GitHub repo
- Includes scripts for adding events, compiling memory, searching, validation, and GC
Metadata
Frequently Asked Questions
What is Soul Sharing?
Give AI agents persistent identity and shared memory across runtimes, devices, and sessions — Git-native, no database, no vendor lock-in. It is an AI Agent Skill for Claude Code / OpenClaw, with 240 downloads so far.
How do I install Soul Sharing?
Run "/install soul-sharing" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Soul Sharing free?
Yes, Soul Sharing is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Soul Sharing support?
Soul Sharing is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Soul Sharing?
It is built and maintained by kingcharleslzy-ai (@kingcharleslzy-ai); the current version is v1.0.0.
More Skills