Self Improving Agent

ReviewAudited by ClawScan on May 18, 2026.

Overview

The skill is mostly transparent, but it can persist changes to future-agent memory and instruction files without clear approval, sanitization, or cleanup boundaries.

Install only if you want an agent to keep learning logs and reminders. Before enabling hooks or allowing promotion into AGENTS.md, SOUL.md, TOOLS.md, CLAUDE.md, or Copilot instructions, decide what may be recorded, require review before promotion, and avoid storing secrets or private transcript details.

Findings (5)

Artifact-based informational review of SKILL.md, metadata, install specs, static scan signals, and capability signals. ClawScan does not execute the skill or run runtime probes.

What this means

Incorrect, private, or poisoned learnings could become standing instructions for future agents and influence later work.

Why it was flagged

The skill directs the agent to move learnings into persistent instruction/context files that future sessions may trust, but the artifacts do not define approval, sanitization, retention, or rollback controls.

Skill content
Broadly applicable learning | Promote to `CLAUDE.md`, `AGENTS.md`, and/or `.github/copilot-instructions.md` ... Workflow improvements | Promote to `AGENTS.md` ... Tool gotchas | Promote to `TOOLS.md` ... Behavioral patterns | Promote to `SOUL.md`
Recommendation

Require explicit user approval before promotion, sanitize secrets and sensitive context, keep entries scoped, and provide an easy way to review and remove promoted learnings.

What this means

Learnings or transcript excerpts could be shared across sessions more broadly than intended.

Why it was flagged

The skill documents cross-session transcript access, message sending, and sub-agent spawning for sharing learnings. This is purpose-aligned, but it is sensitive and lacks detailed identity, consent, and data-boundary guidance.

Skill content
sessions_history — Read another session's transcript ... sessions_send — Send a learning to another session ... sessions_spawn — Spawn a sub-agent for background work
Recommendation

Use cross-session tools only with user intent, avoid sharing secrets or private transcript details, and clarify which sessions or agents may receive learnings.

What this means

The agent will keep receiving the self-improvement reminder at startup until the hook is disabled.

Why it was flagged

The optional hook persistently injects a reminder into agent bootstrap context. It is disclosed and limited to reminders, but it changes future session context once enabled.

Skill content
if (event.type !== 'agent' || event.action !== 'bootstrap') { return; } ... event.context.bootstrapFiles.push({ path: 'SELF_IMPROVEMENT_REMINDER.md', content: REMINDER_CONTENT, virtual: true })
Recommendation

Enable the hook only if desired, review the injected reminder content, and document how to disable or remove the hook.

What this means

If configured, local scripts run automatically during agent operation with the same permissions as the agent runtime.

Why it was flagged

The documented optional hook setup runs local shell scripts on prompt submission and after Bash tool use. The supplied scripts only print reminders or inspect an environment variable, so this appears purpose-aligned.

Skill content
"UserPromptSubmit" ... "command": "./skills/self-improvement/scripts/activator.sh" ... "PostToolUse" ... "command": "./skills/self-improvement/scripts/error-detector.sh"
Recommendation

Review the scripts before enabling hooks, keep paths pinned to the reviewed files, and avoid enabling modified or untrusted hook scripts.

What this means

It may be harder to confirm that this package is the intended release from the expected publisher.

Why it was flagged

The registry metadata is sparse and differs from the bundled _meta.json, which identifies slug `self-improving-agent` and version `3.0.4`. This is a provenance/versioning ambiguity, not direct malicious behavior.

Skill content
Source: unknown; Homepage: none; Slug: test-skill-delete-me; Version: 1.0.0
Recommendation

Verify the publisher and intended package name/version before installation, especially because the skill can affect persistent agent context.