NEON-SOUL - Self-Learning Soul Synthesis for AI Agents
v0.4.5Automated soul synthesis for AI agents. Extracts identity from memory files, promotes recurring patterns to axioms (N>=3), generates SOUL.md with full proven...
⭐ 14· 1.9k·4 current·5 all-time
byLee Brown@leegitw
MIT-0
Download zip
LicenseMIT-0 · Free to use, modify, and redistribute. No attribution required.
Security Scan
OpenClaw
Benign
high confidencePurpose & Capability
The name/description (synthesize a 'soul' from agent memory) matches the runtime actions: reading workspace memory/, maintaining .neon-soul state, producing SOUL.md, and calling a local LLM (Ollama). Declared requirements (Node >=22 and Ollama at localhost:11434) are appropriate for this functionality.
Instruction Scope
SKILL.md explicitly instructs the agent to read memory/ and .neon-soul/* files and to write SOUL.md and backups — exactly the data the skill claims to use. This is in-scope, but it does mean the skill will process potentially sensitive personal data from the agent's memory; review what you store in memory/ before running or schedule only in isolated contexts. The instructions do not direct the agent to read unrelated system files or external endpoints (other than the local Ollama).
Install Mechanism
No install step is declared. The skill is instruction-only with a bundled JS CLI file (scripts/neon-soul.mjs) that runs under Node; there are no downloads or external installers to fetch at install time.
Credentials
The skill does not request environment variables or external credentials. It requires a local Ollama service but no API tokens or secrets. The principal data access is local file I/O in the agent workspace (memory/ and .neon-soul/), which is proportional to the stated purpose.
Persistence & Privilege
always:false (not forced globally) and user-invocable:true. The skill recommends a cron for periodic runs, but does not demand permanent inclusion or system-wide config changes. This level of persistence is appropriate for a periodic analysis tool; run frequency and isolation are left to the user.
Assessment
This skill appears coherent with its description: it will read your agent's memory/ and .neon-soul/ state, call a local Ollama instance, and write SOUL.md and backups. Before installing or running, (1) inspect the bundled script if you want to audit behavior (scripts/neon-soul.mjs is included), (2) run a dry-run first to preview outputs (--dry-run), (3) avoid including highly sensitive secrets in memory/ that you don't want processed or persisted, and (4) if you enable scheduled runs, run them in an isolated workspace and keep the recommended time budget to prevent long-running jobs. If you need greater assurance, review the full JS bundle for network calls or telemetry beyond the expected Ollama interactions.Like a lobster shell, security has layers — review code before you run it.
Plugin bundle (nix)
Skill pack · CLI binary · Config
SKILL.mdCLIConfig
Config requirements
State dirsmemory/, .neon-soul/
agent-soulvk977bvmba3yrzadq6p405j4fw981txzbai-agentvk977bvmba3yrzadq6p405j4fw981txzbcompressionvk977bvmba3yrzadq6p405j4fw981txzbidentityvk977bvmba3yrzadq6p405j4fw981txzblatestvk977bvmba3yrzadq6p405j4fw981txzbmemoryvk977bvmba3yrzadq6p405j4fw981txzbprovenancevk977bvmba3yrzadq6p405j4fw981txzbself-learningvk977bvmba3yrzadq6p405j4fw981txzbsoulvk977bvmba3yrzadq6p405j4fw981txzbsoul-documentvk977bvmba3yrzadq6p405j4fw981txzbsoul-synthesisvk977bvmba3yrzadq6p405j4fw981txzb
License
MIT-0
Free to use, modify, and redistribute. No attribution required.