Back to Details

course-description-analyzer

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Course Description Analyzer

课程描述分析器

Overview

概述

This Anthropic Claude Skill is the first step in the process of generating an intelligent textbook. The next Skill is the 'learning-graph-generator` Skill.
Analyze or create high-quality course descriptions that contain all necessary elements for generating comprehensive learning graphs with 200+ concepts. Check the 
/docs/course-description.md
file for completeness, quality, and alignment with 2001 Bloom's Taxonomy learning outcomes.
这个Anthropic Claude Skill是生成智能教材流程中的第一步。下一个Skill是
learning-graph-generator
Skill。
分析或创建高质量的课程描述，其中包含生成涵盖200+概念的全面学习图谱所需的所有必要元素。检查
/docs/course-description.md
文件的完整性、质量以及是否符合2001版Bloom's Taxonomy学习目标。

Workflow Decision Tree

工作流决策树

Start by checking if 
/docs/course-description.md
exists:
  • File does not exist → Follow Creation Workflow (Step 1)
  • File exists → Follow Analysis Workflow (Step 2)
Tell the user that they are running Version 0.03 of the Course Description Analyzer Skill.
首先检查
/docs/course-description.md
是否存在：
  • 文件不存在 → 遵循创建工作流（步骤1）
  • 文件存在 → 遵循分析工作流（步骤2）
告知用户当前运行的是Course Description Analyzer Skill的0.03版本。

Step 1: Course Description Creation

步骤1：课程描述创建

Use this workflow when 
/docs/course-description.md
does not exist.
当
/docs/course-description.md
不存在时使用此工作流。

1.1 Gather Course Information

1.1 收集课程信息

Ask the user the following questions sequentially (not all at once):
  1. What is the title of the course?
  2. What is the target audience of the course?
    • Options: elementary, junior high, high school, college undergraduate, graduate students, adult continuing education, professional development, or other
  3. What are the prerequisites for this course?
    • If none, explicitly state "None"
  4. What are the main subjects/topics covered by this course?
    • Request a list of major topics
  5. What are the learning outcomes organized by the 2001 Bloom's Taxonomy?
    • Explain that after this course, students will be able to demonstrate competencies at each level:
      • Remember: Retrieve, recognize, and recall relevant knowledge
      • Understand: Construct meaning from instructional messages
      • Apply: Carry out or use procedures in given situations
      • Analyze: Break material into parts and determine relationships
      • Evaluate: Make judgments based on criteria and standards
      • Create: Put elements together to form coherent wholes; includes capstone projects
按顺序向用户询问以下问题（不要一次性全部提出）：
  1. 课程的标题是什么？
  2. 课程的目标受众是谁？
    • 选项：小学、初中、高中、大学本科、研究生、成人继续教育、职业发展、其他
  3. 该课程的先修要求是什么？
    • 如果没有，请明确说明“无”
  4. 该课程涵盖的主要主题/科目有哪些？
    • 请求提供主要主题列表
  5. 按照2001版Bloom's Taxonomy分类的学习目标是什么？
    • 说明完成本课程后，学生将能够在各个层级展示能力：
      • Remember（记忆）：检索、识别和回忆相关知识
      • Understand（理解）：从教学信息中构建意义
      • Apply（应用）：在给定情境中执行或使用流程
      • Analyze（分析）：将内容分解为部分并确定相互关系
      • Evaluate（评估）：根据标准和准则做出判断
      • Create（创造）：将元素组合成连贯的整体；包括顶点项目

1.2 Generate Course Description

1.2 生成课程描述

Use the template from 
assets/course-description-template.md
and populate it with the user's responses. Create the file at 
/docs/course-description.md
.
Ensure the generated file includes:
  • Clear course title
  • Target audience specification
  • Prerequisites (or "None")
  • Comprehensive list of main topics
  • Section for topics NOT covered (to set boundaries)
  • Detailed learning outcomes organized by all six Bloom's Taxonomy levels
  • Descriptive text explaining why the course is important
使用
assets/course-description-template.md
中的模板，填入用户的回答。在
/docs/course-description.md
路径下创建文件。
确保生成的文件包含：
  • 清晰的课程标题
  • 目标受众说明
  • 先修要求（或“无”）
  • 完整的主要主题列表
  • 不涵盖的主题部分（用于界定范围）
  • 按Bloom's Taxonomy全部六个层级组织的详细学习目标
  • 说明课程重要性的描述性文本

1.3 After Creation

1.3 创建完成后

After creating the file, automatically proceed to Step 2 (Analysis Workflow) to validate the newly created course description and provide a quality score.
创建文件后，自动进入步骤2（分析工作流），验证新创建的课程描述并提供质量分数。

Step 2: Course Description Analysis

步骤2：课程描述分析

Use this workflow when 
/docs/course-description.md
already exists.
当
/docs/course-description.md
已存在时使用此工作流。

2.1 Read the Course Description

2.1 读取课程描述

Read 
/docs/course-description.md
and analyze its contents against the quality criteria.
读取
/docs/course-description.md
并根据质量标准分析其内容。

2.2 Course Description Quality Scoring System

2.2 课程描述质量评分体系

Evaluate the course description using this 100-point scoring system:
ElementPointsCriteria
Title5Clear, descriptive course title present
Target Audience5Specific audience identified (e.g., "college undergraduate")
Prerequisites5Prerequisites listed or explicitly stated as "None"
Main Topics Covered10Comprehensive list of topics (ideally 5-10 topics)
Topics Excluded5Clear boundaries set for what's NOT covered
Learning Outcomes Header5Clear statement: "After this course, students will be able to..."
Remember Level10Multiple specific outcomes for remembering/recalling
Understand Level10Multiple specific outcomes for understanding/explaining
Apply Level10Multiple specific outcomes for applying/using
Analyze Level10Multiple specific outcomes for analyzing/breaking down
Evaluate Level10Multiple specific outcomes for evaluating/judging
Create Level10Multiple specific outcomes for creating/synthesizing; includes capstone ideas
Descriptive Context5Additional context about course importance, relevance, or value
Scoring Guidelines:
  • Award full points if element is complete and high-quality
  • Award partial points if element is present but incomplete or vague
  • Award 0 points if element is missing
  • For Bloom's Taxonomy levels, require at least 3 specific, actionable outcomes for full points
使用以下100分制评分体系评估课程描述：
元素分值标准
标题5存在清晰、描述性的课程标题
目标受众5明确指定受众（例如“大学本科”）
先修要求5列出先修要求或明确说明“无”
涵盖的主要主题10完整的主题列表（理想情况下为5-10个主题）
排除的主题5清晰界定不涵盖的内容
学习目标标题5存在清晰的表述：“完成本课程后，学生将能够...”
Remember层级10多个具体的记忆/回忆目标
Understand层级10多个具体的理解/解释目标
Apply层级10多个具体的应用/使用目标
Analyze层级10多个具体的分析/分解目标
Evaluate层级10多个具体的评估/判断目标
Create层级10多个具体的创造/综合目标；包含顶点项目思路
描述性背景5关于课程重要性、相关性或价值的额外背景信息
评分准则：
  • 若元素完整且质量高，给予满分
  • 若元素存在但不完整或模糊，给予部分分数
  • 若元素缺失，给予0分
  • 对于Bloom's Taxonomy层级，需至少3个具体、可操作的目标才能获得满分

2.3 Gap Analysis

2.3 差距分析

Identify missing or weak elements:
  • List each element that scored less than full points
  • Explain what is missing or insufficient
  • Indicate how the absence impacts learning graph generation
识别缺失或薄弱的元素：
  • 列出每个得分未达满分的元素
  • 说明缺失或不足的内容
  • 指出该缺失对学习图谱生成的影响

2.4 Improvement Suggestions

2.4 改进建议

Provide specific, actionable recommendations:
  • For missing elements: Suggest what should be added
  • For weak elements: Provide examples of how to strengthen them
  • For Bloom's Taxonomy outcomes: Recommend specific verbs and topics
  • Prioritize suggestions that will have the most impact on reaching the goal of generating 200 concepts
提供具体、可执行的建议：
  • 对于缺失元素：建议应添加的内容
  • 对于薄弱元素：提供强化的示例
  • 对于Bloom's Taxonomy目标：推荐具体的动词和主题
  • 优先推荐对实现生成200个概念目标影响最大的建议

2.5 Course Description Assessment Report

2.5 课程描述评估报告

Use 
mkdir -p docs/learning-graph
to create a 
learning-graph
directory in the docs directory.
Generate a comprehensive quality report on the course description and write it to 
docs/learning-graph/course-description-assessment.md
  1. Overall Score: X/100
  2. Quality Rating:
    • 90-100: Excellent - Ready for learning graph generation
    • 75-89: Good - Minor improvements recommended
    • 60-74: Adequate - Several improvements needed
    • 40-59: Fair - Significant gaps to address
    • 0-39: Poor - Major revision required
  3. Detailed Scoring Breakdown: Show points earned for each element
  4. Gap Analysis: List of missing or weak elements
  5. Improvement Suggestions: Prioritized recommendations
  6. Next Steps:
    • If score ≥ 85: Ready to proceed with learning graph generation
    • If score < 85: Recommend addressing specific gaps before generating learning graph
使用
mkdir -p docs/learning-graph
在docs目录下创建
learning-graph
目录。
生成课程描述的全面质量报告，并写入
docs/learning-graph/course-description-assessment.md
  1. 总体得分: X/100
  2. 质量评级:
    • 90-100: 优秀 - 可用于学习图谱生成
    • 75-89: 良好 - 建议进行小幅改进
    • 60-74: 合格 - 需要进行多项改进
    • 40-59: 一般 - 存在显著差距需要解决
    • 0-39: 较差 - 需要大幅修订
  3. 详细得分 breakdown: 展示每个元素的得分
  4. 差距分析: 缺失或薄弱元素列表
  5. 改进建议: 按优先级排序的建议
  6. 下一步行动:
    • 若得分≥85：可继续进行学习图谱生成
    • 若得分<85：建议先解决特定差距再生成学习图谱

2.6 Update Course Description Metadata

2.6 更新课程描述元数据

In this section NAME is the name of the course taken from the course description. QUALITY_SCORE is the score you computed for the course description.
If it does not exist, add the following yml metadata at the top of the docs/course-description.md file:
yml
---
title: Course Description for Course NAME
description: A detailed course description for NAME including overview, topics covered and learning objectives in the format of the 2001 Bloom Taxonomy
quality_score: QUALITY_SCORE
---
本部分中的NAME是从课程描述中提取的课程名称。QUALITY_SCORE是你为课程描述计算的分数。
如果不存在，在docs/course-description.md文件顶部添加以下yml元数据：
yml
---
title: Course Description for Course NAME
description: A detailed course description for NAME including overview, topics covered and learning objectives in the format of the 2001 Bloom Taxonomy
quality_score: QUALITY_SCORE
---

2.7 Concept Generation Readiness

2.7 概念生成就绪性评估

Assess whether the course description contains sufficient detail to generate 200 concepts:
  • Evaluate topic breadth and depth
  • Check if Bloom's Taxonomy outcomes suggest diverse concept types
  • Estimate potential concept count based on current content
  • Recommend additions if concept generation may fall short
评估课程描述是否包含足够的细节以生成200个概念：
  • 评估主题的广度和深度
  • 检查Bloom's Taxonomy目标是否暗示了多样化的概念类型
  • 根据当前内容估算潜在的概念数量
  • 如果概念生成可能不足，建议补充内容

Add course-description.md and and the course-description-assessment.md to mkdocs.yml Navigation

将course-description.md和course-description-assessment.md添加到mkdocs.yml导航

After the course-description.md file has been added to the /docs direction, ask the user if the new file should be added to the mkdocs.yml file. If the answer is yes, place the new file after the about.md file.
yml
nav:
   ...
   About: about.md
   Course Description: course-description.md
   ...
   Learning Graph:
      Course Description Assessment: learning-graph/course-description-assessment.md
在course-description.md文件添加到/docs目录后，询问用户是否应将新文件添加到mkdocs.yml文件中。如果用户回答是，将新文件放在about.md文件之后。
yml
nav:
   ...
   About: about.md
   Course Description: course-description.md
   ...
   Learning Graph:
      Course Description Assessment: learning-graph/course-description-assessment.md

Next Step

下一步

For all users with a score over 85, ask if the 
learning-graph-generator
skill should be run next.
对于所有得分超过85分的用户，询问是否应运行
learning-graph-generator
Skill。

Best Practices

最佳实践

When using this skill:
  1. Be thorough: Don't skip Bloom's Taxonomy levels—all six are essential for comprehensive learning
  2. Be specific: Vague outcomes like "understand the material" won't support quality learning graphs
  3. Use action verbs: Each outcome should start with a measurable verb (list, explain, apply, analyze, evaluate, design, etc.)
  4. Think concepts: Each topic and outcome should suggest multiple learnable concepts
  5. Set boundaries: Topics excluded are as important as topics covered for scope management
使用此Skill时：
  1. 全面性：不要跳过Bloom's Taxonomy的任何层级——全部六个层级对于全面学习至关重要
  2. 具体性：像“理解内容”这样模糊的目标无法支持高质量的学习图谱
  3. 使用动作动词：每个目标都应以可衡量的动词开头（列举、解释、应用、分析、评估、设计等）
  4. 以概念为导向：每个主题和目标都应暗示多个可学习的概念
  5. 设定边界：排除的主题与涵盖的主题对于范围管理同样重要

Resources

资源

assets/

assets/

  • course-description-template.md
    : Template structure for creating new course descriptions with all required sections and Bloom's Taxonomy framework
  • course-description-template.md
    : 用于创建新课程描述的模板结构，包含所有必填部分和Bloom's Taxonomy框架