Lesson Learned

by softaworks

Lesson Learned is a Quality skill for Claude Code, published by softaworks in agent-toolkit.

2.4K stars219 forkson softaworks/agent-toolkitAdded 2026/08/18+1% in starsRepository updated 2026/03/05

View source on GitHub Download repo ZIP

agent-skillsaiautomationclaudeclaude-codecoding-agentdevelopment

Install in seconds

Install Lesson Learned

Copy Lesson Learned into your Claude Code skills folder. Run the command in your terminal, or review the source on GitHub before installing.

terminal

npx degit https://github.com/softaworks/agent-toolkit/tree/main/skills/lesson-learned ~/.claude/skills/lesson-learned

Requires Node.js. Downloads this skill only — not the rest of the repository — into your Claude Code skills folder.

Without Node.js

git clone https://github.com/softaworks/agent-toolkit.git

Clones the whole repository, then copy the skill’s own directory into your skills folder yourself.

In this catalog

Source file: skills/lesson-learned/SKILL.md in softaworks/agent-toolkit
Installs to: ~/.claude/skills/lesson-learned
Collection: One of 25 skills cataloged from this repository
Category: Quality — 1354 skills

What Lesson Learned does

Lesson Learned analyzes recent code changes via git history and extracts software engineering lessons. Use when the user asks 'what is the lesson here?', 'what can I learn from this?', or wants to reflect on recent work.

Lesson Learned is cataloged under Quality on DirSkills. Lesson Learned comes from a repository tagged agent-skills, ai, automation, claude and claude-code.

Documentation

README

Excerpt

Lesson Learned

Extract specific, grounded software engineering lessons from actual code changes. Not a lecture -- a mirror. Show the user what their code already demonstrates.

Before You Begin

Load the principles reference first.

Read references/se-principles.md to have the principle catalog available
Optionally read references/anti-patterns.md if you suspect the changes include areas for improvement
Determine the scope of analysis (see Phase 1)

Do not proceed until you've loaded at least se-principles.md.

Phase 1: Determine Scope

Ask the user or infer from context what to analyze.

This is the opening of the README. Read the full README on GitHub.

Frequently asked about Lesson Learned

What else does softaworks publish alongside Lesson Learned?
Lesson Learned is one of 25 skills that DirSkills catalogs from softaworks/agent-toolkit, the repository it ships in. Its siblings there include 10x Mode, Add Skill and Agent MD Refactor. Each one is a separate skill with its own page in this directory, installs the same way Lesson Learned does, and is maintained by softaworks in that same repository. The rest of the collection is listed on the softaworks/agent-toolkit page.
How does Lesson Learned compare to other Quality skills?
Lesson Learned ranks #517 by stars among the 1354 Quality skills in this catalog. The most-starred ones next to it are Benchmark, Benchmark Optimization Loop and API Design Patterns. DirSkills ranks by the star count of the repository each skill ships in, so that order reflects how popular those repositories are rather than any review of Lesson Learned against them. Open each page to compare what they document and how they install.