reflect

Extract actionable lessons from conversations and persist them to ~/.claude/lessons/.

1|Updated Jan 8, 2026

Search Tags:#automation #documentation #analysis #conversations #lessons #CLAUDE #reflect

Ready to run

npx skills add https://github.com/Porkbutts/porkbutts-n-taters --skill reflect-porkbutts

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: reflect
Source: https://github.com/Porkbutts/porkbutts-n-taters/tree/main/skills/reflect
Command: npx skills add https://github.com/Porkbutts/porkbutts-n-taters --skill reflect-porkbutts

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you capture and formalize lessons from conversations after mistakes or corrections, turning flawed interactions into reusable guidance for future sessions.

Core Features & Use Cases

Conversation analysis: identify mistakes, corrections, and opportunities for improvement within a dialogue.
Lesson drafting: generate actionable "if we were starting over" guidance that can be applied to future sessions.
Persistence & lookup: save lessons to ~/.claude/lessons/ and update the CLAUDE.md lessons table for quick reference.

Quick Start

Run reflect after a conversation to extract the core lesson, confirm it with the user, and save it to the lessons directory.

Frequently Asked Questions about reflect

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

FAQPage Schema

How do I extract lessons from conversations after making mistakes with CLAUDE?▼

To extract lessons from conversations, run reflect to analyze dialogue, identify root causes of mistakes, and draft actionable improvements. It confirms the lesson with you and saves it to ~/.claude/lessons/ for future reference.

What is the best way to automate documentation of corrections across sessions?▼

Automating documentation of corrections is handled by analyzing conversation dialogue to identify mistakes and generating actionable guidance. The reflect skill persists these lessons to ~/.claude/lessons/ with dated filenames and updates CLAUDE.md.

How does conversation analysis for lessons work?▼

Conversation analysis for lessons works by examining dialogue to identify mistakes, corrections, and root causes. It then drafts "if we were starting over" guidance to apply actionable improvements across future sessions.

Does updating CLAUDE.md with a lessons table require manual file management?▼

Updating CLAUDE.md with a lessons table requires no manual file management. The reflect skill automatically appends extracted lessons to the CLAUDE.md file while saving detailed dated entries to ~/.claude/lessons/.

When do I need to capture actionable lessons from conversations?▼

You need to capture actionable lessons from conversations after mistakes or corrections occur. Running reflect formalizes flawed interactions into reusable guidance, preventing repeated errors in future sessions.