new-lesson

Scaffolds bilingual English-Spanish MDX lessons with interactive exercises and OG images for an Astro education site.

3|1|Updated Jun 20, 2026
One-click install
npx skills add https://github.com/alexfdez1010/mental-models --skill new-lesson-alexfdez1010
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: new-lesson
Source: https://github.com/alexfdez1010/mental-models/tree/main/.claude/skills/new-lesson
Command: npx skills add https://github.com/alexfdez1010/mental-models --skill new-lesson-alexfdez1010

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Creating a new lesson for this bilingual education site requires coordinating many moving parts: correct MDX frontmatter, mirrored English and Spanish files, interactive exercise components, difficulty tiers, dependency wiring, and OG image regeneration. This Skill turns that multi-step authoring process into a single guided workflow. ## Core Features & Use Cases - Bilingual scaffolding: Creates the English MDX file and its peninsular-Spanish twin in the correct locale folders with valid frontmatter (title, description, topic, order, difficulty, dependencies). - Interactive component wiring: Integrates the reusable React islands (MCQ, Quiz, FinalExam, FillBlank, MatchConcepts, Categorize, MindMap) with proper client directives and localized Spanish label props. - Pedagogical structure enforcement: Requires pretest questions per section, at least one teaching animation, spaced-recall exercises, and a mandatory FinalExam lesson closing every topic. - Use Case: Ask to "add a lesson about anchoring bias" and the Skill researches the topic, writes witty analogy-driven copy in both languages, embeds exercises and animations, runs validation checks, and regenerates OG share images. ## Quick Start Ask the assistant to create a new lesson about a specific subject, for example: add a beginner lesson about loss aversion to the mental models site.

Frequently Asked Questions about new-lesson

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

FAQPage Schema
How do I add a new lesson to an Astro content collections site?

Create an MDX file under src/content/lessons/en/<topic>/<lesson>.mdx with frontmatter for title, description, topic, order, minutes, and updated. Routes generate automatically via getStaticPaths, so no route file edits are needed.

How do I create bilingual English and Spanish MDX content?

Author the English file first, then create a mirrored twin under the es locale path with identical structure and translated prose. Set the topic field to es/<topic> and pass Spanish label props to interactive components so the UI is fully localized.

What interactive components can I use in MDX lesson files?

The template ships MCQ, Quiz, FinalExam, Reveal, Callout, FillBlank, MatchConcepts, Categorize, MindMap, CourseGraph, and progress islands, imported from @/components/react. Interactive islands need the client:visible directive; Callout is presentational.

Why does KaTeX rendering break with currency symbols in MDX?

Writing a dollar amount like \$80 inside a $...$ math span closes the delimiter early, leaving a stray backslash that causes a KaTeX parse error. Keep currency outside the math span and run bun run check:latex to catch this class of bug.

Does every course need a final exam lesson?

Yes, every topic must end with a final-exam slug lesson ordered last, using the FinalExam island with 20-30 varied MCQs and a 70 percent pass mark. The exam is graded and irreversible, with answers locking on submit.