lesson-learned

Analyzes git history and diffs to extract software engineering lessons with mapped principles.

2.5k|134|Updated Mar 28, 2026
One-click install
npx skills add https://github.com/compozy/compozy --skill lesson-learned-compozy
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: lesson-learned
Source: https://github.com/compozy/compozy/tree/main/.agents/skills/lesson-learned
Command: npx skills add https://github.com/compozy/compozy --skill lesson-learned-compozy

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Analyze recent git history to surface concrete software engineering lessons extracted from actual code changes.

Core Features & Use Cases

  • Git-history-driven analysis that references real files and commits.
  • Maps observations to named SE principles and provides actionable takeaways.
  • Flexible scope (last N commits, feature branch, or specific range) to fit your workflow.

Quick Start

Analyze the current repository with the default scope to generate a grounded coding lesson.

Frequently Asked Questions about lesson-learned

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

FAQPage Schema
How do I extract actionable software engineering lessons from git history?

To extract lessons from git history, analyze recent code changes and diffs to surface actionable software engineering takeaways. This process maps observed modifications to established engineering principles, providing concrete improvements for future development.

Can I analyze a specific feature branch or commit range to find coding lessons?

Yes, you can constrain the analysis to a specific feature branch, the last N commits, or a specific commit range. This flexible scoping allows you to isolate and generate coding lessons from targeted code changes rather than the entire repository history.

What is the best way to map code refactoring observations to software engineering principles?

The best way to map refactoring observations to software engineering principles is by referencing a catalog of established SE principles during diff analysis. This grounds your observations in recognized patterns and outputs a structured lesson with a concrete takeaway.

Does this approach work for post-debug and post-feature scenarios?

Yes, this lesson extraction approach applies directly to post-feature, post-debug, and post-refactor scenarios. It analyzes the actual diffs from these specific development activities to generate relevant software engineering lessons.

How do I run a retrospective on recent repository commits?

To run a retrospective on recent repository commits, analyze the git diffs and map the identified changes to software engineering principles. This produces a structured lesson containing a short description and a concrete actionable takeaway.