← Back to Skills Marketplace
98
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install evolution-toolkit
Description
Provides portable tools for agent self-improvement including session handoffs, reasoning style measurement, contradiction scanning, prediction logging, playb...
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 package looks like what it says: a set of local Node scripts that read and write an agent 'workspace' to support handoffs, fingerprinting, contradiction scanning, prediction logs, and a playbook optimizer. Before you install/run it: 1) Do not run it in your real home directory—set EVOLUTION_TOOLKIT_WORKSPACE to an isolated, writable directory (e.g., a temp or sandbox workspace) so the tools only read the files you intend. 2) Inspect scripts/skill-optimizer.js (and any other network‑related files) for outbound calls and exactly which env vars they use; if you don't want external APIs called, do not provide GEMINI_API_KEY/GOOGLE_API_KEY and run the optimizer in offline mode or skip it. 3) If you have sensitive secrets in your workspace (a .secrets file, API keys, tokens), move them or ensure the toolkit is pointed at a non-sensitive workspace; README mentions the optimizer may search workspace .secrets. 4) Run the read‑only scanning commands first (e.g., contradiction-scanner --json or fingerprinting with --json if available) to confirm behavior before allowing any write commands. 5) If you need a higher assurance, run the tools inside a container or VM and perform a code review focusing on any network calls or child_process/exec usage (not present in shown files but may appear in omitted scripts).
Capability Analysis
Type: OpenClaw Skill
Name: evolution-toolkit
Version: 1.0.0
The Evolution Toolkit is a comprehensive suite of metacognitive tools designed for agent self-improvement and session continuity. While the bundle includes high-privilege capabilities—such as 'skill-optimizer.js' which reads local files, accesses workspace '.secrets' for API keys, and communicates with the Google Gemini API (generativelanguage.googleapis.com)—these actions are transparently documented and strictly necessary for the stated purpose of iterative playbook optimization. The scripts (e.g., 'contradiction-scanner.js', 'cognitive-fingerprint.js') focus on local text analysis and maintenance without evidence of malicious intent, unauthorized data exfiltration, or harmful prompt injection.
Capability Assessment
Purpose & Capability
Name/description (self‑improvement, handoffs, contradiction scanning, prediction logging, optimizer, Socratic mode) aligns with the included scripts and protocols. The repository contains CLI Node scripts that operate on a workspace with memory/, imprints/, prediction logs, etc., which is expected for this purpose.
Instruction Scope
SKILL.md instructs the operator to set EVOLUTION_TOOLKIT_WORKSPACE and to run scripts that read and write files under that workspace. That scope is appropriate, but the scripts also fall back to a default path (HOME/.openclaw/workspace or cwd) if the env var is not set. That means the code can read from and (when writing) modify files in a default location in your home directory if you forget to set the workspace. Review and run in an isolated directory first. Scripts perform broad text scanning of many workspace files (AGENTS.md, EVOLUTION.md, memory/*.md) which is expected, but be aware they will read your workspace content.
Install Mechanism
No remote installer or downloads; code files are bundled with the skill. There is no install spec that fetches arbitrary archives or runs networked installers. This lowers supply‑chain risk, assuming you trust the provided JavaScript source. Still review the code you intend to run (particularly skill-optimizer.js, which could call external APIs).
Credentials
Registry metadata lists no required env vars, but the SKILL.md/README and config.example reference EVOLUTION_TOOLKIT_WORKSPACE and the README/config note that skill-optimizer may look for GEMINI_API_KEY / GOOGLE_API_KEY or workspace .secrets. The code uses process.env.EVOLUTION_TOOLKIT_WORKSPACE and falls back to HOME/.openclaw/workspace. This mismatch (no declared required envs but optional API keys and .secrets access) is an unexplained gap: if you run the optimizer without checking, it may attempt network calls using an API key found in your environment or workspace .secrets. Treat API keys as optional but potentially required by some scripts and audit skill-optimizer.js before providing keys.
Persistence & Privilege
The skill does not request always:true and does not modify other skills or system-wide config. Its write actions are confined to the user-designated workspace (memory/, memory/research/, imprints/). Scripts check for write access and exit if the workspace is not writable. Autonomous invocation is allowed by default (normal for skills) and not combined here with elevated persistence.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install evolution-toolkit - After installation, invoke the skill by name or use
/evolution-toolkit - 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 portable tools for agent self-improvement including session handoffs, reasoning style measurement, contradiction scanning, prediction logging, playb... It is an AI Agent Skill for Claude Code / OpenClaw, with 98 downloads so far.
How do I install Evolution Toolkit?
Run "/install evolution-toolkit" 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