Claude Reflect - Self-Learning System
Captures your in-session corrections via hooks and applies them to CLAUDE.md through a reviewed /reflect command.
AutomationIntermediate★ 1,694⑂ 147AI score 10/10Last updated: Sep 20, 2026
What it does
- Hooks detect correction phrases ("no, use X", "actually...", "remember:") and queue them into
~/.claude/learnings-queue.json. /reflectwalks you through each queued learning and writes it to the right destination: global CLAUDE.md, project CLAUDE.md, CLAUDE.local.md, or modular rule files.- Extra commands cover previewing (
--dry-run), mining past sessions (--scan-history), inspecting (/view-queue) and clearing (/skip-reflect) the queue. /reflect-skillssurfaces recurring patterns that could become their own skills.
Who it's for
- Daily Claude Code users tired of repeating the same instruction every session.
- Developers accumulating team conventions in a project CLAUDE.md.
- Anyone who wants personal notes separated from shared repo rules.
Examples
- You say "use gpt-5.1 not gpt-5 for reasoning" → queued →
/reflectwrites it to the global CLAUDE.md. - After finishing a feature, run
/reflect --dry-runto preview which rules would be added. - Run
/reflect --scan-historyto recover guidance you gave in earlier sessions but never saved.
· · · Install guide · · ·
Try it now, no install
Paste this into Claude to use the skill without installing anything.
Read the instructions in this file and follow them to help me: https://raw.githubusercontent.com/BayramAnnakov/claude-reflect/HEAD/SKILL.md What I want: (describe your task here)
If Claude can't open the link, open it yourself and paste the contents instead.
↓ If it works for you, download the ZIP below and install it. Then it runs on its own — no pasting each time.
Install in the Claude app (no terminal)
- Download the ZIP with the button below.
- In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
- Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
Install in Claude Code
Let Claude do it — paste this into Claude Code
Install the skill I found on Claude Skill Mart. Copy the SKILL.m folder from the GitHub repo BayramAnnakov/claude-reflect into my ~/.claude/skills/claude-reflect/. When it's done, tell me in one line what this skill can do.
Install with a command instead
git clone https://github.com/BayramAnnakov/claude-reflect.git ~/.claude/skills/claude-reflect⚠ This is a third-party skill. Check the source repository before installing.
- Open a terminal.
- Run
git clone https://github.com/BayramAnnakov/claude-reflect.git ~/.claude/skills/claude-reflect. cd ~/.claude/skills/claude-reflectand run the repo's installer from the README (usually./install.sh) so the hooks and slash commands are registered — the skill file alone does not enable auto-capture.- Restart Claude Code.
- Type
/view-queuein any session to confirm the commands are available. - Make one correction, then run
/reflect --dry-runto preview what would be written.
View source on GitHub ↗License: MIT