lessons

Extract actionable rules from fix cycles and deduplicate them against existing notes.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/bketelsen/ytsejam --skill lessons-bketelsen
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: lessons
Source: https://github.com/bketelsen/ytsejam/tree/main/contrib/skills/lessons
Command: npx skills add https://github.com/bketelsen/ytsejam --skill lessons-bketelsen

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill captures actionable lessons from fix cycles, deduplicates them against existing notes, and commits approved lessons into a centralized knowledge base, enabling faster prevention of repeating mistakes.

Core Features & Use Cases

  • Synthesize concise lessons from reviewer feedback, fix diffs, and task descriptions.
  • Deduplicate new lessons against existing entries to avoid duplication and confusion.
  • Promote lessons to published entries after recurrence or explicit user opt-in, with an audit trail that includes Added date and task context.
  • Announce at start: "I'm using the lessons skill to capture this fix cycle."
  • Suitable for software development, operations, and documentation workflows where repeatable improvement is valuable.

Quick Start

Initiate a lesson capture by supplying the reviewer feedback, the fix diff, and the task description to generate a reusable rule.

Frequently Asked Questions about lessons

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

FAQPage Schema
How do I capture fix-cycle lessons from reviewer feedback and code diffs?

To capture fix-cycle lessons, supply reviewer feedback, fix diffs, and task descriptions to synthesize concise, actionable rules. The skill extracts these lessons and deduplicates them against existing notes to prevent repeating mistakes.

What is the best way to deduplicate new lessons against an existing knowledge base?

Deduplicating new lessons against existing entries requires comparing synthesized rules with the current knowledge base. This process avoids duplication and confusion by filtering out repetitive fixes before promoting them to published documentation.

How do I promote approved lessons into published documentation with an audit trail?

Promote approved lessons into published documentation after recurrence or explicit opt-in. This generates an audit trail that includes the Added date and task context, ensuring traceable integration into your centralized knowledge base.

Can I use this lesson capture process for operations and support tasks?

Yes, you can use this lesson capture process for operations and support tasks. It applies across software development workflows, support tasks, and documentation efforts where issues recur and require deduplication for repeatable improvement.

When should I not use an automated lesson capture workflow?

Avoid using an automated lesson capture workflow for non-recurring, isolated issues. It is designed for contexts where issues recur and require deduplication, making it less effective for one-off fixes that do not yield reusable rules.