Chapter Content Generator

Workflow

Step 1: Verify Chapter File Exists

Verify that the input chapter name or path to the chapter file is present.

Expected input format:

• Chapter name: "01-intro-to-itil-and-config-mgmt" or "Chapter 1"
• Full path: "/docs/chapters/01-intro-to-itil-and-config-mgmt/index.md"
• Relative path: "chapters/01-intro-to-itil-and-config-mgmt/index.md"

Chapter directory structure:

/docs/chapters/NN-lowercase-name/index.md

Where:

• NN = Two-digit chapter number with leading zero (e.g., "01", "07", "12")
• lowercase-name = URL-friendly lowercase name with dashes, no spaces

Actions:

1. If chapter name is provided, search for matching directory in /docs/chapters/
2. If path is provided, verify file exists at that location
3. If file not found, ask user to specify correct chapter name or path
4. Read the chapter index.md file

Step 2: Verify Chapter Content is Correct

Open the chapter file and check for required elements.

Required elements:

1. Title in header 1 (# Title)
2. Summary in level 2 header (## Summary)
3. Concepts Covered in level 2 header (## Concepts Covered) with numbered list

Actions:

1. Parse the chapter index.md file
2. Extract:
   • Chapter title
   • Summary text
   • List of concepts covered (numbered list)
3. If any element is missing, ask user to provide the content as text
4. Store concepts list for verification in Step 5

Step 3: Get the Reading Level

Extract the grade reading level from the /docs/course-description.md file.

Reading level indicators in course description:

• "junior-high", "junior high", "grades 7-9", "middle school" → Junior High
• "senior-high", "senior high", "grades 10-12", "high school" → Senior High
• "college", "undergraduate", "bachelor" → College
• "graduate", "master", "masters", "master's", "PhD", "doctoral" → Graduate

Actions:

1. Read /docs/course-description.md
2. Search for reading level indicators in:
   • Course title
   • Target audience section
   • Prerequisites section
   • Course overview
3. If not found, ask user: "What grade-level should be used to generate the content?"
4. Default to Grade 10 (Senior High) if not specified

Reading level characteristics:

• Junior High (Grades 7-9): Simple sentences (12-18 words), common vocabulary, concrete examples, frequent visual aids
• Senior High (Grades 10-12): Mixed sentence complexity (15-22 words), technical vocabulary with definitions, balance of concrete and abstract
• College: Academic style (18-25 words), technical terminology, case studies, research context
• Graduate: Sophisticated prose (20-30+ words), full jargon, theoretical depth, research literature

See references/reading-levels.md for detailed guidelines on adapting content for each level.

Step 4: Generate Detailed Chapter Content

Add metadata to the top of the index file that indicates that a DRAFT of this chapter was created by this skill, the name of the skill, the date it was generated and the version of this skill.

---