AgentSkillsCN

canvas-quiz-creator

当用户需要在Canvas学习管理系统中创建或管理测验时，尤其是当他们提供需要格式化并上传的测验题目与答案时，此技能会完整地完成工作流程：1）在Canvas中找到目标课程；2）创建带有适当元数据的新测验（标题、描述、测验类型）；3）添加多项选择题，并为正确答案设置权重；4）验证测验创建过程并提供总结。当用户提到“Canvas测验”、“在Canvas上创建测试”、“将题目上传至Canvas”，或当他们提供结构化的测验题目，且这些题目需要经过格式化处理以适配Canvas API集成时，可使用此技能。

SKILL.md
--- frontmatter
name: canvas-quiz-creator
description: When the user needs to create or manage quizzes in Canvas Learning Management System, particularly when they provide quiz questions and answers that need to be formatted and uploaded. This skill handles the complete workflow including 1) Finding the target course in Canvas, 2) Creating a new quiz with proper metadata (title, description, quiz type), 3) Adding multiple-choice questions with correct answer weights, 4) Verifying the quiz creation and providing a summary. Use this skill when users mention 'Canvas quiz', 'create test on Canvas', 'upload questions to Canvas', or when they provide structured quiz questions with multiple-choice options that need to be formatted for Canvas API integration.

Instructions

1. Parse User Input

  • •Extract the quiz title from the user's request. If not specified, ask for clarification.
  • •Extract the list of questions. Each question should have:
    • •Question text
    • •Multiple-choice options (typically A, B, C, D)
    • •The correct answer (identified by letter or explicit text)
  • •Note: The user may specify points per question (e.g., "one point each"). Default to 1 point if not specified.

2. Find the Target Course

  • •Use canvas-canvas_list_courses to retrieve the list of available courses.
  • •Identify the target course. The user may specify the course name (e.g., "Art History") or you may need to infer it from context. If ambiguous, ask for clarification.
  • •Critical: Store the course ID for all subsequent API calls.

3. Create the Quiz

  • •Use canvas-canvas_create_quiz with the following parameters:
    • •course_id: The ID from step 2.
    • •title: The quiz title from step 1.
    • •description: Generate a brief, relevant description summarizing the quiz topics. If the user provides one, use it.
    • •quiz_type: Use "assignment". (The trajectory shows "graded" caused an error; "assignment" succeeded.)
    • •published: Set to false initially. The quiz can be published later by the instructor.
  • •If the API call fails (e.g., invalid quiz type), retry with quiz_type set to "assignment".
  • •Critical: Store the returned quiz ID.

4. Add Questions to the Quiz

  • •For each question extracted in step 1:
    • •Format the question text. Ensure any quotation marks are properly escaped for JSON.
    • •Prepare the answers array. Each answer object must have:
      • •text: The answer option text.
      • •weight: 100 for the correct answer, 0 for all incorrect answers.
    • •Use canvas-canvas_create_quiz_question with these parameters:
      • •course_id: The course ID.
      • •quiz_id: The quiz ID from step 3.
      • •question_name: A descriptive name (e.g., "Question 1: [Topic]").
      • •question_text: The full question text.
      • •question_type: "multiple_choice_question".
      • •points_possible: The point value for this question.
      • •position: The question number (1-indexed).
      • •answers: The array of answer objects.
  • •Process questions sequentially. The API may support batch creation, but the trajectory shows individual calls are reliable.

5. Verify and Summarize

  • •Use canvas-canvas_get_quiz to fetch the final quiz details and confirm creation.
  • •Use canvas-canvas_list_quiz_questions to list all added questions and verify the count.
  • •Present a clear summary to the user including:
    • •Quiz title and course name.
    • •Direct URL to the quiz (from the html_url field).
    • •Total points and number of questions.
    • •A list of each question with its correct answer clearly marked.
    • •A note that the quiz is unpublished by default.

6. Finalize

  • •Use local-claim_done to signal successful completion.
  • •Do not publish the quiz unless explicitly requested by the user. The default state should be unpublished.