generating-practice-questions

Generate educational practice questions from lecture notes to test student understanding. Use when users request practice questions, exam preparation materials, study guides, or assessment items based on lecture content.

Quality

88%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Low

Low-risk findings worth noting

Quality

Content

87%Weight 40%Scale 1-3

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A tight, actionable skill body that organizes a four-part question-generation workflow and correctly offloads templates and topic examples to clearly signaled, existing bundle files. The main gap is the absence of explicit verification checkpoints in the generation workflow.

Suggestions

Add a final verification step to the workflow, e.g. a checklist confirming each True/False and explanatory question maps to a stated learning objective or main topic.

Include an explicit checkpoint that no answer key or solution text was emitted, since the skill already forbids it but provides no way to confirm compliance.

Add a brief self-check before output that the four required question parts are all present and sequentially numbered in the chosen output format.

Dimension	Reasoning	Score
Conciseness	The body is lean and instruction-focused, avoiding explanations of concepts Claude already knows; examples and criteria earn their place rather than padding the context.	3 / 3
Actionability	Concrete, specific guidance throughout: named libraries for input parsing (pdfplumber, LaTeX preamble stripping), per-type required structures, and pointed-to output templates, giving actionable direction without lecturing.	3 / 3
Workflow Clarity	The generation sequence is clearly numbered (True/False → Explanatory → Coding → Use Case) with a defined output structure, but there are no explicit validation or verification checkpoints (e.g., confirm each question maps to a learning objective, confirm no answer key leaked), matching the level-2 anchor of sequence-present-but-checkpoints-missing.	2 / 3
Progressive Disclosure	The SKILL.md is an overview that clearly signals one-level-deep bundle files (assets/questions_template.tex, assets/markdown_template.md, references/examples_by_topic.md), all of which exist, with concise descriptions for easy navigation.	3 / 3
	Total	11 / 12 Passed

Description

90%Weight 40%Scale 1-3

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A well-crafted description that states a concrete purpose and pairs it with an explicit, natural-language trigger clause covering several user phrasings. Its only weakness is naming one main action rather than enumerating multiple concrete capabilities.

Dimension	Reasoning	Score
Specificity	Names the domain and a concrete action ("Generate educational practice questions from lecture notes to test student understanding") but describes a single primary action rather than listing multiple specific concrete actions, so it falls short of the level-3 anchor.	2 / 3
Completeness	It explicitly answers both what (generate practice questions from lecture notes) and when, with an explicit "Use when..." trigger clause, matching the level-3 anchor.	3 / 3
Trigger Term Quality	The "Use when users request practice questions, exam preparation materials, study guides, or assessment items based on lecture content" clause gives good coverage of natural terms a user would actually say.	3 / 3
Distinctiveness Conflict Risk	The niche (practice questions derived from lecture content) with distinct triggers is unlikely to fire for unrelated skills, satisfying the clear-niche anchor.	3 / 3
	Total	11 / 12 Passed

Validation

100%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository: https-deeplearning-ai/sc-agent-skills-files
Path: L5/custom_skills/generating-practice-questions/SKILL.md
Commit: 438a5a5

Reviewed: 12 days ago

Table of Contents

Discovery Implementation Validation

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.