CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

quiz-generator

Generate quiz/exam content from validated files. Input is path to __cc_validated_files/ folder containing extracted text. Output is quiz markdown in __ccg_Exam/ folder. Generates multiple choice, short answer, and true/false questions. Use after content extraction pipeline completes to create assessment materials.

Quality

77%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./skills/quiz-generator/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

67%Weight 40%Scale 1-5

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

The body is a well-organized, mostly executable guide with a clear Quick Start and accurate output structure, but its actionability is undermined by CLI documentation that does not match the actual script — three advertised options (--topic, --difficulty, --format) are unimplemented, and one Quick Start example would fail. Workflow sequencing is clear yet lacks any verification checkpoints.

Suggestions

Reconcile the CLI Reference and Quick Start with the actual script: either implement --topic, --difficulty, and --format in quiz_generate.py or remove them (and the '--topic "Chapter 3"' example) from SKILL.md.

Add a brief validation step to the workflow, e.g. checking that __cc_validated_files/ contains text files before generating and spot-checking quiz_full.md/answer_key.md afterward.

Trim the generic advice in the Notes section ('Requires sufficient content...', 'For best results, ensure validated files contain clean text') to save tokens without losing guidance.

DimensionReasoningScore

Conciseness

The body is efficient: Quick Start commands, a compact output tree, brief question-format examples, and a CLI reference, with almost no explanation of concepts Claude already knows. Minor trimming is possible in the 'Notes' section ('For best results, ensure validated files contain clean text') and the descriptive 'Content Analysis' list, which keeps it at anchor 4 rather than 5.

4 / 5

Actionability

Quick Start provides runnable commands, but the documented CLI is not reliable: 'quiz_generate.py' implements only -o/--mc/--sa/--tf/--seed/-j, while the CLI Reference and a Quick Start example advertise '--topic', '--difficulty', and '--format' options that do not exist, so 'python scripts/quiz_generate.py ./validated --topic "Chapter 3"' would fail. Documented-but-nonexistent options are missing key details rather than a minor gap, matching anchor 3 rather than anchor 4.

3 / 5

Workflow Clarity

The core action is unambiguous (run the script against the validated-files directory) and the Integration section lays out a clear 3-step pipeline sequence. Checkpoints are implicit at best — there is no step verifying the input files exist or the generated output is well-formed — and pipeline step 2 is vague ('handled by pdf/docx/etc. skills'), so anchor 4 fits better than 5; the batch generation is non-destructive, so the validation cap at 3 does not apply.

4 / 5

Progressive Disclosure

The skill is well-organized into clearly headed sections with a single real bundle file (scripts/quiz_generate.py) referenced correctly and no nested references. At ~112 lines with inline CLI and question-format documentation that could arguably live in a reference file, it sits at anchor 4 ('good structure; minor organization gaps') rather than the lean single-overview profile of anchor 5.

4 / 5

Total

15

/

20

Passed

Description

75%Weight 40%Scale 1-5

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 solid description: it states concrete capabilities with explicit input and output locations, includes an explicit 'Use after...' trigger clause, and stays concise in third-person voice. The main improvement opportunities are broadening natural trigger synonyms and tying the 'when' to user-facing phrases rather than internal pipeline state.

DimensionReasoningScore

Specificity

The description lists several concrete actions — 'Generate quiz/exam content from validated files', 'Generates multiple choice, short answer, and true/false questions' — plus concrete input ('__cc_validated_files/ folder containing extracted text') and output ('quiz markdown in __ccg_Exam/ folder') locations. It falls just short of anchor 5's comprehensive coverage since it omits capabilities like answer-key generation and topic/difficulty filtering.

4 / 5

Completeness

Both 'what' and 'when' are explicitly present: the what is concrete (generate MC/SA/TF quiz content with defined input/output), and the when is stated as 'Use after content extraction pipeline completes to create assessment materials'. The when is explicit but pipeline-conditional rather than phrased around natural user triggers, matching anchor 4 ('when' could be more explicit or specific) rather than anchor 5's concrete trigger phrases.

4 / 5

Trigger Term Quality

Natural user phrases like 'quiz', 'exam', 'assessment materials', and the question types 'multiple choice, short answer, and true/false' give good keyword coverage. It misses common synonyms such as 'test', 'practice questions', or 'study guide', keeping it below anchor 5.

4 / 5

Distinctiveness Conflict Risk

The niche is fairly distinct — quiz generation tied to a specific validated-files pipeline — with clear triggers like 'quiz/exam content' and 'assessment materials'. Minor overlap risk remains with other assessment or study-material skills, so anchor 4 fits better than anchor 5's minimal-conflict profile.

4 / 5

Total

16

/

20

Passed

Validation

100%

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

KennethJefferson/cc_sdk_knowledge_extractor

Path

skills/quiz-generator/SKILL.md

Reviewed

Table of Contents

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.