Individual skill

claude-reflect

Self-learning system that captures corrections during sessions and reminds users to run /reflect to update CLAUDE.md. Use when discussing learnings, corrections, or when the user mentions remembering something for future sessions.

SKILL.md

Read pinned source

Source commit b6c42326903af3dd2bf3772b979730a44d8548ca

What was checked

Matches the observed repository HEAD: Yes
Scanner rules are current: Yes
Repository scan complete: Yes
Skill scan complete: Yes
Observed behavior: Network or broad shell
Last checked: Nov 9, 2026

These are observations at the recorded commit, not a guarantee of safety. Review the source before running it.

Install this skill

Choose an agent in your Stack or copy a command below. Commands fetch the pinned commit and copy only this skill directory. Existing destinations are refused. Copying a command does not install anything.

An install command is unavailable: current rules, complete repository and skill scans, an eligible behavior level and a permitted license are required.

Repository context

Repository stars (not skill ratings): 1,933
Repository last updated: Oct 3, 2026
License: MIT

Observed agent integration: claude-code

claude-code Repository topic
claude-skills Repository topic
memory Repository topic
productivity Repository topic
self-learning Repository topic
education Derived category

Files and excerpt

File metadata and permitted, redacted excerpts come from the recorded scan. Source links are pinned to that commit.

Browse files

.claude-plugin/marketplace.jsonasset · 590 bytes
.claude-plugin/plugin.jsonasset · 481 bytes
.github/FUNDING.ymlasset · 22 bytes
.github/workflows/test.ymlasset · 1,010 bytes
.gitignoreasset · 122 bytes
BACKLOG.mddoc · 10,331 bytes
CHANGELOG.mddoc · 18,112 bytes
CLAUDE.mddoc · 7,789 bytes
DISTRIBUTION.mddoc · 10,409 bytes
LICENSEasset · 1,071 bytes
README.mddoc · 18,327 bytes
RELEASING.mddoc · 1,067 bytes
SKILL.mdcore · 2,508 bytes
assets/reflect-demo.jpgasset · 82,005 bytes
assets/reflect-mod-band.pngasset · 38,918 bytes
commands/reflect-skills.mddoc · 12,896 bytes
commands/reflect.mddoc · 65,232 bytes
commands/skip-reflect.mddoc · 997 bytes
commands/view-queue.mddoc · 4,430 bytes
hooks/hooks.jsonasset · 990 bytes
mod/.claude-plugin/plugin.jsonasset · 461 bytes
mod/README.mddoc · 4,071 bytes
mod/hooks/hooks.jsonasset · 34 bytes
mod/hooks/reflect.test.tsxruns · 10,968 bytes
mod/hooks/register.tsxruns · 17,706 bytes
mod/types/index.d.tsruns · 956 bytes
scripts/capture_learning.pyruns · 3,680 bytes
scripts/check_learnings.pyruns · 1,504 bytes
scripts/clear_queue.pyruns · 704 bytes
scripts/compare_detection.pyruns · 14,364 bytes
scripts/extract_session_learnings.pyruns · 1,156 bytes
scripts/extract_tool_errors.pyruns · 5,239 bytes
scripts/extract_tool_rejections.pyruns · 1,024 bytes
scripts/legacy/capture-learning.shruns · 5,372 bytes
scripts/legacy/check-learnings.shruns · 741 bytes
scripts/legacy/extract-session-learnings.shruns · 1,420 bytes
scripts/legacy/extract-tool-rejections.shruns · 1,047 bytes
scripts/legacy/post-commit-reminder.shruns · 1,083 bytes
scripts/lib/__init__.pyruns · 39 bytes
scripts/lib/reflect_utils.pyruns · 75,613 bytes
scripts/lib/semantic_detector.pyruns · 17,788 bytes
scripts/post_commit_reminder.pyruns · 1,707 bytes
scripts/project_paths.pyruns · 2,281 bytes
scripts/read_queue.pyruns · 291 bytes
scripts/session_start_reminder.pyruns · 2,067 bytes
tests/__init__.pyruns · 47 bytes
tests/test_integration.pyruns · 17,744 bytes
tests/test_memory_hierarchy.pyruns · 61,422 bytes
tests/test_reflect_utils.pyruns · 55,067 bytes
tests/test_semantic_detector.pyruns · 26,483 bytes
tests/test_tool_errors.pyruns · 12,292 bytes

Read excerpt


# Claude Reflect - Self-Learning System

A two-stage system that helps Claude Code learn from user corrections.

## How It Works

**Stage 1: Capture (Automatic)**
Hooks detect correction patterns ("no, use X", "actually...", "use X not Y") and queue them to `~/.claude/learnings-queue.json`.

**Stage 2: Process (Manual)**
User runs `/reflect` to review and apply queued learnings to CLAUDE.md files.

## Available Commands