chapter-content-generator_skill

Overview

This skill generates comprehensive chapter content for intelligent textbooks from an existing chapter index.md that contains title, summary, and a concepts list. It produces reading-level–appropriate narrative, integrates rich non-text elements (diagrams, infographics, charts, MicroSims), and writes the completed content back into the chapter file. Use it after the chapter structure has already been created.

How this skill works

The skill verifies the chapter path and parses index.md to extract title, summary, and the numbered concepts list. It determines the target reading level by scanning course-description.md (or asking the user) and adapts sentence complexity, vocabulary, and scaffolding accordingly. It then generates pedagogically ordered content, embeds required non-text elements with detailed specifications, verifies that every concept is covered, and replaces the TODO placeholder in the chapter file. Finally, it returns a concise report including reading level, word count, and a breakdown of non-text elements.

When to use it

• When a chapter directory with index.md already exists after running the book-chapter-generator.
• When index.md contains a title, summary, and a numbered Concepts Covered list and you need full chapter content.
• When content must match a specific reading level (junior high, senior high, college, graduate).
• When the chapter should include diagrams, infographics, charts, timelines, or interactive MicroSims.
• When you want the generated content written directly back into the chapter index.md file.

Best practices

• Verify index.md contains Title, ## Summary, and ## Concepts Covered before running generation.
• Load references/reading-levels.md and references/content-element-types.md to guide tone and element specs.
• Order concepts pedagogically (simple→complex) rather than strictly following the concept list.
• Insert a non-text element at least every three paragraphs and vary element types for better engagement.
• Use full, implementable <details markdown="1"> specs for diagrams and MicroSims so other skills can render them.
• After generation, run the completeness check and ensure the TODO placeholder is removed and word count is recorded.

Example use cases

• Convert a chapter outline for an ITIL textbook into a full chapter with architecture diagrams and a change-management MicroSim.
• Produce a senior-high biology chapter with infographics, a labeled diagram, and short interactive simulations for classroom activities.
• Generate a college-level chapter that includes charts, a timeline of research, and a MicroSim demonstrating an experiment.
• Update multiple chapter index.md files in a course to a consistent reading level and visual style before publishing.