openclaw-config/workspace-resume/skills/self-improving-agent/CHANGELOG.md

Changelog

All notable changes to this skill are documented here, including anything an agent or user must do when upgrading. Format follows Keep a Changelog; versions follow SemVer and match version in SKILL.md frontmatter.

Read this before upgrading. General upgrade rules:

• OpenClaw hook changes only take effect after re-copying and restarting. The hook runs from a copy: re-run cp -r ~/.openclaw/skills/self-improving-agent/hooks/openclaw ~/.openclaw/hooks/self-improvement and restart the gateway after upgrading.
• .learnings/ files are user data and are never migrated or overwritten by upgrades; first-use initialisation is idempotent and only creates missing files.

[Unreleased]

[4.0.2] - 2026-08-06

4.0.1 is skipped: that version number was already used by a build published to ClawHub, so it is not reusable here.

Fixed

• Install commands and clone URL in the docs were wrong (#24). The advertised clawdhub install command does not exist. The documented commands are now openclaw skills install @pskoett/self-improving-agent (built-in, installs into the active workspace) and clawhub install @pskoett/self-improving-agent (ClawHub CLI, npm i -g clawhub, installs into ./skills under the current working directory). Both take the @owner/slug form — a bare slug is only accepted for already-installed or unambiguous skills. Fixed in README.md, SKILL.md, and references/openclaw-integration.md.
• The manual git clone URL used the wrong owner handle (peterskoett → pskoett). The old handle only resolved via a web redirect, which git clone does not follow, so manual installs failed on a fresh machine.

Added

• GitHub Actions CI (.github/workflows/ci.yml at the repo root): runs the hook test suite, type-checks handler.ts (strict mode, against a CI-only type stub), and syntax-checks extract-skill.sh on every push to master and every PR.

Changed

• Repo restructured for ClawHub publishing: the skill package now lives in the repo's self-improving-agent/ subfolder (SKILL.md, assets, hooks, references, scripts, this changelog), keeping repo-level files (README, .github/) out of the published skill. Install by copying the subfolder, not the repo root — install/upgrade commands in the docs are updated.
• SKILL.md frontmatter name corrected from self-improvement to self-improving-agent to match the skill folder name, as the Agent Skills spec requires. The OpenClaw hook keeps its self-improvement name, so existing hook installs and openclaw hooks enable self-improvement are unaffected.

Upgrade notes (4.0.x → 4.0.2)

Documentation only — no skill behavior, hook, or .learnings/ changes. No action needed beyond reinstalling if you want the corrected install docs.

[4.0.0] - 2026-07-04

Removed

• This distribution is now OpenClaw-only. Removed the Claude Code / Codex / Copilot integrations: scripts/activator.sh, scripts/error-detector.sh, references/hooks-setup.md, and the multi-agent setup/support sections in SKILL.md and references/uninstall.md. For other agents, use the original multi-agent version: https://github.com/pskoett/pskoett-ai-skills.

Changed

• Promotion targets are now the OpenClaw workspace files (SOUL.md, TOOLS.md, AGENTS.md), with the project's own agent file as the target for project-specific patterns.
• Hook docs and code comments describe the session-end sweep on its own terms (OpenClaw has no per-tool-call event) instead of contrasting with other platforms.

Upgrade notes (0.3.0 → 4.0.0)

1. If you configured the Claude Code/Codex hooks from earlier versions, remove the stale .claude/settings.json / .codex/settings.json entries pointing at activator.sh / error-detector.sh, and switch to the original multi-agent skill for those platforms.
2. Nothing changes for OpenClaw installs beyond the usual re-copy of the hook directory; .learnings/ data and entry formats are unaffected.

[0.3.0] - 2026-07-04

Added

• Pattern-Key generalized to all three log files: the ERRORS.md and FEATURE_REQUESTS.md entry formats now carry a Pattern-Key field (recommended for errors, optional for features), joining LEARNINGS.md where it was previously limited to the simplify-and-harden feed.
• Pattern-Key Taxonomy section in SKILL.md: controlled area.symptom namespaces (api, auth, build, config, deps, fs, net, runtime, shell, vcs, plus simplify/harden), with reuse-before-mint and one-key-per-entry rules.
• The OpenClaw session-end error sweep stamps deterministic Pattern-Key values on auto-detected entries (e.g. ModuleNotFoundError → deps.module-not-found), making them recurrence-countable with no agent discipline required.

Changed

• Grep-by-Pattern-Key is now the documented default dedup step when logging; keyword grep is the fallback. Recurrences are folded into the existing entry (Recurrence-Count, Last-Seen, See Also) instead of duplicated.
• Tightened SKILL.md (hook sections, taxonomy, duplicated setup blocks) to keep the always-loaded skill prompt compact.

Fixed

• scripts/extract-skill.sh is now committed with the executable bit set — previously every install needed a manual chmod +x.

Upgrade notes (0.2.0 → 0.3.0)

1. Re-copy the OpenClaw hook and restart the gateway (see general rules above) to get Pattern-Key stamping on swept entries.
2. Existing .learnings/ entries without Pattern-Key remain valid — the field is additive. Add keys opportunistically when touching old entries.

[0.2.0] - 2026-07-04

Added

• OpenClaw session-end error sweep (hooks/openclaw/): the hook now also fires on command:new / command:reset, scans the ended session's transcript for the same error patterns as scripts/error-detector.sh, and appends pending entries (Source: openclaw-error-sweep) to <workspace>/.learnings/ERRORS.md. Opt-in: runs only when <workspace>/.learnings/ exists. Excerpts are capped, truncated, redacted, and deduplicated.
• Pending-triage note in the bootstrap reminder when auto-detected error entries await review.
• Test suite: node --test hooks/openclaw/handler.test.js (no dependencies).
• Docs: "Error Detection on OpenClaw" section and platform support matrix in references/openclaw-integration.md; uninstall guide in references/uninstall.md; this changelog.

Changed

• hooks/openclaw/HOOK.md events metadata is now ["agent:bootstrap", "command:new", "command:reset"].
• Docs now state explicitly that scripts/error-detector.sh is Claude Code only (OpenClaw has no PostToolUse equivalent).

Upgrade notes (0.1.x → 0.2.0)

1. Re-copy the hook and restart the gateway (see general rules above).
2. To enable the new error sweep: mkdir -p ~/.openclaw/workspace/.learnings. Without that directory, behavior is identical to 0.1.0.
3. No breaking changes; no .learnings/ migration needed.

[0.1.0] - 2026-01-31

Added

• Initial release: SKILL.md with logging formats (LEARNINGS.md, ERRORS.md, FEATURE_REQUESTS.md), promotion workflow, and skill extraction.
• OpenClaw bootstrap-reminder hook (agent:bootstrap).
• Claude Code hook scripts: activator.sh (UserPromptSubmit) and error-detector.sh (PostToolUse).
• Reference guides for hooks setup and OpenClaw integration.