Analyze past session logs to find repeated patterns, forgotten rules, and backtracking moments. Auto-update CLAUDE.md, skills, and rules to address gaps. "Correct once, never again.".
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
## When to Use
- After several sessions of active development
- When you notice Claude making the same mistakes repeatedly
- Periodically (weekly) as a maintenance task
## Process
### 1. Session Log Analysis
Read session files from `~/.claude/projects/` (JSONL format).
Look for:
- Questions Claude asks repeatedly (→ add answer to CLAUDE.md)
- Rules Claude forgets (→ add to .claude/rules/)
- Information Claude keeps re-discovering (→ promote to bootstrap memory)
- Patterns of backtracking (→ create a skill that prevents it)
- Tool call failures (→ improve error handling in hooks)
### 2. Signal Classification
- **High confidence:** Explicit corrections from user → immediately persist
- **Medium confidence:** Patterns that worked well → persist after confirming
- **Low confidence:** Observations → queue for review
### 3. Output
For each finding:
1. Identify which file to update (CLAUDE.md, a rule, a skill, settings)
2. Make the minimal change needed
3. Log the improvement to CONTEXT.md
### 4. Verification
- Confirm CLAUDE.md is still under 80 lines / 2K tokens
- Confirm no conflicting rules exist
- Confirm skills are still discoverable (short descriptions)
…
The line at the top of this page pins the label git:20260526.f887f6c, 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.
GET https://markdownregistry.com/api/v1/artifacts/art_bgwwertdjcz42qlj
GET https://markdownregistry.com/api/v1/resolve?ref=naman10parikh/agentgrid/self-improve
GET https://markdownregistry.com/api/v1/blob/a7b5bd26dd82ac20bb450905867428b09e3bfeaec73788a51f6679526234ccee
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.
naman10parikh/agentgrid · .claude/skills/anthropic-frontend-design/SKILL.md · Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to…
naman10parikh/agentgrid · .claude/skills/architect/SKILL.md · Use when making architectural decisions for the Energy/NRG platform. Loads architecture from VISION.md and debates…
naman10parikh/agentgrid · .claude/skills/ecosystem-reference/SKILL.md · Quick-access directory of Claude Code ecosystem repos, skills, plugins, MCPs, and patterns. Use when improving the…
naman10parikh/agentgrid · .claude/skills/harness-review/SKILL.md · Review an agent's harness (scaffold) for quality, token efficiency, and correctness. Based on harness engineering…
naman10parikh/agentgrid · .claude/skills/integrate-resources/SKILL.md · Process new resources dropped into resources/unread/. Extracts Claude Code tips, tools, patterns and updates the setup…
naman10parikh/agentgrid · .claude/skills/llm-council-critique/SKILL.md · Run a 6-hat brutal LLM Council self-critique on any deliverable, session output, or status update. Surfaces what's…
naman10parikh/agentgrid · .claude/skills/loop-create/SKILL.md · Scaffold a new agent with the full file structure. Use when creating any new agent for the Energy platform. NOTE —…
ginlix-ai/langalpha · plugins/langalpha_service/skills/self-improve/SKILL.md · Report issues and propose fixes to improve your own capabilities when you encounter errors or limitations
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…
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…
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.