From 488bdcb3a5b8dbaa3f118f5902acd8904c0572aa Mon Sep 17 00:00:00 2001 From: pskoett Date: Thu, 6 Aug 2026 08:30:51 +0200 Subject: [PATCH 1/3] Fix install commands and clone URL in docs, bump to 4.0.1 The advertised `clawdhub install` command does not exist. The working paths are OpenClaw's built-in `openclaw skills install` and the ClawHub CLI `clawhub install` (npm i -g clawhub); both are now documented. The manual `git clone` URL used the wrong owner handle (peterskoett -> pskoett). That handle only resolves through GitHub's web redirect, which git clone does not follow, so manual installs failed on a fresh machine. Also fixes the same two bugs in references/openclaw-integration.md, which was not listed in the issue, and corrects a stale ClawdHub mention in the changelog. Docs-only, so this is a patch release. Closes #24 Co-Authored-By: Claude Opus 5 --- README.md | 14 ++++++++++--- self-improving-agent/CHANGELOG.md | 20 ++++++++++++++++++- self-improving-agent/SKILL.md | 13 ++++++++---- .../references/openclaw-integration.md | 10 ++++++++-- 4 files changed, 47 insertions(+), 10 deletions(-) diff --git a/README.md b/README.md index 187d379..2bbc9b6 100644 --- a/README.md +++ b/README.md @@ -10,7 +10,7 @@ https://github.com/pskoett/pskoett-ai-skills/tree/main/skills/self-improvement ## Repository Layout The publishable skill package is the [`self-improving-agent/`](self-improving-agent/) -subfolder — that is what ClawdHub installs and what you copy into +subfolder — that is what ClawHub installs and what you copy into `~/.openclaw/skills/`. Repo-level files (this README, `.github/` CI) stay outside the package on purpose. @@ -19,14 +19,22 @@ outside the package on purpose. ## Installation +With OpenClaw's built-in skill installer: + +```bash +openclaw skills install self-improving-agent +``` + +Or with the ClawHub CLI (`npm i -g clawhub`): + ```bash -clawdhub install self-improving-agent +clawhub install self-improving-agent ``` Or manually — copy the skill subfolder (not the repo root): ```bash -git clone https://github.com/peterskoett/self-improving-agent.git /tmp/self-improving-agent-repo +git clone https://github.com/pskoett/self-improving-agent.git /tmp/self-improving-agent-repo cp -r /tmp/self-improving-agent-repo/self-improving-agent ~/.openclaw/skills/self-improving-agent ``` diff --git a/self-improving-agent/CHANGELOG.md b/self-improving-agent/CHANGELOG.md index 89ccbeb..115faf4 100644 --- a/self-improving-agent/CHANGELOG.md +++ b/self-improving-agent/CHANGELOG.md @@ -17,6 +17,19 @@ Read this before upgrading. General upgrade rules: ## [Unreleased] +## [4.0.1] - 2026-08-06 + +### Fixed + +- **Install commands and clone URL in the docs were wrong** (#24). The + advertised `clawdhub install` command does not exist; the working commands + are `openclaw skills install self-improving-agent` (built-in) and + `clawhub install self-improving-agent` (ClawHub CLI, `npm i -g clawhub`). + Both are now documented in `README.md`, `SKILL.md`, and + `references/openclaw-integration.md`. The manual `git clone` URL also used + the wrong owner handle (`peterskoett` → `pskoett`); the old handle only + resolved via a web redirect, so `git clone` failed on a fresh machine. + ### Added - GitHub Actions CI (`.github/workflows/ci.yml` at the repo root): runs the @@ -26,7 +39,7 @@ Read this before upgrading. General upgrade rules: ### Changed -- **Repo restructured for ClawdHub publishing**: the skill package now lives +- **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, @@ -37,6 +50,11 @@ Read this before upgrading. General upgrade rules: existing hook installs and `openclaw hooks enable self-improvement` are unaffected. +### Upgrade notes (4.0.0 → 4.0.1) + +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 diff --git a/self-improving-agent/SKILL.md b/self-improving-agent/SKILL.md index a7f6f3b..789f20c 100644 --- a/self-improving-agent/SKILL.md +++ b/self-improving-agent/SKILL.md @@ -1,7 +1,7 @@ --- name: self-improving-agent description: "Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Claude ('No, that's wrong...', 'Actually...'), (3) User requests a capability that doesn't exist, (4) An external API or tool fails, (5) Claude realizes its knowledge is outdated or incorrect, (6) A better approach is discovered for a recurring task. Also review learnings before major tasks." -version: "4.0.0" +version: "4.0.1" metadata: --- @@ -48,15 +48,20 @@ OpenClaw uses workspace-based prompt injection with automatic skill loading. ### Installation -**Via ClawdHub (recommended):** +**Via OpenClaw's built-in installer (recommended):** ```bash -clawdhub install self-improving-agent +openclaw skills install self-improving-agent +``` + +**Via the ClawHub CLI** (`npm i -g clawhub`): +```bash +clawhub install self-improving-agent ``` **Manual** (the skill lives in the repo's `self-improving-agent/` subfolder; copy that folder, not the repo root): ```bash -git clone https://github.com/peterskoett/self-improving-agent.git /tmp/self-improving-agent-repo +git clone https://github.com/pskoett/self-improving-agent.git /tmp/self-improving-agent-repo cp -r /tmp/self-improving-agent-repo/self-improving-agent ~/.openclaw/skills/self-improving-agent ``` diff --git a/self-improving-agent/references/openclaw-integration.md b/self-improving-agent/references/openclaw-integration.md index 5361108..7fea71a 100644 --- a/self-improving-agent/references/openclaw-integration.md +++ b/self-improving-agent/references/openclaw-integration.md @@ -31,14 +31,20 @@ OpenClaw uses workspace-based prompt injection combined with event-driven hooks. ### 1. Install the Skill ```bash -clawdhub install self-improving-agent +openclaw skills install self-improving-agent +``` + +Or with the ClawHub CLI (`npm i -g clawhub`): + +```bash +clawhub install self-improving-agent ``` Or copy manually — the skill package is the `self-improving-agent/` subfolder of the repo, not the repo root: ```bash -git clone https://github.com/peterskoett/self-improving-agent.git /tmp/self-improving-agent-repo +git clone https://github.com/pskoett/self-improving-agent.git /tmp/self-improving-agent-repo cp -r /tmp/self-improving-agent-repo/self-improving-agent ~/.openclaw/skills/self-improving-agent ``` From 2d8836caf56950a6f38f1b9cdf0e0118bde68144 Mon Sep 17 00:00:00 2001 From: pskoett Date: Thu, 6 Aug 2026 08:39:04 +0200 Subject: [PATCH 2/3] Bump to 4.0.2 instead of 4.0.1 4.0.1 is already taken by a build published to ClawHub, so reusing that number here would collide. Retarget this docs fix at 4.0.2 and note the skip in the changelog. Co-Authored-By: Claude Opus 5 --- self-improving-agent/CHANGELOG.md | 7 +++++-- self-improving-agent/SKILL.md | 2 +- 2 files changed, 6 insertions(+), 3 deletions(-) diff --git a/self-improving-agent/CHANGELOG.md b/self-improving-agent/CHANGELOG.md index 115faf4..5c9d738 100644 --- a/self-improving-agent/CHANGELOG.md +++ b/self-improving-agent/CHANGELOG.md @@ -17,7 +17,10 @@ Read this before upgrading. General upgrade rules: ## [Unreleased] -## [4.0.1] - 2026-08-06 +## [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 @@ -50,7 +53,7 @@ Read this before upgrading. General upgrade rules: existing hook installs and `openclaw hooks enable self-improvement` are unaffected. -### Upgrade notes (4.0.0 → 4.0.1) +### 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. diff --git a/self-improving-agent/SKILL.md b/self-improving-agent/SKILL.md index 789f20c..533ca94 100644 --- a/self-improving-agent/SKILL.md +++ b/self-improving-agent/SKILL.md @@ -1,7 +1,7 @@ --- name: self-improving-agent description: "Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Claude ('No, that's wrong...', 'Actually...'), (3) User requests a capability that doesn't exist, (4) An external API or tool fails, (5) Claude realizes its knowledge is outdated or incorrect, (6) A better approach is discovered for a recurring task. Also review learnings before major tasks." -version: "4.0.1" +version: "4.0.2" metadata: --- From f13f6c1175962ca897d5d427db7f658f816328cf Mon Sep 17 00:00:00 2001 From: pskoett Date: Thu, 6 Aug 2026 08:50:37 +0200 Subject: [PATCH 3/3] Use the @pskoett/ scope in install commands MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The install commands still used a bare slug, taken from the issue report. The ClawHub package page and the OpenClaw docs both show the scoped @owner/slug form; a bare slug is only accepted for already-installed or unambiguous skills, so the documented command could fail on a fresh machine — the same class of bug this branch set out to fix. Also note the differing install targets: `openclaw skills install` writes to the active workspace, while `clawhub install` writes to ./skills under the current working directory. Co-Authored-By: Claude Opus 5 --- README.md | 10 ++++++---- self-improving-agent/CHANGELOG.md | 19 ++++++++++++------- self-improving-agent/SKILL.md | 10 ++++++---- .../references/openclaw-integration.md | 7 ++++--- 4 files changed, 28 insertions(+), 18 deletions(-) diff --git a/README.md b/README.md index 2bbc9b6..701e6bb 100644 --- a/README.md +++ b/README.md @@ -19,16 +19,18 @@ outside the package on purpose. ## Installation -With OpenClaw's built-in skill installer: +With OpenClaw's built-in skill installer — this installs into the active +OpenClaw workspace: ```bash -openclaw skills install self-improving-agent +openclaw skills install @pskoett/self-improving-agent ``` -Or with the ClawHub CLI (`npm i -g clawhub`): +Or with the ClawHub CLI (`npm i -g clawhub`). Note this installs into +`./skills` under the current working directory, not the workspace: ```bash -clawhub install self-improving-agent +clawhub install @pskoett/self-improving-agent ``` Or manually — copy the skill subfolder (not the repo root): diff --git a/self-improving-agent/CHANGELOG.md b/self-improving-agent/CHANGELOG.md index 5c9d738..4339a8a 100644 --- a/self-improving-agent/CHANGELOG.md +++ b/self-improving-agent/CHANGELOG.md @@ -25,13 +25,18 @@ Read this before upgrading. General upgrade rules: ### Fixed - **Install commands and clone URL in the docs were wrong** (#24). The - advertised `clawdhub install` command does not exist; the working commands - are `openclaw skills install self-improving-agent` (built-in) and - `clawhub install self-improving-agent` (ClawHub CLI, `npm i -g clawhub`). - Both are now documented in `README.md`, `SKILL.md`, and - `references/openclaw-integration.md`. The manual `git clone` URL also used - the wrong owner handle (`peterskoett` → `pskoett`); the old handle only - resolved via a web redirect, so `git clone` failed on a fresh machine. + 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 diff --git a/self-improving-agent/SKILL.md b/self-improving-agent/SKILL.md index 533ca94..0112f1f 100644 --- a/self-improving-agent/SKILL.md +++ b/self-improving-agent/SKILL.md @@ -48,14 +48,16 @@ OpenClaw uses workspace-based prompt injection with automatic skill loading. ### Installation -**Via OpenClaw's built-in installer (recommended):** +**Via OpenClaw's built-in installer (recommended)** — installs into the +active OpenClaw workspace: ```bash -openclaw skills install self-improving-agent +openclaw skills install @pskoett/self-improving-agent ``` -**Via the ClawHub CLI** (`npm i -g clawhub`): +**Via the ClawHub CLI** (`npm i -g clawhub`) — installs into `./skills` +under the current working directory, not the workspace: ```bash -clawhub install self-improving-agent +clawhub install @pskoett/self-improving-agent ``` **Manual** (the skill lives in the repo's `self-improving-agent/` subfolder; diff --git a/self-improving-agent/references/openclaw-integration.md b/self-improving-agent/references/openclaw-integration.md index 7fea71a..fc8cc69 100644 --- a/self-improving-agent/references/openclaw-integration.md +++ b/self-improving-agent/references/openclaw-integration.md @@ -31,13 +31,14 @@ OpenClaw uses workspace-based prompt injection combined with event-driven hooks. ### 1. Install the Skill ```bash -openclaw skills install self-improving-agent +openclaw skills install @pskoett/self-improving-agent ``` -Or with the ClawHub CLI (`npm i -g clawhub`): +Or with the ClawHub CLI (`npm i -g clawhub`) — note this installs into +`./skills` under the current working directory, not the workspace: ```bash -clawhub install self-improving-agent +clawhub install @pskoett/self-improving-agent ``` Or copy manually — the skill package is the `self-improving-agent/`