CtrlK
BlogDocsLog inGet started
Tessl Logo

quiz-and-assessment-design

Designing quizzes, personality assessments, and recommendation tools that segment users into actionable categories rather than generating clicks for clicks' sake. Question architecture, scoring algorithms, result categorization, recommendation mapping, lead capture integration. Honest about clickbait-quiz (engagement only), vanity-result (entertaining, not useful), and actionable-segmentation (genuine categorization that drives next-step recommendations) patterns. Triggers on quiz, assessment, personality test, recommendation tool, scorecard, diagnostic, fit evaluator, what-type-of-X-are-you, persona quiz. Also triggers when an audience needs a categorization-driven lead magnet, when a vanity quiz is producing engagement but no qualified leads, or when an assessment is being scoped for the first time.

58

Quality

67%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./skills/quiz-and-assessment-design/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

100%

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

This is a strong, well-crafted skill description that excels across all dimensions. It provides specific capabilities, extensive natural trigger terms, explicit 'when to use' guidance, and occupies a distinct niche. The description is detailed without being padded, and the three-pattern taxonomy (clickbait-quiz, vanity-result, actionable-segmentation) adds genuine discriminative value.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: 'question architecture, scoring algorithms, result categorization, recommendation mapping, lead capture integration.' Also distinguishes between three specific patterns (clickbait-quiz, vanity-result, actionable-segmentation) with clear definitions.

3 / 3

Completeness

Clearly answers both 'what' (designing quizzes, assessments, recommendation tools with specific sub-capabilities) and 'when' (explicit 'Triggers on...' clause with extensive keyword list plus situational triggers like 'when an assessment is being scoped for the first time').

3 / 3

Trigger Term Quality

Excellent coverage of natural trigger terms including 'quiz, assessment, personality test, recommendation tool, scorecard, diagnostic, fit evaluator, what-type-of-X-are-you, persona quiz.' These are terms users would naturally use, and the description also covers situational triggers like 'categorization-driven lead magnet' and 'vanity quiz producing engagement but no qualified leads.'

3 / 3

Distinctiveness Conflict Risk

Occupies a very clear niche around interactive quiz/assessment design with marketing-oriented segmentation. The specific terminology (scoring algorithms, result categorization, lead capture integration, actionable-segmentation vs vanity-result patterns) makes it highly unlikely to conflict with other skills.

3 / 3

Total

12

/

12

Passed

Implementation

35%

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

This skill is a comprehensive but excessively verbose guide to quiz and assessment design. Its main strength is the clear conceptual framework (clickbait vs vanity vs actionable-segmentation) and the structured 12-consideration checklist. Its main weaknesses are significant verbosity with repeated concepts, lack of concrete worked examples (no sample quiz with actual questions and scoring), and missing validation steps in the workflow. The content would benefit greatly from being cut by 40-50% and adding one complete worked example.

Suggestions

Cut content by 40-50%: remove the repeated clickbait-vs-vanity-vs-actionable explanations (appears 3+ times), the closing section that restates the entire skill, and basic concepts like what multiple-choice questions are. State the keystone framing once and reference it.

Add one complete worked example: a 5-question mini-quiz with actual questions, answer options, scoring weights, 4 result segments, and matched recommendations. This would dramatically improve actionability.

Add explicit validation checkpoints to the workflow: e.g., 'Test segment balance with 20 sample responses before launch', 'Verify each segment has a distinct recommendation before building the result pages'.

Move detailed content (anti-patterns, failure modes, scoring algorithm details) into the referenced files and keep only summaries in the main skill, since the reference structure already exists.

DimensionReasoningScore

Conciseness

Extremely verbose at ~300+ lines. Extensively explains concepts Claude already understands (what clickbait quizzes are, what multiple-choice questions are, basic question phrasing advice like 'avoid jargon'). The opening paragraphs are philosophical framing that could be condensed to 2-3 sentences. Many sections repeat the same clickbait-vs-vanity-vs-actionable distinction multiple times. The closing section restates what was already said throughout.

1 / 3

Actionability

Provides structured frameworks (the 12 considerations, scoring algorithm patterns, question architecture guidelines) that give concrete guidance, but lacks executable examples—no sample quiz with actual questions, scoring weights, or result mappings that could be directly used as templates. The guidance is specific in principle but abstract in execution; a worked example showing a complete mini-quiz with scoring would significantly improve actionability.

2 / 3

Workflow Clarity

The 12-consideration framework provides a clear checklist, and sections are logically sequenced from decision-to-build through design through measurement. However, there are no explicit validation checkpoints or feedback loops in the design process—no 'test with N users before launching' step, no 'validate segment balance with sample data' step. The common failure modes section lists diagnostics but doesn't integrate them into the workflow as verification gates.

2 / 3

Progressive Disclosure

References to 9 separate reference files are well-organized and clearly signaled at both section level and in a consolidated reference list. However, no bundle files are provided, so the references are promises without substance. The main file itself contains too much inline content that could be pushed to references—the anti-patterns section, common failure modes, and detailed scoring algorithm descriptions could live in the referenced files, making the main skill leaner.

2 / 3

Total

7

/

12

Passed

Validation

90%

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

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

10

/

11

Passed

Repository
rampstackco/claude-skills
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.