Reflection Skill

Overview

This skill is used to periodically reflect on the interaction with the user. It analyzes what worked, what didn't (tool failures), and identifies recurring patterns or explicit user preferences that should be formalized.

Objectives

• Improve Skills: Identify gaps or inefficiencies in existing skill definitions and propose concise updates.
• Store Preferences: Capture user preferences, project-specific rules, or recurring instructions in a CLAUDE.md file.

Process

1. Analyze: Review the conversation history, tool calls, and any failures or corrections from the user.
2. Identify: Determine if a specific behavior should be codified in a skill or if a user preference has emerged.
3. Propose: Formulate a single, concise change.
   • If updating a skill, show a diff of the proposed change.
   • If adding a preference, show the proposed addition to CLAUDE.md.
4. Confirm: Present the proposal to the user and ask for explicit confirmation before applying it.

Guidelines

• One at a time: Only propose one change per invocation to maintain focus and allow for careful review.