lessons

Loads active lessons from the project's lessons file into conversation context.

Updated Jan 2, 2024
One-click install
npx skills add https://github.com/Mithrandir21/game-deals-app --skill lessons-mithrandir21
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: lessons
Source: https://github.com/Mithrandir21/game-deals-app/tree/main/.claude/skills/lessons
Command: npx skills add https://github.com/Mithrandir21/game-deals-app --skill lessons-mithrandir21

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Teams accumulate hard-won lessons during development, but those lessons sit unused in documentation files unless someone remembers to read them. This Skill loads the project's accumulated lessons from .claude/lessons.md into the conversation so past learnings actually inform planning sessions, large features, and refactors. ## Core Features & Use Cases - Active Lesson Loading: Reads only the ## Active section of .claude/lessons.md, ignoring the generated index and treating ## Archive as audit history consulted only when contradictions appear. - Scope-Aware Application: Notes each lesson's Applies to scope and confidence level, treating confirmed lessons as defaults and tentative ones as hypotheses to validate against current code. - Read-Only Safety: Never modifies .claude/lessons.md; writing or superseding lessons is delegated to the separate android-retrospective skill. - Use Case: Before kicking off a large refactor of the app's data layer, invoke the skill to load all active lessons tagged for architecture and testing so prior mistakes are not repeated. ## Quick Start Ask the assistant to load the project lessons before starting the planning session for the new feature.

Frequently Asked Questions about lessons

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

FAQPage Schema
How do I load project lessons into an AI conversation?▼

Invoke the lessons skill by asking to load lessons, recall lessons, or apply past learnings. It reads the Active section of the project's lessons file and reports how many lessons were loaded and which tags they cover.

When should I use a lessons-loading skill?▼

Use it when starting a planning session, kicking off a large feature or refactor, or whenever past project learnings should inform current work. It is designed for the beginning of substantial tasks rather than small edits.

Does the lessons skill modify the lessons file?▼

No, the skill is strictly read-only. It never writes to or supersedes entries in the lessons file; that responsibility belongs to the separate android-retrospective skill.

What is the difference between Active and Archive lesson sections?▼

The Active section contains lessons currently in force and is the only section loaded by default. The Archive section is audit history, consulted only when a current observation contradicts an active lesson and reconciliation is needed.

How are tentative lessons handled differently from confirmed ones?▼

Confirmed lessons are treated as defaults to apply directly. Tentative lessons are treated as hypotheses that must be validated against the current code before being relied upon.