lessons-capture

Appends timestamped skill-improvement recommendations to per-skill lessons logs.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Development skills in this plugin need a consistent, low-friction way to record improvement observations after each run without risking edits to the skills themselves. This helper centralizes that reflection protocol so every calling skill logs lessons the same way. ## Core Features & Use Cases - Structured reflection: Captures at most one recommendation per run, formatted as observation, proposed change, and expected benefit. - Atomic log appends: Writes dated UTC entries to ~/.claude/dev-skills/lessons/<skill-name>.md using shell append so prior entries are never overwritten. - Safe by design: Never edits any SKILL.md and never writes outside the lessons directory; logs are reviewed and applied later by the user or an improver skill. - Use Case: After feature-design finishes a run, it invokes this helper with its slug, and a dated entry noting a missing guidance step is appended to the feature-design lessons log for later review. ## Quick Start Invoke this skill as the final step of another plugin skill, passing the calling skill's slug such as feature-design as the only argument.

Frequently Asked Questions about lessons-capture

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

FAQPage Schema
How do I log skill improvement recommendations after a run?

Invoke lessons-capture as the final step of the calling skill, passing the calling skill's slug as the only argument. It reflects on the run, formats at most one recommendation, and appends a dated entry to the per-skill log under ~/.claude/dev-skills/lessons/.

Can users invoke lessons-capture directly?

No, it is an internal helper marked user-invocable: false and is only called by other skills in the plugin such as feature-design or feature-implement. Users review the accumulated logs later, typically via the lessons-learn skill.

Does lessons-capture modify SKILL.md files automatically?

No, it never edits any SKILL.md. It only appends entries to the lessons log, and improvements are applied deliberately later by the user or a dedicated improver skill after reviewing patterns across runs.

What happens if a run has no improvement recommendations?

It logs a single line stating no skill-improvement recommendations from this run, which is the expected common case. The skill never invents recommendations to fill space, keeping the log high-signal.

Why does lessons-capture use append-only shell writes?

Appending with a single shell >> operation is atomic and cannot clobber existing entries, unlike read-then-rewrite approaches. Entries accumulate chronologically with UTC timestamps so logs from different machines stay sortable.