reflection

Analyze conversation history and tool usage to propose one improvement.

1|Updated Feb 20, 2026
One-click install
npx skills add https://github.com/makerjackie/jackie-skills-starter --skill reflection-makerjackie
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: reflection
Source: https://github.com/makerjackie/jackie-skills-starter/tree/main/skills/reflection
Command: npx skills add https://github.com/makerjackie/jackie-skills-starter --skill reflection-makerjackie

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The skill reviews conversation history, tool usage, and failures to identify gaps and user preferences, enabling continuous improvement of the AI's behavior.

Core Features & Use Cases

  • Gap Analysis: Detect missing or inefficient skill definitions from recent interactions.
  • Preference Capture: Record user preferences or recurring instructions into a CLAUDE.md file.
  • Proposal Generation: Produce a concise, single change suggestion ready for user confirmation.

Quick Start

Ask the reflection skill to analyze the latest chat and propose one improvement.

Frequently Asked Questions about reflection

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

FAQPage Schema
How do I analyze conversation history to identify AI skill gaps and tool failures?

To analyze conversation history for skill gaps, the reflection skill reviews past interactions and tool usage logs to detect inefficiencies. It evaluates recurring instructions or failures, enabling continuous improvement of AI behavior.

How can I capture user preferences from chat logs into a CLAUDE.md file?

Capturing user preferences from chat logs into a CLAUDE.md file involves analyzing recent interactions to extract recurring instructions. The reflection skill records these preferences automatically, generating a concise change proposal for your confirmation.

What is the best way to generate proposals for AI skill improvement based on recent interactions?

The best way to generate proposals for AI skill improvement is to analyze conversation history for missing definitions or tool failures. The reflection skill produces a single, concise change suggestion ready for user confirmation before execution.

Does the reflection skill require any dependencies to analyze conversations and update preferences?

Analyzing conversations and updating preferences requires no external dependencies to use the reflection skill. It operates independently to evaluate tool usage and propose updates to your CLAUDE.md file based on the current interaction context.

Can I automatically apply changes to CLAUDE.md after analyzing chat history?

You cannot automatically apply changes to CLAUDE.md after analyzing chat history. The reflection skill generates a change proposal and optionally updates the file, but it strictly awaits your explicit confirmation before executing any modifications.

When should I analyze tool usage and conversation history to refine AI behavior?

You should analyze tool usage and conversation history to refine AI behavior whenever you notice recurring instructions, skill gaps, or tool failures. This evaluation process identifies inefficiencies and captures preferences for continuous improvement.