lessons-learned

Capture and organize incident lessons into a centralized knowledge base.

6|2|Updated Dec 24, 2025
One-click install
npx skills add https://github.com/Gaku52/claude-code-skills --skill lessons-learned-gaku52
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: lessons-learned
Source: https://github.com/Gaku52/claude-code-skills/tree/main/knowledge/lessons-learned
Command: npx skills add https://github.com/Gaku52/claude-code-skills --skill lessons-learned-gaku52

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

The Lessons Learned Skill helps teams convert raw incidents into a structured, reusable knowledge base that supports continuous learning and prevents recurring issues.

Core Features & Use Cases

  • Knowledge-base initialization: set up a centralized repository to store best practices, anti-patterns, patterns, and optimizations.
  • Incident-to-lesson workflow: capture insights from incidents, generalize them into concrete lessons, and link them to related skills.
  • Team-wide dissemination: automatic feedback to related teams, onboarding pipelines, and regular retro inputs.
  • Use Case: after a critical incident, the team creates lessons-learned entries and references them in future project planning to reduce recurrence.

Quick Start

  1. Start by recording a new incident in incidents/ and extract a lesson into lessons/best-practices/ or lessons/anti-patterns/.

Frequently Asked Questions about lessons-learned

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

FAQPage Schema
How do I convert incident response records into reusable lessons learned?

To convert incident response records into reusable lessons learned, capture raw incident insights and generalize them into concrete entries within a centralized knowledge base, applying tags and categories for future indexing and retrieval.

What is the best way to structure a knowledge base for team onboarding and retrospectives?

Structuring a knowledge base for team onboarding and retrospectives requires initializing a centralized repository that separates entries into best practices and anti-patterns, supporting cross-linking with incident records for continuous learning.

How do I prevent recurring incidents using a knowledge management workflow?

Preventing recurring incidents using a knowledge management workflow involves extracting generalized guidance from raw events, cross-linking lessons to related records, and feeding those insights back into team onboarding pipelines and project planning.

Can I automate indexing and categorization for a lessons learned knowledge base?

Yes, you can automate indexing and categorization for a lessons learned knowledge base by applying tagging, versioning, and indexing automation to extract and organize generalized guidance from raw incident data.

Does this approach support cross-linking lessons with existing incident records?

Yes, this approach supports cross-linking lessons with existing incident records by capturing insights from incidents, generalizing them into concrete lessons, and connecting them to related skills and records within the repository.

What are the limitations of using a lessons learned workflow for team-wide dissemination?

The limitations of using a lessons learned workflow for team-wide dissemination include the manual effort required to initially record incidents and extract generalized lessons before automated indexing and feedback pipelines can be utilized.