How to use the Quiz Maker agent skill: test papers and answer keys

What is an agent skill?

An agent skill is a folder of instructions that an AI agent loads when a task matches it. The skill for this guide is distributed as a ZIP file containing a single file, SKILL.md, which holds the workflow and rules the agent follows.

Once installed, you do not need to call the skill by name. You make a request in plain language, and the agent uses the skill when the request fits.

What the skill makes the agent do

The agent first confirms the paper parameters it needs: grade level and subject, the knowledge points, total marks and time limit, question types, the difficulty split, and whether the paper must map to a textbook chapter. If you give only a topic, it defaults to a 30-minute classroom quiz of 12 to 15 questions.

Next it drafts a blueprint showing how questions are spread across knowledge points, question types, difficulty and marks, and waits for you to confirm it. Only then does it write the questions, so coverage does not end up skewed.

• Paper section: a header with subject, time limit, total marks and a name line, then questions grouped by type
• Answer key under a separate heading, with the answer, worked steps, a common-pitfall note and the knowledge point for each question
• Optional Excel coverage workbook with formulas that total the share of marks per difficulty and per knowledge point

Install the skill

Download the ZIP from the skill's page in this directory. Then choose one of the following routes.

For a personal install, unzip the file into ~/.claude/skills/. To keep the skill with one project, unzip it into that project's .claude/skills/ folder.

In the Claude apps, you can instead upload the skill under Settings → Capabilities → Skills.

• Personal: unzip into ~/.claude/skills/
• Project only: unzip into .claude/skills/ inside the project folder
• Claude apps: Settings → Capabilities → Skills, then upload

What the skill needs

The skill produces Word files with the document tools available in your agent environment. The optional Excel coverage workbook needs spreadsheet tools in that environment. If your agent has no document tools, the skill cannot deliver the Word paper.

The skill runs no scripts and uses no network access, according to its listing.

• Document tools in the agent environment (required for the Word paper)
• Spreadsheet tools (only if you want the Excel coverage workbook)

How to trigger the skill with natural requests

Describe the test you want in one message. Include the knowledge points and the difficulty if you have them. The agent will ask for anything missing, once.

The skill's listing includes two example prompts you can adapt.

• Write a 30-minute classroom quiz on quadratic equations
• Write a mid-term mock paper with explanations from this list of knowledge points

Safety notes and limits

The agent's facts and answers can be wrong. The skill tells the agent to swap out any question whose subject fact is uncertain rather than verify it, so you should still check the paper before using it.

The skill is not suitable for official, high-stakes exams where questions must be vetted by subject experts. It also cannot reproduce a specific copyrighted textbook exactly; it writes only original or adapted questions, and adapted questions note the type they came from.

• Check every answer before classroom or exam use
• Do not rely on it for official, high-stakes exams
• Expect original or adapted questions, not copies of a textbook

Tips for better papers

Give the agent a concrete list of knowledge points rather than a broad subject, and state a difficulty split such as easy:medium:hard = 5:3:2 if you have one. Ask for the Excel workbook only when you need the coverage analysis.

Review the blueprint before confirming it. Changing counts there is far easier than editing the finished paper.

• List specific knowledge points
• State a difficulty split, for example easy:medium:hard = 5:3:2
• Request the Excel workbook only when you need coverage analysis
• Confirm the blueprint before the questions are written