reflect-on-work

Analyze recent work across four dimensions and generate proposed documentation updates.

3|Updated Aug 15, 2021
One-click install
npx skills add https://github.com/dtinth/dotfiles --skill reflect-on-work
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: reflect-on-work
Source: https://github.com/dtinth/dotfiles/tree/main/claude/skills/reflect-on-work
Command: npx skills add https://github.com/dtinth/dotfiles --skill reflect-on-work

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates a structured reflection process, ensuring valuable insights are captured and applied from your work. It prevents repeated mistakes and continuously improves your efficiency by systematically analyzing past actions and outcomes.

Core Features & Use Cases

  • Structured Work Analysis: Systematically evaluates what went well, what went wrong, what was confusing, and what knowledge is needed for future instances.
  • Actionable Insights: Synthesizes reflections into concrete, actionable guidance and proposed documentation updates.
  • Documentation Integration: Generates specific, user-approved changes for CLAUDE.md or project-specific documentation, ensuring learnings are codified.
  • Use Case: After completing a complex feature or a focused work session, simply ask Claude to "reflect on the work we just did." It will analyze the session, identify key learnings, and propose updates to your project's best practices, saving you the effort of manual retrospectives.

Quick Start

Reflect on the work we just completed on the user authentication module. What did we learn from the last coding session? Let's reflect on the recent refactoring of the payment gateway.

Frequently Asked Questions about reflect-on-work

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

FAQPage Schema
How do I systematically analyze my work to extract learnings?

Structured work analysis evaluates four dimensions: what went well, what went wrong, what was confusing, and what knowledge is needed. This prevents repeated mistakes and captures actionable insights from completed features or focused sessions for continuous improvement.

When should I conduct a work reflection?

Reflection is most valuable after completing a significant feature, wrapping up focused work, or when you need to identify what went well, what failed, and what knowledge would help future instances. It systematically extracts learnings before they fade.

How do I turn reflections into documentation updates?

After analyzing your work across the four reflection dimensions, the process generates proposed changes formatted for integration into project documentation like CLAUDE.md, ensuring learnings are codified and accessible for future reference.

What's included in a reflection output?

The reflection process produces findings across what went well, what went wrong, what was confusing, and knowledge gaps, plus a separate list of proposed changes ready for your approval and documentation integration.

Can I use reflection for different types of work sessions?

Yes. Reflection works after complex features, focused refactoring, coding sessions, or any significant work where you want to capture what went well, identify pain points, clarify confusion, and extract knowledge for future improvement.