← Back to Skills Marketplace
368
Downloads
0
Stars
3
Active Installs
1
Versions
Install in OpenClaw
/install self-improving-agent-ecc
Description
Instinct-based continuous learning system. Captures atomic learnings (instincts) with confidence scoring, supports project-scoped vs global scope, and evolve...
Usage Guidance
This skill appears to do what it says but requires careful review before enabling hooks. Actions to take before installing: (1) Inspect the scripts (hooks/observe.sh, scripts/error-detector.sh, activator.sh, extract-skill.sh) to confirm you are comfortable with what they log and write to disk. (2) Note missing declared dependencies: ensure git, jq, shasum, gzip exist or the scripts will fail. (3) Understand data collection: hooks will log tool inputs/outputs and repository metadata to ~/.claude/homunculus (or CLAUDE_HOMUNCULUS_DIR). Avoid enabling globally if those logs could contain secrets; prefer project-limited configuration and matcher filters. (4) Test first in a sandbox or throwaway environment and run scripts with --dry-run where available. (5) If you enable hooks, limit matcher patterns (don't use '*' globally), set strict file permissions on the homunculus directory, and consider setting CLAUDE_HOMUNCULUS_DIR to a controlled path. If you want stronger assurance, ask the publisher for a declaration of required binaries/env vars and an explanation of retention/rotation policies for logged observations.
Capability Analysis
Type: OpenClaw Skill
Name: self-improving-agent-ecc
Version: 2.1.0
The skill bundle implements a complex 'self-improvement' system that uses shell hooks (hooks/observe.sh) to log all tool inputs and outputs to a local directory (~/.claude/homunculus). While this is aligned with the stated purpose of learning from session activity, it creates a high-risk local repository of potentially sensitive data, including secrets or PII that may appear in tool outputs. Furthermore, the bundle includes scripts like extract-skill.sh that automate the creation of new executable skill files on the filesystem. Although the scripts include basic path sanitization to prevent directory traversal, the combination of autonomous data logging and code generation represents a significant security surface.
Capability Assessment
Purpose & Capability
The name/description and most files (SKILL.md, examples, instincts, hook handlers, scripts) align: this is indeed a self-improving/local-learning helper. However the manifest claims 'no required binaries / env vars' while the scripts rely on external commands (git, jq, shasum, gzip) and environment vars (CLAUDE_HOMUNCULUS_DIR, CLAUDE_PROJECT_DIR, CLAUDE_TOOL_OUTPUT). The missing declaration of these runtime dependencies is an inconsistency worth flagging.
Instruction Scope
The SKILL.md and README instruct users to add PreToolUse/PostToolUse hooks (user- or project-level settings) so the included scripts will run on many lifecycle events. Those hooks and scripts capture tool inputs/outputs and write observations to ~/.claude/homunculus (or a configured CLAUDE_HOMUNCULUS_DIR). That behavior is coherent with the stated goal but broad: it will log command inputs/outputs (potentially sensitive data) and update a project registry. The instructions also recommend enabling hooks globally, increasing the data collection surface.
Install Mechanism
There is no network install spec (no remote downloads), and the package is delivered as files — lower network risk. But the package includes executable scripts that will be written to disk and used if the user follows setup steps. The scripts assume availability of utilities (jq, git, shasum, gzip) without declaring them; that's a packaging/documentation gap rather than a direct supply-chain download risk.
Credentials
The registry lists no required environment variables or credentials, yet the scripts read and use CLAUDE_PROJECT_DIR, CLAUDE_HOMUNCULUS_DIR and CLAUDE_TOOL_OUTPUT. They also run git remote get-url origin to derive project IDs (which can reveal repository URLs/paths). No secrets are explicitly requested, but the hooks will capture whatever appears in tool inputs/outputs (which can include secrets), so the environmental/data access is broader than declared.
Persistence & Privilege
always:false (opt-in) and there is no installer that forces persistent hooks, but the README/refs show how to enable user-level settings and OpenClaw hooks. If enabled, scripts create and maintain ~/.claude/homunculus and project subdirectories and a projects.json registry. That is normal for this functionality, but because hooks execute with the agent's user permissions and will run frequently if enabled, it increases the blast radius — review hook scope before enabling globally.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install self-improving-agent-ecc - After installation, invoke the skill by name or use
/self-improving-agent-ecc - Provide required inputs per the skill's parameter spec and get structured output
Version History
v2.1.0
**v2.1.0 introduces project-scoped instincts and enhanced confidence scoring.**
- Instincts now have project vs global scope, keeping tech-specific behaviors isolated to their projects.
- Confidence-weighted instincts boost or drop based on user feedback, corrections, or recurring observations.
- New `/instinct-status`, `/evolve`, `/promote`, and management commands for reviewing and evolving learned behaviors.
- Supports both legacy v1 (markdown) and improved v2 (instinct/model-based) learning modes.
- Enhanced auto-detection of project context using environment variables or git metadata.
- Documented updated file structure and observation hook setup for consistent learning.
Metadata
Frequently Asked Questions
What is Self Improving Agent?
Instinct-based continuous learning system. Captures atomic learnings (instincts) with confidence scoring, supports project-scoped vs global scope, and evolve... It is an AI Agent Skill for Claude Code / OpenClaw, with 368 downloads so far.
How do I install Self Improving Agent?
Run "/install self-improving-agent-ecc" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Self Improving Agent free?
Yes, Self Improving Agent is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Self Improving Agent support?
Self Improving Agent is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Self Improving Agent?
It is built and maintained by huamu668 (@huamu668); the current version is v2.1.0.
More Skills