quiz-master - SKILL.md Agent Skill

name: quiz-master description: Creates, administers, and grades educational quizzes with immediate feedback using rule-based evaluation systems. No LLM calls for grading.

Quiz Master Skill

Purpose

Creates, administers, and grades educational quizzes with immediate feedback using rule-based evaluation systems. Ensures deterministic, fair, and consistent grading without relying on LLM API calls.

When to Use This Skill

When a user wants to take a quiz or assessment
When creating practice quizzes for educational content
When providing formative assessment opportunities
When offering immediate feedback on user responses
When deterministic grading is required without AI dependencies

Core Behaviors

Rule-Based Grading: Uses predefined answer keys and rubrics for grading
Immediate Feedback: Provides instant feedback on answers with explanations
Educational Focus: Focuses on reinforcing learning rather than just testing
Consistent Scoring: Maintains consistent grading standards across all users
Detailed Explanations: Explains both correct answers and why incorrect options are wrong

Implementation Pattern

USER: Create a quiz about [topic] OR Take me through a quiz about [topic] OR Grade this response: [answer]

SKILL RESPONSE:
1. Quiz Creation: Generate quiz with questions and answer keys based on content
2. Quiz Administration: Present questions one at a time with clear instructions
3. Response Collection: Accept and validate user responses
4. Rule-Based Grading: Evaluate against stored answer keys and rubrics
5. Feedback Generation: Provide detailed feedback based on rule-based evaluation
6. Score Calculation: Compute score based on points assigned to correct answers
7. Improvement Suggestions: Recommend areas for improvement based on incorrect answers
8. Progress Tracking: Update learning progress based on quiz performance

Algorithmic Approach

1. Quiz Creation

Select questions from available content database
Apply randomization to question order if needed
Ensure balanced difficulty distribution
Generate answer keys with point values

2. Rule-Based Grading

Multiple Choice: Compare against correct answer keys
True/False: Direct comparison with answer keys
Fill-in-the-Blank: Exact match or close approximation scoring
Essay Questions: Keyword matching and structural analysis against rubrics

3. Feedback Generation

Identify specific areas where response was correct/incorrect
Provide targeted suggestions for improvement
Connect to relevant course materials for further study
Highlight common misconceptions

4. Score Calculation

Apply predetermined point values to each question
Calculate weighted scores based on question difficulty
Generate percentage-based overall scores
Apply grading curves if configured

5. Quiz Administration

Present questions in logical sequence
Implement time limits if specified
Track user's progress through quiz
Validate responses before grading

Quality Standards

Maintain consistent scoring across all users
Provide specific, actionable feedback
Ensure grading aligns with educational objectives
Identify and flag potential misconceptions
Suggest specific next steps for improvement
Use only deterministic algorithms (no LLM calls)
Ensure fairness and reliability in grading
Maintain security of answer keys and rubrics
Provide clear explanations of scoring criteria