lessons-learn

Consolidates accumulated skill-improvement lessons and applies approved edits to a target SKILL.md.

Updated May 26, 2026
One-click install
npx skills add https://github.com/cagriy/dev-skills --skill lessons-learn-cagriy
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: lessons-learn
Source: https://github.com/cagriy/dev-skills/tree/main/skills/lessons-learn
Command: npx skills add https://github.com/cagriy/dev-skills --skill lessons-learn-cagriy

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Over time, the dev-skills plugin's skills accumulate lesson logs with improvement observations, but those raw entries never reach the skills themselves. This Skill closes the loop by synthesizing the log for one skill into a few durable improvements and applying only the ones the user approves. ## Core Features & Use Cases - Log synthesis and filtering: Reads the active lessons log for a target skill, clusters entries, and drops one-off, already-addressed, language-specific, or low-value suggestions. - User-gated edits: Presents each surviving improvement via AskUserQuestion with Apply, Skip, or Defer options, then edits the target SKILL.md without ever committing. - Archival and audit trail: Snapshots the processed log to a UTC-stamped archive file and writes deferred entries back to a fresh active log. - Use Case: After running 15-20 features through the plugin, invoke it on the feature-implement slug to review accumulated lessons and fold the high-signal ones into that skill's instructions. ## Quick Start Run /dev:lessons-learn feature-implement to review the accumulated lessons for that skill and apply the improvements you approve.

Frequently Asked Questions about lessons-learn

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

FAQPage Schema
How do I apply accumulated lessons to a Claude Code skill?

Invoke /dev:lessons-learn with the target skill's slug, such as feature-design or feature-implement. The skill reads the lessons log, clusters entries into a few candidate improvements, and asks you to approve, skip, or defer each one before editing the SKILL.md.

How often should I run lessons-learn on my skills?

Run it periodically, roughly every 15-20 features, or whenever you notice a skill's lessons log has grown. It is user-invoked only and never triggers automatically or chains from other skills.

Does lessons-learn commit changes to my skill files?

No, it never commits or pushes. Approved edits land in the working tree only, so you review them with git diff and commit at your own pace.

What happens to lessons that are skipped or deferred?

Skipped entries are archived with the rest of the log, while deferred entries are written back to a fresh active log so a future run reconsiders them. The entire processed log is snapshotted to a UTC-stamped archive file that is never modified afterward.

Why does lessons-learn drop most lesson entries?

It filters aggressively, discarding one-off issues, already-implemented suggestions, language-specific fixes, and changes that add complexity without clear benefit. A typical run applies zero to three improvements, which is the intended healthy outcome.