reflection

Generate structured reflection frameworks capturing learnings and skill improvements.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/sernstberger/base-joy --skill reflection
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: reflection
Source: https://github.com/sernstberger/base-joy/tree/main/.claude/skills/reflection
Command: npx skills add https://github.com/sernstberger/base-joy --skill reflection

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Reflect on work to capture learnings, patterns, and skill improvements. Use at natural breakpoints (after completing features, before commits, when stuck) or when the user asks to reflect.

Core Features & Use Cases

  • Structured reflection with a clear framework: What Went Well, What Was Hard, Root Cause, Documentation Gaps, Skill Improvement Suggestions.
  • Quick reflection templates for lightweight captures after any task.
  • Learnings integration guidance for issues and skills updates.

Quick Start

Invoke reflection after completing a feature or when you’re stuck, then document concise learnings and next steps.

Frequently Asked Questions about reflection

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

FAQPage Schema
How do I capture learnings after completing a feature or sprint?

Reflection captures post-work learnings through a structured framework covering What Went Well, What Was Hard, Root Cause Analysis, Documentation Gaps, and Skill Improvement Suggestions. Invoke it after completing features, before commits, or when stuck to document patterns and guide future improvements.

When should I use reflection in my development workflow?

Apply reflection at natural breakpoints: after completing features, before commits, when stuck for 3+ attempts, or when explicitly requested. These moments capture actionable learnings that prevent repeated mistakes and accelerate skill improvement across sprints.

What structured framework does reflection provide for documenting learnings?

Reflection generates a framework with five components: What Went Well identifies successes, What Was Hard captures obstacles, Root Cause Analysis explains why difficulties occurred, Documentation Gaps surfaces missing knowledge, and Skill Improvement Suggestions recommend concrete next actions for CLAUDE.md and issues.

How do I integrate reflection learnings into my skill development?

Reflection output guides skill improvement by recommending updates to CLAUDE.md and issue-based learnings. Use the structured framework to document patterns, identify knowledge gaps, and prioritize which skills to develop next based on actual work experience.

Can I use lightweight reflection templates for quick captures?

Yes, reflection provides quick templates for lightweight captures after any task without requiring deep analysis. These accelerate the learning loop by enabling rapid documentation at natural workflow breakpoints before detailed retrospectives.