lesson-animations

Builds interactive React animation islands that teach lesson concepts in Astro MDX content.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Static text and images often fail to explain processes, transformations, and relationships in educational lessons. This Skill guides the creation of purposeful, accessible animations as reusable React islands that make lesson concepts genuinely easier to understand. ## Core Features & Use Cases - Teaching-focused animations: Builds interactive React islands in src/components/react/ that visualize processes, transformations, and relationships rather than decorating pages. - Accessibility and performance guardrails: Enforces prefers-reduced-motion fallbacks, transform/opacity-only animation, keyboard-operable controls, and design-token styling with bun run check validation. - Bilingual MDX integration: Wires islands into lessons with client:visible hydration and Spanish twin translations, including MindMap chunking summaries. - Use Case: When writing a lesson about a multi-step mental model, use this Skill to author a slider-driven interactive visual next to each explanation, plus a closing MindMap, in both English and Spanish. ## Quick Start Ask the AI to add an interactive animation explaining the core process of the lesson you are currently authoring.

Frequently Asked Questions about lesson-animations

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

FAQPage Schema
How do I add an animation to an Astro MDX lesson?

Author a React island in src/components/react/, export it through the barrel file, then import it in the MDX lesson with the @ alias and hydrate it using client:visible. Run bun run check to validate the component before committing.

When should a lesson use an animation instead of a static diagram?

Use animation when the idea involves change over time, a multi-step process, a transformation, or a relationship where adjusting one variable affects another. Static facts or definitions are better served by Callouts, diagrams, or MatchConcepts exercises.

How do I make CSS animations respect prefers-reduced-motion?

Wrap motion rules in a @media (prefers-reduced-motion: reduce) query and provide a static, equally informative fallback. The project already handles this globally in global.css, but no essential information should be conveyed by motion alone.

Can React islands be interactive instead of passive loops?

Yes, interactive islands are preferred. Use plain React state with CSS transitions or SVG so learners can scrub sliders or step through stages, with real keyboard-operable inputs, labels, and visible focus rings.

What are the limitations of the MindMap component in lessons?

MindMap renders Mermaid mindmap diagrams from structured data plus an accessible text outline, but node labels must stay short because Mermaid strips characters like parentheses, brackets, and colons. Spanish twins must translate all labels and titles.