speclet-learn

Generate structured Markdown lessons from completed speclet stories.

Updated Jan 9, 2026
One-click install
npx skills add https://github.com/danielcastro-dev/speclet --skill speclet-learn
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speclet-learn
Source: https://github.com/danielcastro-dev/speclet/tree/main/.opencode/skill/speclet-learn
Command: npx skills add https://github.com/danielcastro-dev/speclet --skill speclet-learn

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

After completing speclet stories, this skill generates explanatory lessons to develop mechanical coding fluency, turning hands-on work into structured learning.

Core Features & Use Cases

  • Generates post-story lessons based on the latest completed story.
  • Analyzes modified files from the story to extract patterns, concepts, and decisions.
  • Produces a Markdown lesson at .speclet/lessons/STORY-X.md following a structured template that includes technical decisions, explanations, code examples, common errors, and practice exercises.
  • Supports progressive complexity categorization and a 10-15 minute hands-on exercise without relying on an LLM.

Quick Start

Run the speclet-learn workflow after finishing a story to generate a lesson file at .speclet/lessons/STORY-X.md.

Frequently Asked Questions about speclet-learn

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

FAQPage Schema
How do I generate coding lessons from completed development stories?

To generate coding lessons from completed development stories, run the speclet-learn workflow after finishing a story. It analyzes modified files and automatically creates a structured Markdown lesson file at .speclet/lessons to build developer fluency.

What is the best way to turn hands-on coding work into structured learning material?

Turning hands-on coding work into structured learning material involves analyzing modified files from a completed story to extract patterns and technical decisions. This process produces a Markdown lesson featuring code examples, common errors, and a practice exercise for mechanical fluency.

How does automated lesson generation work without an LLM?

Automated lesson generation without an LLM works by reading the latest completed speclet story and its modified files to enforce a fixed template. It structures technical decisions, key concepts, and practice exercises directly from the codebase changes.

Does speclet-learn require specific dependencies to create practice exercises?

Speclet-learn does not require specific dependencies to create practice exercises. It operates independently to generate a 10-15 minute hands-on exercise within a Markdown file at .speclet/lessons based on your latest completed story.

What components are included in an automated coding fluency lesson template?

An automated coding fluency lesson template includes technical decisions, key concepts, code examples, common errors, and a practice exercise. It enforces this fixed structure in a Markdown file to ensure progressive complexity and consistent learning.