learned

Capture in-the-moment lessons, categorize them as process or domain, and tag them.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/hodor/claude-compass --skill learned-hodor
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: learned
Source: https://github.com/hodor/claude-compass/tree/main/plugin/skills/learned
Command: npx skills add https://github.com/hodor/claude-compass --skill learned-hodor

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps capture in-the-moment lessons to preserve project knowledge, reducing context rot and enabling smoother transitions between project sessions.

Core Features & Use Cases

  • Lesson Capture: Automatically categorize and record lessons learned from a single-line argument, enhancing project documentation.
  • Categorization: Determines the category (process or domain) and area of the lesson based on provided flags or inferred context.
  • Tagging: Adds relevant tags to lessons for better organization and future reference.
  • Integration: Hand-offs to the lesson-write skill for final processing and storage.
  • Use Case: Use the /compass:learned command when you notice something valuable that should be documented before it's forgotten.

Quick Start

Capture a lesson with /compass:learned "Found a faster way to process X."

Frequently Asked Questions about learned

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

FAQPage Schema
How do I capture lessons learned on the fly during project management?

Capture lessons learned by invoking the command explicitly with a single-line argument, which automatically categorizes the entry as process or domain and tags it based on content, preserving project knowledge before context is lost.

What is context retention and how does documenting lessons prevent context rot?

Context retention preserves project knowledge by capturing in-the-moment lessons. Documenting lessons prevents context rot by recording valuable insights immediately, enabling smoother transitions between project sessions.

How to categorize project knowledge into process or domain areas automatically?

Categorize project knowledge automatically by providing a single-line lesson argument with optional flags. The system determines the category and area based on provided flags or inferred context, then adds relevant tags.

Do I need a separate lesson-writing skill to store captured lessons permanently?

Yes, you need a separate lesson-writing skill for final processing and storage. This Skill captures and categorizes lessons on the fly, then hands off to the lesson-writing skill for final documentation.

Can I add custom tags and flags when documenting lessons learned?

Yes, you can add flags when documenting lessons learned. The system uses provided flags to determine the category and area, and adds relevant tags to lessons for better organization and future reference.

When should I not use on-the-fly lesson capture for project knowledge?

On-the-fly lesson capture requires explicit human invocation, so it is not suitable for automated background logging. Use it only when you notice something valuable that should be documented before it is forgotten.