sdd-distill-lessons

Extracts and deduplicates lessons from spec retrospectives into lessons.md.

21|5|Updated May 21, 2026
One-click install
npx skills add https://github.com/jentic/jentic-api-scorecard --skill sdd-distill-lessons
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sdd-distill-lessons
Source: https://github.com/jentic/jentic-api-scorecard/tree/main/.claude/skills/sdd-distill-lessons
Command: npx skills add https://github.com/jentic/jentic-api-scorecard --skill sdd-distill-lessons

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

The sdd-distill-lessons skill automates the process of extracting lessons from individual spec retrospectives, ensuring that valuable learnings are captured and can be shared across the team for continuous improvement in spec-driven development workflows.

Core Features & Use Cases

  • Retrospective Analysis: Reads spec retrospectives and extracts lessons and promotion candidates.
  • Lesson Deduplication: Groups and deduplicates lessons based on semantic similarity.
  • User Confirmation: Requests user confirmation for adding lessons to the specs/lessons.md.
  • Tech-Stack Promotion: Suggests lessons for promotion to specs/tech-stack.md.
  • Automated Review: Performs an immediate code review upon adding new lessons.
  • Use Case: Imagine your team performs regular spec retrospectives. Use this skill to automatically organize lessons from those retrospectives, allowing the team to leverage learnings in future development phases.

Quick Start

Run the sdd-distill-lessons skill to process retrospectives and update your specifications' lessons file.

Frequently Asked Questions about sdd-distill-lessons

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

FAQPage Schema
How do I automate extracting lessons from spec-driven development retrospectives?

You can automate lesson extraction by reading spec retrospective content to identify and deduplicate potential lessons, then requesting user confirmation before adding them to a specs/lessons.md document for team knowledge sharing.

How does lesson deduplication work when processing multiple spec retrospectives?

Lesson deduplication works by grouping extracted retrospective learnings based on semantic similarity, ensuring only unique insights are presented for user review before promotion to your final documentation.

What is the best way to promote retrospective lessons into tech-stack guidance?

The best way to promote lessons is to use an automated skill that suggests select retrospective learnings for promotion to specs/tech-stack.md, performing an immediate code review upon adding them to ensure accuracy.

Do I need user input to add retrospective lessons to my specs/lessons.md file?

Yes, user input is required for decision-making. The distillation process requests user confirmation to select which deduplicated lessons should be included in the specs/lessons.md document.

Can I trigger an automated code review immediately after distilling retrospective lessons?

Yes, automated code review is triggered immediately upon adding new lessons to your lessons file, ensuring that newly captured spec-driven development learnings are validated right away.

When should I not use an automated lessons distillation workflow for spec-driven development?

You should not use automated lessons distillation if your team lacks existing spec retrospective content or does not operate within a spec-driven development framework, as it requires context files and user input.