← Back to Skills Marketplace
90
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install evolution-toolkit-build
Description
Provides tools for agent self-improvement including session handoffs, reasoning analysis, contradiction scanning, prediction logging, playbook optimization,...
README (SKILL.md)
Evolution Toolkit
Skill by Ergo | 2026-03-24 | Portable toolkit for agent self-improvement across workspaces Status: ✅ Verified
How to use: Set EVOLUTION_TOOLKIT_WORKSPACE to the target workspace, then run the script that matches the cognitive task. Load protocols/session-continuity.md or protocols/thinking-partner.md when the task is about handoffs or problem framing.
Triggers
Use this skill when the request is about any of these:
- Session end, handoff, continuity, preserving context between runs
- "How am I reasoning?" or "compare these sessions/documents"
- Contradictions, drift, conflicting instructions, stale guidance
- Prediction logging, confidence calibration, decision audits
- Improving a prompt/playbook through repeated eval loops
- Switching into Socratic questioning instead of direct advice
- Cross-session consistency, identity drift, recurring themes
Workspace
Export a writable workspace before running any script that writes state:
export EVOLUTION_TOOLKIT_WORKSPACE=/path/to/workspace
Expected layout:
memory/memory/imprints/for session imprintsmemory/research/for coherence reportsCURRENT.mdif you want session-imprint contextmemory/prediction-log.mdif you want prediction logging
Scripts
scripts/session-imprint.js
- Interactive session-end handoff.
- Use
--read,--list, or--diffto inspect existing imprints.
scripts/cognitive-fingerprint.js
- Measures reasoning style across 14 dimensions.
- Useful for one file, today's log, all imprints, or historical comparisons.
scripts/contradiction-scanner.js
- Scans guidance files in the workspace for conflicting directives, stale references, and drift.
scripts/predict.js
- Logs predictions and audits calibration.
- Requires
memory/prediction-log.mdwith## Logand## Calibrationsections.
scripts/skill-optimizer.js
- Runs an iterative generate -> evaluate -> improve loop for a configurable playbook.
- Requires a config file; see
config.example.json.
scripts/socratic-mode.js
- Classifies a problem into thinking phase and outputs friction-injecting questions.
scripts/session-coherence.js
- Analyzes daily logs for persistent themes, energy, and drift.
- Writes a report to
memory/research/by default.
Quick Commands
node scripts/session-imprint.js
node scripts/cognitive-fingerprint.js --daily
node scripts/contradiction-scanner.js --verbose
node scripts/predict.js add
node scripts/socratic-mode.js "Should I launch now or keep polishing?"
node scripts/session-coherence.js --days 14 --portrait
node scripts/skill-optimizer.js --config ./config.json --skill customer-support --iterations 3
Protocols
Read these only when relevant:
protocols/session-continuity.md: how to end and resume sessions cleanlyprotocols/thinking-partner.md: how to add useful friction instead of reflexive answers
Notes
- Write-capable scripts exit early with a clear warning if the target workspace is not writable.
skill-optimizer.jsis intentionally config-driven so the package stays product-neutral.- The toolkit does not ship credentials. API keys must come from env vars or your own workspace secrets.
Usage Guidance
This toolkit appears to do what it says: it reads workspace files, analyzes reasoning and consistency, logs predictions, and can optimize playbooks — and the optimizer may use an LLM API if you supply a key. Before installing or running: 1) Inspect skill-optimizer.js and socratic-mode.js for any network calls (search for fetch/http/https/request/axios/openai/gemini/googleapis or direct URLs). 2) Run the scripts first against a disposable, read-only or isolated workspace to observe behavior; many scripts check write access and will exit if workspace is not writable. 3) If you provide an API key, assume text from your workspace may be sent to that provider — only supply keys with least privilege and for accounts you control. 4) Because the package source/homepage is not provided, prefer running it locally (not enabling always:true) and review all included files for unexpected endpoints/telemetry. If you want higher assurance, provide the missing full contents of skill-optimizer.js and socratic-mode.js for review; that would likely change the confidence to high and could move the verdict to benign if no unexpected external transmission is found.
Capability Analysis
Type: OpenClaw Skill
Name: evolution-toolkit-build
Version: 1.0.0
The Evolution Toolkit is a collection of Node.js utilities designed for agent session continuity and self-improvement. While the toolkit includes high-risk capabilities such as reading workspace secrets and communicating with the Google Gemini API (in `scripts/skill-optimizer.js`), these behaviors are explicitly documented and aligned with the stated purpose of optimizing playbooks and analyzing reasoning. No evidence of malicious intent, unauthorized data exfiltration, or harmful prompt injection was found across the scripts or markdown protocols.
Capability Assessment
Purpose & Capability
The name/description (agent self-improvement: session handoffs, contradiction scanning, prediction logging, playbook optimization, Socratic questioning, coherence analysis) matches the included scripts and protocols. The repo contains CLI Node scripts that read and write a workspace and implement the advertised features. The only external capability hinted at is optional LLM usage by the skill-optimizer (README and config.example reference GEMINI_API_KEY/GOOGLE_API_KEY), which is coherent with a generate->evaluate->improve optimizer.
Instruction Scope
SKILL.md instructs the agent/operator to set EVOLUTION_TOOLKIT_WORKSPACE and run scripts that read many workspace files (memory/, guidance files, CURRENT.md, etc.) and write imprints/reports. This is consistent with its function, but the scripts scan and can aggregate large amounts of workspace content — review what they send externally. Two significant script files (skill-optimizer.js and socratic-mode.js) were present but their full contents were truncated in the material provided; if they call LLM APIs or remote endpoints they could transmit workspace data. Scripts include clear write-access checks and exit early if workspace not writable.
Install Mechanism
There is no install spec (instruction-only install). No external archives or installers are fetched by the skill metadata. The code is shipped as local scripts to be run with node; there is no automated download-from-URL step in the registry metadata. This is low-install risk, but running the included scripts will place/read files in the chosen workspace directory.
Credentials
The declared skill requires no environment variables or credentials. The README and config.example explicitly mention optional API keys (GEMINI_API_KEY, GOOGLE_API_KEY or workspace .secrets) for the skill-optimizer — that is proportionate to an optimizer that can call external LLM services. No unrelated secrets or system credentials are requested. However, if you provide an API key, expect the optimizer to use it and potentially send workspace text to the provider; confirm what data is transmitted before supplying keys.
Persistence & Privilege
always is false and the skill does not request any elevated agent/system privileges. Scripts read/write only within the EVOLUTION_TOOLKIT_WORKSPACE and perform no modifications to other skills or system-wide configs. Autonomous invocation (model invocation enabled) is default but not combined here with always:true or extra credential access.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install evolution-toolkit-build - After installation, invoke the skill by name or use
/evolution-toolkit-build - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
v1.0 — 7 tools for AI agent self-improvement: session imprints, cognitive fingerprinting, contradiction scanning, prediction calibration, Socratic thinking partner, session coherence.
Metadata
Frequently Asked Questions
What is Evolution Toolkit?
Provides tools for agent self-improvement including session handoffs, reasoning analysis, contradiction scanning, prediction logging, playbook optimization,... It is an AI Agent Skill for Claude Code / OpenClaw, with 90 downloads so far.
How do I install Evolution Toolkit?
Run "/install evolution-toolkit-build" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Evolution Toolkit free?
Yes, Evolution Toolkit is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Evolution Toolkit support?
Evolution Toolkit is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Evolution Toolkit?
It is built and maintained by ergo (@ergopitrez); the current version is v1.0.0.
More Skills