AgentStack
Sign in Publish
MCP servers Skills Toolkits Why AgentStack Sell Docs
Sign in
SKILL verified MIT Self-run

Claude Reflect

skill-bayramannakov-claude-reflect-claude-reflect · by BayramAnnakov

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.

↗ Repository
— No reviews yet
0 installs
11 views
0.0% view→install

Install

$ agentstack add skill-bayramannakov-claude-reflect-claude-reflect

✓ scanned · ✓ verified — works with Claude Code, Cursor, and more.

Security review

✓ Passed

No issues found. Passed automated security review. · v0.1.0 How review works →

  • ✓ Prompt-injection patterns
  • ✓ Secret / credential exfiltration
  • ✓ Dangerous shell & filesystem operations
  • ✓ Untrusted network calls
  • ✓ Known-malicious package signatures

What it can access

  • ✓ Network access No
  • ✓ Filesystem access No
  • ✓ Shell / process execution No
  • ✓ Environment & secrets No
  • ✓ Dynamic code execution No

From automated source analysis of v0.1.0. “Used” means the capability is present in the source — more access means more to trust, not that it’s unsafe.

Are you the author of Claude Reflect? Claim this listing to set pricing, connect Stripe payouts, and keep 70% of every sale.
Sign up to claim

About

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

| Command | Purpose | |---------|---------| | /reflect | Process queued learnings with human review | | /reflect --scan-history | Scan past sessions for missed learnings | | /reflect --dry-run | Preview changes without applying | | /reflect-skills | Discover skill candidates from repeating patterns | | /skip-reflect | Discard all queued learnings | | /view-queue | View pending learnings without processing |

When to Remind Users

Remind users about /reflect when:

  • They complete a feature or meaningful work unit
  • They make corrections you should remember for future sessions
  • They explicitly say "remember this" or similar
  • Context is about to compact and queue has items

Correction Detection Patterns

High-confidence corrections:

  • Tool rejections (user stops an action with guidance)
  • "no, use X" / "don't use Y"
  • "actually..." / "I meant..."
  • "use X not Y" / "X instead of Y"
  • "remember:" (explicit marker)

Learning Destinations

  • ~/.claude/CLAUDE.md - Global learnings (model names, general patterns)
  • ./CLAUDE.md - Project-specific learnings (conventions, tools, structure)
  • ./CLAUDE.local.md - Personal learnings (machine-specific, gitignored)
  • ./.claude/rules/*.md - Modular rules with optional path-scoping
  • ~/.claude/rules/*.md - Global modular rules
  • ~/.claude/projects//memory/*.md - Auto memory (low-confidence, exploratory)
  • commands/*.md - Skill improvements (corrections during skill execution)

Example Interaction

User: no, use gpt-5.1 not gpt-5 for reasoning tasks
Claude: Got it, I'll use gpt-5.1 for reasoning tasks.

[Hook captures this correction to queue]

User: /reflect
Claude: Found 1 learning queued. "Use gpt-5.1 for reasoning tasks"
        Scope: global
        Apply to ~/.claude/CLAUDE.md? [y/n]

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

Install and usage instructions live in the source repository linked above.

Reviews

No reviews yet — be the first.

Write a review

Versions

  • v0.1.0 Imported from the upstream source.

More in Agent Skills