reflect

Analyze conversation history to propose targeted CLAUDE.md memory file improvements.

42|2|Updated Nov 20, 2025
One-click install
npx skills add https://github.com/robbyt/claude-skills --skill reflect
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: reflect
Source: https://github.com/robbyt/claude-skills/tree/main/plugins/claude-md/skills/reflect
Command: npx skills add https://github.com/robbyt/claude-skills --skill reflect

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Analyze recent conversation to identify improvements for CLAUDE.md memory files.

Core Features & Use Cases

  • Memory improvements: Detect repetition and missing context.
  • Change proposals: Suggest concrete edits to CLAUDE.md memories.
  • Safe execution: Use non-destructive prompts.

Quick Start

Run the reflection workflow and present changes to memory files for approval.

Frequently Asked Questions about reflect

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I improve my CLAUDE.md memory files based on recent conversations?

Analyze recent conversation history to identify repeated corrections, misunderstandings, and missing context in your CLAUDE.md memory files. The reflection workflow detects these patterns across three phases—initial analysis, interaction, and implementation—then proposes concrete, targeted edits with justification to strengthen memory consistency.

What kinds of problems can memory file reflection detect?

Reflection identifies repeated corrections you've made, gaps in context that caused misunderstandings, inconsistencies between related instructions, and misfiled information within CLAUDE.md. It surfaces these issues with precise locations and proposes specific edits to prevent recurrence.

How do I apply reflection changes to my memory files safely?

The reflection workflow presents proposed changes for your approval before any edits occur. Changes are minimal and targeted, respecting existing structure and supported memory locations. You review each change, its justification, and constraints before implementation.

Can I use reflection if my memory files have complex organization?

Yes. Reflection maintains your existing CLAUDE.md structure while proposing edits to specific sections. It respects import behavior and anti-pattern guidance, ensuring changes integrate cohesively without restructuring your memory layout.

What makes a reflection change testable and valid?

Changes are testable when they address measurable problems—repeated misunderstandings, conflicting instructions, or missing context. Each proposed edit includes targets, justification, and expected outcomes, allowing you to verify whether the change prevents the original issue.