#552 by GitHub stars
BayramAnnakov/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.
History
Review weekly changes to SKILL.md before updating. Dates mark the weeks in which we observed each version; checks apply to the recorded commits.
View weekly changes
SKILL.md
Week of Oct 26, 2026 · +0 / −0 lines
Before Network or broad shell → After Network or broad shell
b6c42326903a → b6c42326903a
Verified commit b6c42326903af3dd2bf3772b979730a44d8548ca
git clone --filter=blob:none --no-checkout https://github.com/BayramAnnakov/claude-reflect.git .hotskills/bayramannakov-claude-reflect && git -C .hotskills/bayramannakov-claude-reflect checkout --detach b6c42326903af3dd2bf3772b979730a44d8548ca
# Copy each selected skill directory from .hotskills/bayramannakov-claude-reflect into .claude/skills/<skill-name>/Heat
4.8- Star growth, last 7 daysAhead of 77% of tracked repositories
- Star growth, last 24 hoursAhead of 84% of tracked repositories
- Rank movement, last 7 daysAhead of 17% of tracked repositories
- Commits, last 30 daysAhead of 0% of tracked repositories
- Accounts asking about it through MCP, last 7 daysNot available
- Hot votes this weekAhead of 0% of tracked repositories
Heat never changes the order by stars, and sponsorship never touches it. How heat works
Stars over time
Individual skills in this repository
How it works
claude-reflect
When your agent uses it
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.
What it loads into context
Frontmatter
50 tokensAlways available to the agent
SKILL.md
618 tokensWhen the skill is activated
Reference documents
35,331 tokensLoaded on request
Token counts are estimates. Scripts run separately; they are not counted as reference context.
The playbook
- How It Works
- Available Commands
- When to Remind Users
- Correction Detection Patterns
- Learning Destinations
- Example Interaction
Scripts executed separately
mod/hooks/reflect.test.tsxmod/hooks/register.tsxmod/types/index.d.tsscripts/capture_learning.pyscripts/check_learnings.pyscripts/clear_queue.pyscripts/compare_detection.pyscripts/extract_session_learnings.pyscripts/extract_tool_errors.pyscripts/extract_tool_rejections.pyscripts/legacy/capture-learning.shscripts/legacy/check-learnings.shscripts/legacy/extract-session-learnings.shscripts/legacy/extract-tool-rejections.shscripts/legacy/post-commit-reminder.shscripts/lib/__init__.pyscripts/lib/reflect_utils.pyscripts/lib/semantic_detector.pyscripts/post_commit_reminder.pyscripts/project_paths.pyscripts/read_queue.pyscripts/session_start_reminder.pytests/__init__.pytests/test_integration.pytests/test_memory_hierarchy.pytests/test_reflect_utils.pytests/test_semantic_detector.pytests/test_tool_errors.py
Files
.claude-plugin/marketplace.jsonasset590 bytes.claude-plugin/plugin.jsonasset481 bytes.github/FUNDING.ymlasset22 bytes.github/workflows/test.ymlasset1,010 bytes.gitignoreasset122 bytesBACKLOG.mddoc10,331 bytesCHANGELOG.mddoc18,112 bytesCLAUDE.mddoc7,789 bytesDISTRIBUTION.mddoc10,409 bytesLICENSEasset1,071 bytesREADME.mddoc18,327 bytesRELEASING.mddoc1,067 bytesSKILL.mdcore2,508 bytesassets/reflect-demo.jpgasset82,005 bytesassets/reflect-mod-band.pngasset38,918 bytescommands/reflect-skills.mddoc12,896 bytescommands/reflect.mddoc65,232 bytescommands/skip-reflect.mddoc997 bytescommands/view-queue.mddoc4,430 byteshooks/hooks.jsonasset990 bytesmod/.claude-plugin/plugin.jsonasset461 bytesmod/README.mddoc4,071 bytesmod/hooks/hooks.jsonasset34 bytesmod/hooks/reflect.test.tsxruns10,968 bytesmod/hooks/register.tsxruns17,706 bytesmod/types/index.d.tsruns956 bytesscripts/capture_learning.pyruns3,680 bytesscripts/check_learnings.pyruns1,504 bytesscripts/clear_queue.pyruns704 bytesscripts/compare_detection.pyruns14,364 bytesscripts/extract_session_learnings.pyruns1,156 bytesscripts/extract_tool_errors.pyruns5,239 bytesscripts/extract_tool_rejections.pyruns1,024 bytesscripts/legacy/capture-learning.shruns5,372 bytesscripts/legacy/check-learnings.shruns741 bytesscripts/legacy/extract-session-learnings.shruns1,420 bytesscripts/legacy/extract-tool-rejections.shruns1,047 bytesscripts/legacy/post-commit-reminder.shruns1,083 bytesscripts/lib/__init__.pyruns39 bytesscripts/lib/reflect_utils.pyruns75,613 bytesscripts/lib/semantic_detector.pyruns17,788 bytesscripts/post_commit_reminder.pyruns1,707 bytesscripts/project_paths.pyruns2,281 bytesscripts/read_queue.pyruns291 bytesscripts/session_start_reminder.pyruns2,067 bytestests/__init__.pyruns47 bytestests/test_integration.pyruns17,744 bytestests/test_memory_hierarchy.pyruns61,422 bytestests/test_reflect_utils.pyruns55,067 bytestests/test_semantic_detector.pyruns26,483 bytestests/test_tool_errors.pyruns12,292 bytes
Read SKILL.md
# 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
View the complete source on GitHubSkills included
- claude-reflect
Repository facts
- License
- MIT
- Created
- Jan 3, 2026
- Last pushed
- Oct 3, 2026
- Forks
- 174
- Open issues
- 6
- Project activity
- Active
Rank over the last 12 weeks
Now #552 · best #460 · down 45 in 30 days
- #541 on Nov 1
- #543 on Nov 2
- #545 on Nov 3
- #547 on Nov 4
- #550 on Nov 5
- #552 since Nov 6
63 earlier periods
- #466 on Aug 2
- #485 on Aug 6
- #469 on Aug 8
- #490 on Aug 10
- #484 on Aug 11
- #469 on Aug 12
- #475 on Aug 13
- #467 on Aug 14
- #455 on Aug 15
- #468 on Aug 17
- #477 on Aug 18
- #474 on Aug 20
- #460 on Aug 22
- #478 on Aug 24
- #484 on Aug 25
- #476 on Aug 26
- #490 on Aug 27
- #488 on Aug 28
- #482 on Aug 29
- #470 on Aug 30
- #492 on Aug 31
- #489 on Sep 4
- #488 on Sep 5
- #496 on Sep 6
- #515 on Sep 8
- #507 on Sep 10
- #509 on Sep 16
- #487 on Sep 17
- #488 on Sep 18
- #467 on Sep 19
- #479 from Sep 20 to Sep 21
- #488 on Sep 22
- #481 on Sep 23
- #472 on Sep 24
- #473 on Sep 25
- #471 on Sep 26
- #485 on Sep 27
- #500 on Sep 29
- #496 on Sep 30
- #469 on Oct 4
- #495 on Oct 7
- #507 on Oct 8
- #500 on Oct 9
- #495 on Oct 10
- #492 on Oct 11
- #506 on Oct 12
- #500 on Oct 13
- #503 on Oct 14
- #501 on Oct 15
- #506 on Oct 16
- #493 on Oct 17
- #497 on Oct 18
- #514 on Oct 19
- #516 on Oct 20
- #519 on Oct 21
- #510 on Oct 22
- #505 on Oct 23
- #491 on Oct 24
- #535 on Oct 25
- #536 on Oct 28
- #537 on Oct 29
- #538 on Oct 30
- #539 on Oct 31
Before you install
Network or broad shellAutomated signals, not a guarantee
Checked Nov 3, 2026
- 4 broad permissionsin 4 files: commands/reflect-skills.md:1 commands/reflect.md:1 commands/skip-reflect.md:1 and 1 more
- 2 dangerous shell commandsin 1 file: README.md:316
- 64 network referencesin 7 files: DISTRIBUTION.md:9 README.md:3 .claude-plugin/plugin.json:5 and 4 more
- No hidden or obfuscated text
- No instruction overrides
- 28 executable scriptsin 28 files: mod/hooks/reflect.test.tsx:1 mod/hooks/register.tsx:1 mod/types/index.d.ts:1 and 25 more
- 12 references to secretsin 3 files: scripts/lib/reflect_utils.py:222 commands/reflect.md:689 scripts/session_start_reminder.py:21
- No requests to vote in Hot
Show all 110 signals by file
.claude-plugin/plugin.json
- Network accessline 5
"author": { "name": "Bayram Annakov", "url": "https://github.com/bayramannakov" - Network accessline 6
"name": "Bayram Annakov", "url": "https://github.com/bayramannakov" }, - Network accessline 7
"url": "https://github.com/bayramannakov" - Network accessline 8
}, "repository": "https://github.com/bayramannakov/claude-reflect", "license": "MIT", - Network accessline 9
"repository": "https://github.com/bayramannakov/claude-reflect",
CHANGELOG.md
DISTRIBUTION.md
- Network accessline 9
| Platform | Type | Estimated Reach | Status | |----------|------|-----------------|--------| | [anthropics/claude-plugins-official](https://github.com/anthropics/claude-plugins-official) | Official Marketplace | Highest | [PR #111](https:/ - Network accessline 10
|----------|------|-----------------|--------| | [anthropics/claude-plugins-official](https://github.com/anthropics/claude-plugins-official) | Official Marketplace | Highest | [PR #111](https://github.com/anthropics/claude-plugins-official/ - Network accessline 11
| [anthropics/claude-plugins-official](https://github.com/anthropics/claude-plugins-official) | Official Marketplace | Highest | [PR #111](https://github.com/anthropics/claude-plugins-official/pull/111) | - Network accessline 12
| [ccplugins/awesome-claude-code-plugins](https://github.com/ccplugins/awesome-claude-code-plugins) | Curated List | ~1k+ stars | [PR #8](https://github.com/ccplugins/awesome-claude-code-plugins/pull/8) | - Network accessline 13
| [jeremylongshore/claude-code-plugins-plus](https://github.com/jeremylongshore/claude-code-plugins-plus) | Marketplace (243+ plugins) | High | [PR #241](https://github.com/jeremylongshore/claude-code-plugins-plus-skills/pull/241) | - Network accessline 17
| Platform | Type | Status | |----------|------|--------| | [GiladShoham/awesome-claude-plugins](https://github.com/GiladShoham/awesome-claude-plugins) | Marketplace | Ready | - Network accessline 18
|----------|------|--------| | [GiladShoham/awesome-claude-plugins](https://github.com/GiladShoham/awesome-claude-plugins) | Marketplace | Ready | | [hekmon8/awesome-claude-code-plugins](https://github.com/hekmon8/awesome-claude-code-plugin - Network accessline 19
| [GiladShoham/awesome-claude-plugins](https://github.com/GiladShoham/awesome-claude-plugins) | Marketplace | Ready | - Network accessline 20
| [hekmon8/awesome-claude-code-plugins](https://github.com/hekmon8/awesome-claude-code-plugins) | Curated List | Ready | - Network accessline 21
| [jmanhype/awesome-claude-code](https://github.com/jmanhype/awesome-claude-code) | Curated List | Ready | - Network accessline 22
| [hesreallyhim/awesome-claude-code](https://github.com/hesreallyhim/awesome-claude-code) | Workflows/Hooks Focus | Ready | - Network accessline 26
| Platform | Type | Status | |----------|------|--------| | [claudecodecommands.directory](https://claudecodecommands.directory/submit) | Web Directory | Ready | - Network accessline 27
|----------|------|--------| | [claudecodecommands.directory](https://claudecodecommands.directory/submit) | Web Directory | Ready | | [claude-plugins.dev](https://claude-plugins.dev) | Community Registry | Ready | - Network accessline 28
| [claudecodecommands.directory](https://claudecodecommands.directory/submit) | Web Directory | Ready | - Network accessline 29
| [claude-plugins.dev](https://claude-plugins.dev) | Community Registry | Ready | - Network accessline 30
| [ananddtyagi/cc-marketplace](https://github.com/ananddtyagi/claude-code-marketplace) | Marketplace | Ready | - Network accessline 88
- Repository: https://github.com/bayramannakov/claude-reflect - Network accessline 105
- [claude-reflect](https://github.com/bayramannakov/claude-reflect) - Self-learning system that captures corrections during sessions and syncs to CLAUDE.md. Features hook-based detection, confidence scoring, and multi-target export to AGENT - Network accessline 135
"author": { "name": "Bayram Annakov", "url": "https://github.com/bayramannakov" - Network accessline 136
"name": "Bayram Annakov", "url": "https://github.com/bayramannakov" }, - Network accessline 137
"url": "https://github.com/bayramannakov" - Network accessline 138
}, "repository": "https://github.com/bayramannakov/claude-reflect", "license": "MIT", - Network accessline 139
"repository": "https://github.com/bayramannakov/claude-reflect", - Network accessline 184
Repository: https://github.com/bayramannakov/claude-reflect - Network accessline 214
### Workflow Orchestration - [claude-reflect](https://github.com/bayramannakov/claude-reflect) - Captures corrections during sessions and syncs to CLAUDE.md with human review. Includes hooks for automatic detection and confidence scoring. - Network accessline 215
- [claude-reflect](https://github.com/bayramannakov/claude-reflect) - Captures corrections during sessions and syncs to CLAUDE.md with human review. Includes hooks for automatic detection and confidence scoring. - Network accessline 226
- **[claude-reflect](https://github.com/bayramannakov/claude-reflect)** - Self-learning system that captures corrections and updates CLAUDE.md automatically - Network accessline 241
### Hooks - [claude-reflect](https://github.com/bayramannakov/claude-reflect) - Self-learning hooks that capture corrections (PreCompact backup, PostToolUse reminders) and sync to CLAUDE.md via `/reflect` command. - Network accessline 242
- [claude-reflect](https://github.com/bayramannakov/claude-reflect) - Self-learning hooks that capture corrections (PreCompact backup, PostToolUse reminders) and sync to CLAUDE.md via `/reflect` command. - Network accessline 249
**URL**: https://claudecodecommands.directory/submit - Network accessline 255
| Name | claude-reflect | | Description | Self-learning system that captures corrections during Claude Code sessions and syncs them to CLAUDE.md with human review | | Repository URL | https://github.com/bayramannakov/claude-reflect | - Network accessline 256
| Description | Self-learning system that captures corrections during Claude Code sessions and syncs them to CLAUDE.md with human review | | Repository URL | https://github.com/bayramannakov/claude-reflect | | Category | Workflow / Developm - Network accessline 257
| Repository URL | https://github.com/bayramannakov/claude-reflect | - Network accessline 266
**GitHub**: https://github.com/Kamalnrf/claude-code-plugins - Network accessline 311
- Keep descriptions consistent across platforms - Link back to main repo: https://github.com/bayramannakov/claude-reflect - Network accessline 312
- Link back to main repo: https://github.com/bayramannakov/claude-reflect
README.md
- Network accessline 3
[](https://github.com/BayramAnnakov/claude-reflect/stargazers) - Network accessline 4
[](https://github.com/BayramAnnakov/claude-reflect/releases) - Network accessline 5
[](https://opensource.org/licenses/MIT) - Network accessline 6
[](https://github.com/BayramAnnakov/claude-reflect/actions) - Network accessline 7
[](https://github.com/BayramAnnakov/claude-reflect#platform-support) - Network accessline 78
- [Claude Code](https://claude.ai/code) CLI installed - Network accessline 89
Claude Code [mods](https://claude.dev/blog/getting-started-with-claude-code-mods/) run inside the session, so the - Network accessline 307
If you see errors like "Duplicate hooks file detected" or "No such file or directory" after updating, you need to clear the plugin cache. This is due to known Claude Code caching issues: - [#14061](https://github.com/anthropics/claude-code/ - Network accessline 308
- [#14061](https://github.com/anthropics/claude-code/issues/14061) - `/plugin update` doesn't invalidate cache - Network accessline 309
- [#15369](https://github.com/anthropics/claude-code/issues/15369) - Uninstall doesn't clear cached files - Dangerous shell operationline 316
rm -rf ~/.claude/plugins/marketplaces/claude-reflect-marketplace - Dangerous shell operationline 317
rm -rf ~/.claude/plugins/cache/claude-reflect-marketplace
commands/reflect-skills.md
- Broad permissionsline 1
Read, Write, Bash, Glob, Grep, AskUserQuestion, TodoWrite
commands/reflect.md
- Broad permissionsline 1
Read, Edit, Write, Glob, Bash, Grep, AskUserQuestion, TodoWrite - Access to secretsline 689
[Credential-related source omitted] - Access to secretsline 691
[Credential-related source omitted] - Access to secretsline 738
[Credential-related source omitted] - Access to secretsline 742
[Credential-related source omitted]
commands/skip-reflect.md
- Broad permissionsline 1
Bash
commands/view-queue.md
- Broad permissionsline 1
Bash, Read
mod/.claude-plugin/plugin.json
- Network accessline 6
"author": { "name": "Bayram Annakov", "url": "https://github.com/bayramannakov" - Network accessline 7
"name": "Bayram Annakov", "url": "https://github.com/bayramannakov" }, - Network accessline 8
"url": "https://github.com/bayramannakov" - Network accessline 9
}, "repository": "https://github.com/bayramannakov/claude-reflect", "license": "MIT" - Network accessline 10
"repository": "https://github.com/bayramannakov/claude-reflect",
mod/README.md
- Network accessline 3
claude-reflect as a [Claude Code mod](https://claude.dev/blog/getting-started-with-claude-code-mods/): an in-process
mod/hooks/reflect.test.tsx
- Executable scriptline 1
Executable file
mod/hooks/register.tsx
- Executable scriptline 1
Executable file
mod/types/index.d.ts
- Executable scriptline 1
Executable file
scripts/capture_learning.py
- Executable scriptline 1
#!/usr/bin/env python3
scripts/check_learnings.py
- Executable scriptline 1
#!/usr/bin/env python3
scripts/clear_queue.py
- Executable scriptline 1
#!/usr/bin/env python3
scripts/compare_detection.py
- Executable scriptline 1
#!/usr/bin/env python3
scripts/extract_session_learnings.py
- Executable scriptline 1
#!/usr/bin/env python3
scripts/extract_tool_errors.py
- Executable scriptline 1
#!/usr/bin/env python3
scripts/extract_tool_rejections.py
- Executable scriptline 1
#!/usr/bin/env python3
scripts/legacy/capture-learning.sh
- Executable scriptline 1
#!/bin/bash
scripts/legacy/check-learnings.sh
- Executable scriptline 1
#!/bin/bash
scripts/legacy/extract-session-learnings.sh
- Executable scriptline 1
#!/bin/bash
scripts/legacy/extract-tool-rejections.sh
- Executable scriptline 1
#!/bin/bash
scripts/legacy/post-commit-reminder.sh
- Executable scriptline 1
#!/bin/bash
scripts/lib/__init__.py
- Executable scriptline 1
Executable file
scripts/lib/reflect_utils.py
- Executable scriptline 1
#!/usr/bin/env python3 - Access to secretsline 222
[Credential-related source omitted] - Access to secretsline 1749
[Credential-related source omitted] - Access to secretsline 1751
[Credential-related source omitted] - Access to secretsline 1752
[Credential-related source omitted] - Access to secretsline 1756
[Credential-related source omitted] - Access to secretsline 1759
[Credential-related source omitted] - Access to secretsline 1762
[Credential-related source omitted]
scripts/lib/semantic_detector.py
- Executable scriptline 1
#!/usr/bin/env python3
scripts/post_commit_reminder.py
- Executable scriptline 1
#!/usr/bin/env python3
scripts/project_paths.py
- Executable scriptline 1
#!/usr/bin/env python3
scripts/read_queue.py
- Executable scriptline 1
#!/usr/bin/env python3
scripts/session_start_reminder.py
tests/__init__.py
- Executable scriptline 1
Executable file
tests/test_integration.py
- Executable scriptline 1
#!/usr/bin/env python3
tests/test_memory_hierarchy.py
- Executable scriptline 1
#!/usr/bin/env python3 - Network accessline 511
"""https://, http://, mailto:, and other schemes are ignored.""" - Network accessline 512
f = self._write( "CLAUDE.md", "[GitHub](https://github.com/x.md)\n" - Network accessline 513
"CLAUDE.md", "[GitHub](https://github.com/x.md)\n" "[Site](http://example.com/y.md)\n" - Network accessline 514
"[GitHub](https://github.com/x.md)\n" - Network accessline 515
"[Site](http://example.com/y.md)\n"
tests/test_reflect_utils.py
- Executable scriptline 1
#!/usr/bin/env python3
tests/test_semantic_detector.py
- Executable scriptline 1
#!/usr/bin/env python3
tests/test_tool_errors.py
- Executable scriptline 1
#!/usr/bin/env python3
How the signals fit together
Facts from a static read of the files at the pinned commit. They describe what the code does, not why.
Some files could not be read; the facts below still hold.
Signal confidence: 3 facts
- Network access in prose of documentationREADME.md:89Low confidence
- Dangerous shell operation in code of documentationREADME.md:316Low confidence
- Dangerous shell operation in code of documentationREADME.md:317Low confidence
Works with
| Agent | Status | Evidence | Install to |
|---|---|---|---|
| Claude Code | Native | Manifest .claude-plugin/marketplace.json | .claude/skills/<skill-name>/ |
| Codex | Compatible | Standard SKILL.md SKILL.md | .agents/skills/<skill-name>/ |
| Cursor | Compatible | Standard SKILL.md SKILL.md | .cursor/skills/<skill-name>/ |
| Gemini CLI | Compatible | Standard SKILL.md SKILL.md | .gemini/skills/<skill-name>/ |
| GitHub Copilot | Compatible | Standard SKILL.md SKILL.md | .github/skills/<skill-name>/ |
| OpenCode | Compatible | Standard SKILL.md SKILL.md | .opencode/skills/<skill-name>/ |
- Native The repository ships a manifest, folder or frontmatter field for this agent.
- Compatible A standard SKILL.md that this agent can read.
- Unknown No evidence either way.
Derived automatically from paths, manifests and frontmatter. Not tested on each agent.
Add this badge to your README
It updates every night and links to this page.
[](https://hotskills.dev/skill/bayramannakov-claude-reflect/)