skills.rest
Porkbutts
PorkbuttsCOMMUNITY
Explore all skills by this author →
GitHub

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
One-click install
npx skills add https://github.com/Porkbutts/porkbutts-n-taters --skill reflect-porkbutts
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Content & Communication Skills→
hanamizukihanamizuki
127

session-retro

Analyze session mistakes and trace root causes into process improvements.

Community
Advanced
straubt1straubt1
109

reflection

Extract actionable lessons from a session and update CLAUDE.md.

Community
Advanced
elihuvillarauselihuvillaraus
2

always-on-memory

Synchronize persistent coding session context across Claude, Gemini, and GitHub Copilot.

Community
Advanced
NimbleBrainIncNimbleBrainInc
2

contrarian-thought-partner

Identify logical gaps and broken assumptions in strategies and plans.

Official
Advanced