CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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.

Quality

84%

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

SKILL.md
Quality
Evals
Security

Quality

Content

71%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.

A well-structured methodology skill: concrete numeric guidance, named patterns with choice criteria, and exemplary progressive disclosure across nine real one-level-deep reference files. The main weakness is redundancy — the core framing and several examples are repeated across the intro, keystone, anti-patterns, framework, and closing sections, which inflates token cost without adding guidance.

Suggestions

State the clickbait-quiz / vanity-result / actionable-segmentation distinction once in its keystone section and reference it elsewhere; it is currently fully re-explained in the intro, the keystone section, the anti-patterns section, framework item 2, and the closing.

Delete or drastically compress the closing section — it restates the intro nearly verbatim ('compounding assets', the three patterns, the same design-choice list) and adds no new guidance.

Remove duplicated examples: 'What kind of pizza are you?' appears in both the intro and the keystone section, 'What kind of marketer are you' appears in both the mapping and anti-patterns sections, and '3 emails later' appears in both the mapping discipline and the closing.

DimensionReasoningScore

Conciseness

The keystone clickbait/vanity/actionable framing is restated five times (intro, keystone section, anti-patterns, framework item 2, closing), and specific examples repeat ('What kind of pizza are you?', 'What kind of marketer are you', '3 emails later', 'compounding assets' each appear twice). Individual sections are efficient and assume practitioner-level knowledge, so it is above anchor 2's padded sections, but the cross-section redundancy is more than minor trimming — it fits anchor 3 (mostly efficient but could be tightened) rather than anchor 4.

3 / 5

Actionability

Concrete, specific guidance throughout: exact ranges ('5-12 questions', '4-8 result categories'), four named scoring patterns with explicit choice criteria, three named lead-capture patterns with tradeoffs, a litmus test, and a 12-consideration framework. It is below anchor 5 because no complete worked example (a sample quiz with segments and matched recommendations) appears inline — those live in the reference files.

4 / 5

Workflow Clarity

The design process is clearly sequenced (format decision → question architecture → scoring → categorization → recommendation mapping → lead capture → measurement) and checkpoints exist (the litmus test, segment-balance review, audit cadence, failure-mode diagnostics). Below anchor 5 because there are no explicit validate-then-proceed or error-recovery loops connecting the framework steps.

4 / 5

Progressive Disclosure

Each major section ends with a 'Detail in [references/...]' link to a real file in the bundle, all nine referenced files exist, references are exactly one level deep, and a consolidated Reference files section lists each with a one-line description. Matches the anchor-5 example of a clear overview with well-signaled one-level-deep references.

5 / 5

Total

16

/

20

Passed

Description

91%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 strong description that explicitly states what the skill does, lists the five capability areas of the design pipeline, and provides comprehensive natural trigger terms including scenario-based triggers. The only weaknesses are editorial padding that dilutes specificity and a few broad trigger terms that could overlap with sister skills.

DimensionReasoningScore

Specificity

Lists several specific capability areas ('Question architecture, scoring algorithms, result categorization, recommendation mapping, lead capture integration') covering the full design pipeline, but the anchor-5 example is achieved with lean, unpadded lists, whereas this description pads with editorial framing ('rather than generating clicks for clicks' sake', 'Honest about... patterns'). It exceeds anchor 3 because coverage goes well beyond 1-2 actions and is near-comprehensive for the domain.

4 / 5

Completeness

Explicitly answers both 'what' ('Designing quizzes, personality assessments, and recommendation tools that segment users into actionable categories... Question architecture, scoring algorithms, result categorization, recommendation mapping, lead capture integration') and 'when' ('Triggers on quiz, assessment...' plus concrete scenario triggers like 'when a vanity quiz is producing engagement but no qualified leads'). Matches the anchor-5 example structure exactly.

5 / 5

Trigger Term Quality

'Triggers on quiz, assessment, personality test, recommendation tool, scorecard, diagnostic, fit evaluator, what-type-of-X-are-you, persona quiz' — comprehensive natural keyword coverage including synonyms and the colloquial phrasing a user would actually type. Matches the anchor-5 standard (comprehensive coverage including synonyms).

5 / 5

Distinctiveness Conflict Risk

Quiz-specific triggers (persona quiz, what-type-of-X-are-you) carve a clear niche, but broader terms (assessment, diagnostic, scorecard, lead magnet) overlap with closely related growth-marketing skills. Fits anchor 4 (mostly distinct, minor overlap risk with closely related skills) rather than 5, whose triggers leave minimal conflict risk.

4 / 5

Total

18

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository

rampstackco/claude-skills

Path

skills/quiz-and-assessment-design/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.