learning-docs

Generate and update LEARNING.md retrospectives documenting architecture, decisions, bugs, and lessons.

16|2|Updated Nov 9, 2025
One-click install
npx skills add https://github.com/maroffo/claude-forge --skill learning-docs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: learning-docs
Source: https://github.com/maroffo/claude-forge/tree/main/skills/learning-docs
Command: npx skills add https://github.com/maroffo/claude-forge --skill learning-docs

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps capture and organize project knowledge, lessons learned, and technical decisions in a structured and engaging way, preventing knowledge loss and improving future development.

Core Features & Use Cases

  • Dynamic Retrospectives: Creates and updates LEARNING.md files with insights from recent work.
  • Structured Documentation: Organizes technical details, decisions, and lessons learned in a conversational style.
  • Solution Cataloging: Captures reusable solutions in a searchable docs/solutions/ directory.
  • Session Analysis: Identifies patterns of inefficiency in conversation logs to suggest improvements.
  • Use Case: After completing a complex bug fix, use this Skill to document the problem, the solution, and the key takeaway in your project's LEARNING.md, making it easily discoverable for future reference.

Quick Start

Use the learning-docs skill to update the LEARNING.md file with lessons learned from the last 10 commits.

Frequently Asked Questions about learning-docs

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

FAQPage Schema
How do I document project lessons learned and prevent knowledge loss after completing a complex bug fix?

Documenting project lessons learned involves generating and updating LEARNING.md files with architecture decisions, bugs, and takeaways in a conversational style. This captures reusable solutions in a categorized docs/solutions/ directory, preventing knowledge loss and improving future development.

What is the best way to structure technical retrospectives for ongoing software projects?

The best way to structure technical retrospectives is creating LEARNING.md files that document architecture, decisions, and lessons learned dynamically. Organizing reusable solutions in a categorized docs/solutions/ directory ensures technical details are discoverable for future reference.

Can I automatically catalog reusable coding solutions from session logs?

Yes, you can automatically catalog reusable coding solutions by analyzing session logs for improvement patterns. This process identifies reusable solutions and organizes them into a searchable docs/solutions/ directory for future reference.

Does generating project retrospectives require structured input to be effective?

Yes, generating project retrospectives requires structured input for effective knowledge capture and organization. Providing organized session logs or commit data ensures the LEARNING.md files accurately document architecture decisions and lessons learned.

How do I capture technical storytelling and decisions in a knowledge management workflow?

Capturing technical storytelling and decisions involves updating LEARNING.md files with insights from recent work in a conversational style. This workflow documents technical details and lessons learned dynamically, making project knowledge easily discoverable.