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.