lesson

Runs discussion-first lessons, quizzes, and exercise checks for personal learning curricula.

3|Updated Oct 28, 2020
One-click install
npx skills add https://github.com/k0d3x8its/dotfiles --skill lesson-k0d3x8its
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: lesson
Source: https://github.com/k0d3x8its/dotfiles/tree/main/claude/.claude/skills/lesson
Command: npx skills add https://github.com/k0d3x8its/dotfiles --skill lesson-k0d3x8its

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Self-directed learners following a structured curriculum often lose momentum because no one guides the discussion, checks comprehension, or reviews their exercise code. This Skill acts as a mentor that walks you through topic curricula stored under ~/dev/learn/<topic>/, one lesson at a time. ## Core Features & Use Cases - Guided Lesson Flow: Subcommands next, quiz, objective, check, review, and status move you through a curriculum defined by INDEX.md and per-lesson Markdown files with frontmatter status tracking. - Mentor-Style Teaching: Presents discussion first, quizzes comprehension conversationally, and reviews exercise code with escalating hints instead of handing out solutions. - Verified Exercise Checks: Runs the topic's compiler or test runner (e.g., tsc --noEmit) against your code in exercises/<slug>/ before judging pass or fail, and tracks attempts and struggled lessons for later review. - Use Case: You are working through a TypeScript curriculum in ~/dev/learn/typescript/. Run /lesson next to get today's discussion, say "quiz me" to test recall, then /lesson check after writing your exercise to get verified feedback. ## Quick Start Ask the assistant to start the next lesson for your current topic by saying "next lesson" while inside your ~/dev/learn/<topic>/ directory.

Frequently Asked Questions about lesson

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

FAQPage Schema
How do I progress through a personal learning curriculum with an AI mentor?▼

Use the lesson subcommands: /lesson next presents the next unfinished lesson's discussion, /lesson quiz checks comprehension, /lesson objective assigns the exercise, and /lesson check verifies your code. Progress is tracked in each lesson file's frontmatter status.

How does the lesson skill check my exercise code?▼

It reads the lesson's Check Criteria and your code in exercises/<slug>/, then runs the topic's compiler or test runner (such as tsc --noEmit) and inspects the actual exit code before judging. Passing sets status to done; failing gives a hint rather than the solution.

What directory structure does a lesson curriculum need?▼

Each topic lives under ~/dev/learn/<topic>/ with an INDEX.md defining lesson order, a lessons/ directory of Markdown files with frontmatter, an exercises/ directory for your code, and optional source material like SYLLABUS.md for authoring lesson content.

Can I skip the quiz and go straight to the exercise?▼

Yes. The quiz step is optional; after the discussion you can run /lesson objective directly to see the exercise. The skill waits for an explicit signal like "quiz me" or "start the objective" rather than inferring readiness.

What happens when I keep failing a lesson exercise?▼

Each check bumps the attempts counter. After three or more failed attempts, the mentor offers to escalate up the hint ladder instead of repeating the same hint. If you give up, the lesson is marked struggled so /lesson review can resurface it later.