EX

exam-construction

Generates and reviews examination materials based on course objectives and content domains.

Install

mkdir -p .claude/skills/exam-construction && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/11375" && unzip -o skill.zip -d .claude/skills/exam-construction && rm skill.zip

Installs to .claude/skills/exam-construction

Activation

This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.

Use this skill when the user asks to design, generate, review, revise, or assemble an examination paper, test blueprint, item bank, answer key, scoring rubric, or post-exam item analysis for a course. Best suited to higher-education and classroom assessments, including closed-book final exams, quizzes, formative tests, and course-level question banks. Do not use for unsupervised high-stakes certification, medical/legal licensing, admissions, employment selection, or psychometric instrument development without expert human review.
535 chars✓ has a “when” triggerlonger than Claude Code's old 250-char listing cap (fine on current versions)
Advanced

Key capabilities

  • Design exam papers
  • Create question banks
  • Build scoring rubrics
  • Analyze exam results

How it works

It constructs assessments as evidence-based instruments, aligning items with learning objectives and cognitive processes.

Inputs & outputs

You give it
Assessment requirements
You get back
Exam paper, answer key, or analysis report

When to use exam-construction

  • Designing final exam papers
  • Creating question banks
  • Building scoring rubrics

About this skill

Exam Construction Skill

Core Principle

Construct examinations as evidence-based measurement instruments, not as loose collections of questions. Every item must be traceable to a learning objective, a content domain, and an intended cognitive process. Prioritize alignment, representativeness, score-interpretation clarity, reliability safeguards, validity evidence, fair difficulty, transparent scoring, and post-exam revision.

Trigger Conditions

Use this skill when the user requests any of the following:

  • “出一套试卷 / 设计试卷 / 生成考试题 / 编制题库 / 设计期末考试”
  • “优化选择题 / 优化干扰项 / 检查试题质量 / 生成评分标准”
  • “根据教学大纲、课件、教材或知识点生成考试”
  • “制作 A/B 卷、答题纸、参考答案、评分细则、双向细目表”
  • “分析考试结果、题目难度、区分度、信度或命题质量”

Do not use this skill for ordinary knowledge问答 unless the user is explicitly constructing or evaluating assessment materials.

Required Inputs

Collect the following if available. If the user has already provided them, do not ask again.

  1. Course name and target students.
  2. Assessment purpose: final exam, midterm, quiz, diagnostic test, formative exercise, item bank, or review exercise.
  3. Exam mode: closed-book, open-book, take-home, online, oral, or mixed.
  4. Time limit and total score.
  5. Teaching content: syllabus, lecture slides, textbook chapters, teacher notes, or knowledge-point list.
  6. Question types and proportions: MCQ, multiple-select, true/false, fill-in, definition, short answer, essay, case analysis, calculation, data interpretation.
  7. Desired cognitive distribution: remembering, understanding, application, analysis, evaluation, creation; or course-specific categories.
  8. Difficulty distribution: easy / medium / hard, or expected percent correct.
  9. Constraints: excluded topics, required topics, number of items, formatting, answer sheet needs, A/B卷 rules, anti-leakage requirements.
  10. Intended score interpretation: criterion-referenced, norm-referenced, qualitative, diagnostic, or mixed.
  11. Accessibility/fairness constraints: language level, accommodations, student background, and construct-irrelevant barriers.

If key inputs are missing and the task is still feasible, make conservative defaults and state them. For a typical closed-book university final exam, default to: 100 points, 90–120 minutes, broad coverage, moderate difficulty, criterion-referenced interpretation, and a mix of objective and application-oriented subjective items.

Workflow

Step 1: Establish the Assessment Claim and Score Interpretation

State what inference the exam should support. Examples:

  • Students can accurately recall and explain core concepts.
  • Students can distinguish related theories and developmental constructs.
  • Students can apply course theories to educational or developmental cases.
  • Students can analyze ambiguous real-world scenarios using course evidence.

Reject or revise items that do not contribute to this claim.

Specify whether the score will be interpreted as:

  • Criterion-referenced: degree of mastery of defined course objectives.
  • Norm-referenced: relative standing among students.
  • Diagnostic: evidence about strengths, weaknesses, or misconceptions.
  • Qualitative: descriptive performance categories or narrative feedback.

For classroom course exams, default to criterion-referenced interpretation unless the user explicitly requests relative grading. Do not mix achievement, effort, improvement, and attendance in a single exam score unless the grading policy explicitly defines that composite.

Step 2: Build Educational Objectives and a Test Blueprint

Before generating items, create or infer educational objectives and then build a blueprint unless the user explicitly asks for only a small number of practice questions.

Objective-writing rules:

  • Convert broad course aims into assessable outcomes.
  • Prefer verbs that specify observable evidence: define, distinguish, explain, apply, analyze, evaluate, design.
  • Classify objectives by cognitive domain by default; include affective or psychomotor objectives only when they are genuinely assessed.
  • Avoid objectives that are too broad to sample fairly with the planned test length.

Blueprint dimensions:

  • Content domain: chapters, lectures, themes, or learning objectives.
  • Cognitive process: recall, understanding, application, analysis, evaluation.
  • Item type: MCQ, short answer, essay, case, etc.
  • Score weight and item count.
  • Difficulty target.

Rules:

  • Weight content by instructional emphasis: syllabus hours, lecture time, assignment emphasis, explicit exam focus, and course objectives.
  • Avoid overrepresenting content merely because it is easy to turn into objective questions.
  • Ensure that applied course objectives receive applied items, not only recall items.
  • Present the blueprint before full exam generation when the user is designing a formal exam.

Step 3: Define Item Specifications

For every generated or reviewed item, assign metadata:

  • Item ID
  • Content domain
  • Learning objective
  • Cognitive level
  • Item type
  • Expected difficulty
  • Correct answer or scoring key
  • Source basis: syllabus / lecture / textbook / user-provided material / teacher-added knowledge
  • Quality status: draft / reviewed / needs revision / approved

Use references/item_metadata_schema.md if a structured metadata table is needed. Use references/test_blueprint_template.md when the user asks for a formal 双向细目表 or a reusable blueprint.

Step 4: Generate Items

A. Multiple-Choice Questions

Prefer one-best-answer MCQs for formal exams.

Structure:

  • Use 4 options when there are 3 plausible distractors; use 3 options only when a fourth plausible distractor would be artificial.
  • The stem must pose a clear problem before the options are read.
  • The item should test one concept, distinction, or application target.
  • The correct answer must be defensibly best, not merely arguable.
  • All distractors must be plausible for students with partial knowledge.
  • Options should be parallel in length, specificity, and grammatical form.
  • Vary the position of correct answers across the paper.

Prohibited or strongly discouraged formats:

  • “以上都对 / 以上都不对 / all of the above / none of the above”
  • Negative stems such as “以下哪项不是……” unless the construct truly requires exception recognition.
  • Compound options such as “A 和 B 正确”.
  • Overlapping options where one option logically contains another.
  • Grammatical cues, length cues, absolute-term cues, and repeated-keyword cues.
  • Trivial textbook sentence completion that tests surface memory only.

Distractor design for psychology / education courses:

Use at least two different distractor types per item:

  • Concept confusion: mixes up related constructs, e.g., temperament vs. personality.
  • Theory confusion: attributes a claim to the wrong theorist or school.
  • Stage mismatch: uses a developmental stage but at the wrong age or with the wrong hallmark.
  • Mechanism mismatch: states a true phenomenon but gives the wrong explanatory mechanism.
  • Application error: applies a correct principle to an incompatible case.
  • Causality error: treats correlation, maturation, or contextual association as direct causation.
  • Overgeneralization: turns a probabilistic developmental tendency into an absolute rule.
  • Surface-feature trap: focuses on an irrelevant but salient detail in the vignette.

For each MCQ, internally check:

  1. Can the item be answered correctly without knowing the course content? If yes, revise.
  2. Can the correct answer be guessed from length, wording, or option pattern? If yes, revise.
  3. Are any distractors obviously irrelevant? If yes, replace.
  4. Are two answers defensible? If yes, narrow the stem or revise options.

B. True/False, Matching, and Judgment Items

Use true/false items sparingly in formal exams because guessing probability is high and statements easily become ambiguous. Avoid vague quantifiers such as “often,” “generally,” or “may” unless the course explicitly taught the probabilistic claim. Require statements to be unambiguously true or false under course assumptions.

Use matching items only for homogeneous sets of terms, theorists, stages, methods, or examples. Keep the premise list and response list clear, provide more responses than premises when appropriate, and avoid heterogeneous matching sets that turn the item into a reading puzzle.

C. Fill-in and Definition Items

Use for key terminology only. Avoid obscure wording or low-value factual minutiae. For definitions, specify required elements and acceptable synonyms in the answer key.

D. Short-Answer Items

Use short-answer items for explanation, comparison, mechanism analysis, and concise educational implications.

Each item must include:

  • Expected answer elements.
  • Score allocation by element.
  • Common partial-credit patterns.
  • Maximum expected answer length if needed.

E. Essay, Case-Analysis, Performance, and Portfolio Items

Use case analysis to assess application and integration. Use performance assessment when the course target is authentic production, demonstration, classroom design, or applied decision-making. Use portfolios only when the purpose is longitudinal evidence, reflection, or growth documentation.

Case design rules:

  • Use realistic but fictional scenarios unless the user requests real cases.
  • Include sufficient facts to support analysis, but avoid irrelevant narrative inflation.
  • Require students to identify relevant concepts, justify application, and propose reasonable implications.
  • Avoid cases where the intended answer depends on information not given in the scenario or not taught in the course.

Rubric design:

  • Separate concept identification, theoretical explanation, case evidence, reasoning quality, and practical implication.
  • Use analytic rubrics for grading consistency.
  • Define full-credit, partial-credit, and no-credit criteria.
  • For extended-response tasks, create model answers before administration.
  • For performance tasks, specify task instructions, performance criteria, evidence to

Content truncated.

When not to use it

  • For unsupervised high-stakes certification

Prerequisites

Course syllabus or content

Limitations

  • Requires expert human review for high-stakes exams
  • Analysis requires response data

How it compares

It treats exam construction as a measurement process rather than a simple collection of questions.

Compared to similar skills

exam-construction side by side with the closest alternatives in the catalog.

SkillInstallsUpdatedSafetyDifficulty
exam-construction (this skill)02moReviewAdvanced
opik-university02moNo flagsBeginner
math-prover02moNo flagsIntermediate
wiki-query04moNo flagsIntermediate

Try saying

Example prompts that trigger this skill in your AI assistant.

Search skills

Search the agent skills registry