exam-construction

Designs, reviews, and analyzes classroom exams, blueprints, rubrics, and item banks.

Updated Jun 11, 2026
One-click install
npx skills add https://github.com/psychelzh/exam-construction-agent-skill --skill exam-construction-psychelzh
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: exam-construction
Source: https://github.com/psychelzh/exam-construction-agent-skill/tree/main/claude-plugin/skills/exam-construction
Command: npx skills add https://github.com/psychelzh/exam-construction-agent-skill --skill exam-construction-psychelzh

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Building a fair, well-aligned exam is hard: items must map to learning objectives, distractors must be plausible, difficulty must be controlled, and scoring must be transparent. This Skill guides an AI agent through the full exam-construction lifecycle so classroom tests function as evidence-based measurement instruments rather than loose collections of questions. ## Core Features & Use Cases - Exam and Blueprint Generation: Creates test blueprints (双向细目表), full exam papers, A/B parallel forms, answer keys, scoring rubrics, and item metadata tables aligned to course objectives and cognitive levels. - Item Review and Revision: Diagnoses MCQ and constructed-response items for distractor quality, answer uniqueness, cueing, fairness, and cognitive level, reporting issues as blocking, major, or minor. - Post-Exam Item Analysis: Computes item difficulty, corrected item-total correlation, high-low discrimination, blank rates, and distractor frequencies from response CSVs via scripts/analyze_items.py, plus a structural MCQ warning checker (scripts/validate_mcq.py). - Use Case: Given a course syllabus for Developmental Psychology, ask for a 100-point, 90-minute closed-book final exam and receive a blueprint, student-facing paper, answer key, rubrics, item metadata, and quality-review notes. ## Quick Start Use the exam-construction skill to design a 100-point, 90-minute closed-book final exam with a two-way specification table based on the attached course syllabus.

Frequently Asked Questions about exam-construction

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate an exam from a course syllabus?

Provide the syllabus, exam mode, time limit, and total score, then request a formal exam. The skill builds a test blueprint mapping content domains to cognitive levels before generating items, answer keys, rubrics, and item metadata.

How do I analyze exam item difficulty and discrimination?

Run scripts/analyze_items.py with a wide response CSV and an answer-key CSV containing item_id and key columns. It outputs proportion correct, corrected item-total correlation, high-low discrimination, blank rate, and option frequencies per item.

How do I check multiple-choice questions for quality problems?

Use scripts/validate_mcq.py on a text or Markdown file of MCQs to flag structural risks like negative stems, all-of-the-above options, length cues, and absolute wording. Substantive correctness still requires instructor review.

Can this skill be used for high-stakes certification or licensing exams?

No. The skill explicitly excludes unsupervised high-stakes uses such as certification, admissions, employment selection, and clinical diagnosis. All summative outputs are marked as drafts requiring instructor review before administration.

What inputs are needed to build a test blueprint?

Useful inputs include course name, assessment purpose, exam mode, time limit, teaching materials, desired item types, cognitive and difficulty distributions, and constraints. Missing values fall back to stated conservative defaults such as 100 points and criterion-referenced interpretation.