self-improve SKILL.md skillA

self-improve from this-hw/claude-code-kit is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add this-hw/claude-code-kit/self-improve@git:20260706.98b1e4a

Pins git:20260706.98b1e4a in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
this-hw/claude-code-kit
Path
plugins/common/skills/self-improve/SKILL.md
Versions recorded
2
Latest version
git:20260706.98b1e4a, committed Jul 6, 2026
First version recorded
Jul 6, 2026
Size
7,965 bytes
Repository stars
4
License
MIT

Propose improvements to agent/skill/rule definitions from accumulated feedback-ledger defects and eval reports. Proposal-only - applies changes exclusively after evals show no regression AND the user approves. Trigger with /self-improve.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Self-Improve

feedback ledger에 누적된 **반복 결함**을 근원(에이전트·스킬·룰 정의)에 반영하는
재귀 개선 루프 — 단, **제안-전용(proposal-only)**이다. 적용은 게이트를 통과해야만 한다.

<HARD-GATE>
정의 파일(.md) 수정을 **적용된 상태로 남기려면** 다음 전부 충족:

1. **커버리지 판정 선행**: 수정 대상에 대응하는 eval 시나리오(`evals/scenarios/<agent>/`)가
   있는가?
   - **있음** → 관련 evals(`--agent <name>`)가 baseline 대비 후퇴 없음(진짜 회귀 없음)
   - **없음**(스킬·룰·시나리오 없는 에이전트) → **eval 게이트는 미적용이다.**
     exit 0을 "게이트 통과"로 계산·보고하는 것은 게이트 착시(false-green)이며 금지.
     "EVAL COVERAGE 없음 — 사용자 승인이 유일한 게이트"임을 명시 고지한다.
2. 사용자가 diff를 보고 **명시적으로 승인**

evals 실행 불가(exit 2 SKIPPED)면 제안까지만 — SKIPPED를 통과로 위장 금지.
자동 커밋 금지 — 커밋은 항상 사용자/메인 세션의 별도 결정.
**승인 전의 워킹 트리는 항상 깨끗해야 한다** (아래 4단계: 모든 분기에서 롤백 후
승인 시에만 재적용 — 미승인 diff가 트리에 잔존하면 게이트 실패로 간주하고 중단).
</HARD-GATE>

> 위치 근거: 학습 루프(ledger→LESSONS)는 "같은 실수를 세션이 회피"하게 하지만,
> 결함의 근원이 정의 파일에 있으면 매 세션 회피 비용을 낸다. 이 스킬은 그 근원을
> 고치는 마지막 단계다. 안전망의 실체는 대상별로 다르다 — eval 커버리지가 있는
> 대상(현재 review-code·fix-bugs·implement-code)은 이중 게이트, 그 외에는
> **사용자 승인 단일 게이트**임을 숨기지 않는다.

## 절차

### 0. 전제

- repo root 기준으로 실행: `ROOT=$(git rev-parse --show-toplevel)` 후 모든 경로는
  `$ROOT` 기준 (CWD 가정 금지).
- 시작 시 `git status --porcelain`으로 대상 정의 파일들이 깨끗한지 확인 — 이미
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add this-hw/claude-code-kit/self-improve@sha256:9f1cd82e8194801e

The line at the top of this page pins the label git:20260706.98b1e4a, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_ypyhssmtdic4h7mj.svg)](https://markdownregistry.com/a/art_ypyhssmtdic4h7mj)

7 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 2 versions of this file, all committed on Jul 6, 2026.

versioncommittedcommitsizeaudit
git:20260706.98b1e4a latest2026-07-06 98b1e4a 7,965 BA view · diff
git:20260706.ffc70732026-07-06 ffc7073 7,271 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (7965 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

this-hw/claude-code-kit · 4 stars · license MIT · pushed 2026-09-09 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_ypyhssmtdic4h7mj
GET https://markdownregistry.com/api/v1/resolve?ref=this-hw/claude-code-kit/self-improve
GET https://markdownregistry.com/api/v1/blob/9f1cd82e8194801e2d33723328a46ea13a7ec3bf7b82d25d1cac87a68ab73898

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from this-hw/claude-code-kit

AGENTS.md AGENTS.md file
this-hw/claude-code-kit · AGENTS.md
git:20260907.4aa2ce7 · audit A · 4 stars
CLAUDE.md CLAUDE.md file
this-hw/claude-code-kit · CLAUDE.md
git:20260907.fd92525 · audit A · 4 stars
agent-creator SKILL.md skill
this-hw/claude-code-kit · plugins/common/skills/agent-creator/SKILL.md · Create Claude Code sub-agents with optimal configuration. Use when users ask to create a new agent, custom agent…
git:20260907.0eeeffb · audit A · 4 stars
agent-teams SKILL.md skill
this-hw/claude-code-kit · plugins/common/skills/agent-teams/SKILL.md · SUPERSEDED by control-loop (kept through claude-code-kit 2.x; removed in the successor hiway-kit) — large-scale…
git:20260907.f1c5a64 · audit A · 4 stars
auto-dev SKILL.md skill
this-hw/claude-code-kit · plugins/common/skills/auto-dev/SKILL.md · Automated development pipeline. Runs a completed Planning Work through Development and Validation phases end-to-end.
git:20260907.0eeeffb · audit A · 4 stars
brainstorming SKILL.md skill
this-hw/claude-code-kit · plugins/common/skills/brainstorming/SKILL.md · Design and spec before any planning or code. MUST USE before new features, creative work, or any implementation…
git:20260907.0eeeffb · audit A · 4 stars
child-session SKILL.md skill
this-hw/claude-code-kit · plugins/common/skills/child-session/SKILL.md · Discipline a worker session loads at dispatch time — verify the brief's premises before implementing, work only on its…
git:20260907.0199550 · audit A · 4 stars
control-loop SKILL.md skill
this-hw/claude-code-kit · plugins/common/skills/control-loop/SKILL.md · Multi-session control discipline for delegating work to worker sessions — investigate, decide, dispatch, verify, and…
git:20260907.02f34c9 · audit A · 4 stars
debug SKILL.md skill
this-hw/claude-code-kit · plugins/common/skills/debug/SKILL.md · Analyze errors and apply fixes. Use when you have an error message, traceback, or failing log to diagnose.
git:20260422.f3e15f6 · audit A · 4 stars
doc-coauthoring SKILL.md skill
this-hw/claude-code-kit · plugins/common/skills/doc-coauthoring/SKILL.md · AI-assisted documentation authoring. Use when writing, reviewing, or updating technical documents and READMEs.
git:20260422.f3e15f6 · audit A · 4 stars
eval-forge SKILL.md skill
this-hw/claude-code-kit · plugins/common/skills/eval-forge/SKILL.md · Turn an observed agent defect into a machine-checkable eval scenario, generated and self-validated in one step. Use…
git:20260827.d054723 · audit A · 4 stars
harness-export SKILL.md skill
this-hw/claude-code-kit · plugins/common/skills/harness-export/SKILL.md · Export the kit's host-neutral rules to AGENTS.md so non-Claude-Code harnesses (Codex, OpenCode, Copilot, Pi, Hermes)…
git:20260827.d054723 · audit A · 4 stars

Every file in this-hw/claude-code-kit

Other files named self-improve

self-improve SKILL.md skill
yeachan-heo/oh-my-claudecode · skills/self-improve/SKILL.md · Autonomous evolutionary code improvement engine with tournament selection
git:20261013.42b37b7 · audit A · 40,624 stars
self-improve SKILL.md skill
zereight/gitlab-mcp · .github/skills/self-improve/SKILL.md · Autonomous evolutionary code improvement engine with tournament selection. Activate when user says: self-improve, self…
git:20260412.9d9ce51 · audit A · 2,088 stars
self-improve SKILL.md skill
tobihagemann/turbo · codex/skills/self-improve/SKILL.md · Extract lessons from the current session, or sweep the project's past sessions when asked, and route them to the…
git:20260927.fa1ba5a · audit A · 418 stars
self-improve SKILL.md skill
tobihagemann/turbo · claude/skills/self-improve/SKILL.md · Extract lessons from the current session, or sweep the project's past sessions when asked, and route them to the…
git:20260927.fa1ba5a · audit A · 418 stars
self-improve SKILL.md skill
danmcinerney/orchflows · example-workflows/self-improve/skills/self-improve/SKILL.md · Review selected native agent history to improve the local environment, custom workflows, or Orchflows itself.
git:20260922.d4c0161 · audit A · 126 stars
self-improve SKILL.md skill
eai-org/agent-toolkit · skills/self-improve/SKILL.md · Capture durable user feedback into the governing skill, doc or check, or propose creating a new skill when no suitable…
v1.13 · audit A · 82 stars
self-improve SKILL.md skill
nitinjain999/platform-skills · plugins/platform-skills/skills/self-improve/SKILL.md · Bootstrap and operate a self-improving agent workspace. Scaffolds .learnings/ and memory/ directories, captures errors…
git:20261018.90b97a9 · audit A · 71 stars
self-improve SKILL.md skill
nitinjain999/platform-skills · skills/self-improve/SKILL.md · Bootstrap and operate a self-improving agent workspace. Scaffolds .learnings/ and memory/ directories, captures errors…
git:20261017.144a17b · audit A · 71 stars

Browse by kind, by grade A, or by owner.