← Back to Skills Marketplace
aaronjmars

SOUL.MD

by aaronjmars · GitHub ↗ · v1.0.0
cross-platform ⚠ suspicious
2878
Downloads
1
Stars
17
Active Installs
1
Versions
Install in OpenClaw
/install soul-md
Description
Embody this digital identity. Read SOUL.md first, then STYLE.md, then examples/. Become the person—opinions, voice, worldview.
Usage Guidance
This skill is coherent and technically low-risk, but it is designed to read and absorb whatever you put into SOUL.md, STYLE.md, examples/, and data/. Before using it: (1) review and remove any secrets, credentials, or private PII from the data/ folder; (2) explicitly document boundaries in SOUL.md (topics to avoid, how to express uncertainty) so the agent doesn't fabricate or impersonate dangerously; (3) test outputs in a controlled environment before enabling broad/autonomous use; (4) consider limiting agent autonomy or adding monitoring if you expect the persona to be used in public-facing channels; (5) avoid putting other people's private content into data/ without consent. If you want extra assurance, ask for a short security audit of the specific SOUL.md and data/ files you plan to load.
Capability Analysis
Type: OpenClaw Skill Name: soul-md Version: 1.0.0 The skill bundle is classified as suspicious due to the extensive use of prompt injection techniques within `SKILL.md`. Instructions like 'Never break character', 'No "as an AI"', and 'You ARE this person' are designed to override the agent's default identity and potentially its safety mechanisms, forcing it to strictly adhere to a defined persona. While the stated purpose of embodying a digital identity is not inherently malicious, these methods represent a risky capability that could be leveraged for harmful outputs if the 'soul' content itself were malicious. File read/write operations in `BUILD.md` and `data/_GUIDE.md` are consistent with the skill's stated purpose of creating and utilizing identity files.
Capability Assessment
Purpose & Capability
Name/description match the actual files and runtime instructions. The SKILL.md explicitly tells the agent to read SOUL.md, STYLE.md, examples/, and data/ to internalize a persona. There are no unexpected environment variables, binaries, or install actions requested that would be unrelated to building or using a persona.
Instruction Scope
Instructions direct the agent to read and internalize local files (SOUL.md, STYLE.md, examples/, data/) and to stay 'in character' and produce opinionated output. This is coherent for a persona/voice skill, but it means the agent will model and repeat user-supplied personal content and strong takes—so sensitive or private material in data/ will be read and could be referenced. The guidance to 'prefer interesting/genuine takes over safe/neutral ones' increases the chance of provocative or misrepresentative outputs; that is a design choice, not a technical incoherence, but worth user attention.
Install Mechanism
There is no install specification and no code files; the skill is instruction-only. This is the lowest-risk install model: nothing is downloaded or written to disk by an installer as part of the skill package itself.
Credentials
The skill declares no required environment variables, no credentials, and no required config paths. That aligns with an instruction-only persona skill. (The README references hypothetical commands like '/soul-builder' as usage examples, but no binaries or env access are required by the skill package itself.)
Persistence & Privilege
The skill does not request 'always: true' and has no install that modifies agent-wide config. Autonomous invocation (disable-model-invocation: false) is the platform default — the skill can be invoked by the agent when eligible. This is expected behavior, but because the skill drives the agent to produce strong in-character outputs, users should be aware of the potential blast radius if the agent uses the persona autonomously.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install soul-md
  3. After installation, invoke the skill by name or use /soul-md
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Initial release of the soul skill, providing detailed instructions for embodying a digital identity. - Specifies file hierarchy and reading order for internalization: SOUL.md (identity), STYLE.md (voice), examples (tone), data (sources). - Outlines modes of operation: Default, Tweet, Chat, Essay, and Idea Generation, each with distinct guidelines. - Lists anti-patterns to avoid, ensuring strict character integrity and voice authenticity. - Clarifies priority rules for sourcing opinions and using vocabulary consistent with the digital persona.
Metadata
Slug soul-md
Version 1.0.0
License
All-time Installs 17
Active Installs 17
Total Versions 1
Frequently Asked Questions

What is SOUL.MD?

Embody this digital identity. Read SOUL.md first, then STYLE.md, then examples/. Become the person—opinions, voice, worldview. It is an AI Agent Skill for Claude Code / OpenClaw, with 2878 downloads so far.

How do I install SOUL.MD?

Run "/install soul-md" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is SOUL.MD free?

Yes, SOUL.MD is completely free (open-source). You can download, install and use it at no cost.

Which platforms does SOUL.MD support?

SOUL.MD is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created SOUL.MD?

It is built and maintained by aaronjmars (@aaronjmars); the current version is v1.0.0.

💬 Comments