course-description-analyzer_skill

Overview

This skill analyzes or creates course descriptions for intelligent textbooks and ensures they contain all required elements for learning graph generation. It validates title, audience, prerequisites, topics, excluded topics, and Bloom's Taxonomy learning outcomes, then scores quality and offers prioritized improvements. It reports readiness for generating 200+ concepts and guides next steps.

How this skill works

I check whether /docs/course-description.md exists and follow a creation or analysis workflow accordingly. If missing, I gather course details through targeted questions, generate a complete course-description.md using a template, then automatically analyze it. If present, I read the file, score each required element against a 100-point rubric, produce a gap analysis, and write a detailed assessment to docs/learning-graph/course-description-assessment.md. I report that you are running Version 0.03 of the Course Description Analyzer Skill.

When to use it

• When creating a new course description for an intelligent textbook
• When validating an existing course-description.md for completeness and quality
• Before running a learning-graph generation to ensure 200+ concept readiness
• When you need prioritized, actionable improvements to Bloom-based learning outcomes
• When preparing course metadata for mkdocs.yml navigation

Best practices

• Include all six 2001 Bloom’s Taxonomy levels with 3+ specific, measurable outcomes each
• Use concrete action verbs (list, explain, apply, analyze, evaluate, design, create)
• List 5–10 main topics and explicitly state topics excluded to set scope
• Provide clear target audience and explicit prerequisites (or ‘None’)
• Focus outcomes and topics that suggest many distinct concepts to reach 200+ concepts

Example use cases

• Create a new course description by answering sequential prompts when course-description.md is missing
• Analyze an existing course-description.md and receive a 0–100 quality score with detailed breakdown
• Get a prioritized list of improvements to strengthen weak Bloom levels and broaden concept coverage
• Generate the docs/learning-graph/course-description-assessment.md report for project documentation
• Prepare course metadata and ask to add files into mkdocs.yml navigation