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.

71

Quality

87%

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

78%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, opinionated methodology skill with strong progressive disclosure and concrete design rules. Its main weakness is some redundancy in the framing across intro, keystone section, and closing, and conceptual sections that are less directly actionable than the design rules.

Suggestions

Tighten the repeated clickbait/vanity/actionable framing: keep the full treatment in the dedicated section and trim its restatement in the intro and closing.

Reduce overlap between the 'What this skill covers' section and the description/catalog_summary parent-frame distinctions.

Add a short explicit validation loop (e.g., measure → flag → revise) tying the 12 considerations' measurement checkpoints back into an audit-and-iterate sequence.

DimensionReasoningScore

Conciseness

Mostly efficient domain methodology that does not over-explain basics Claude already knows, but the keystone framing is restated across the intro, a dedicated section, and the closing, and the parent-frame distinctions repeat the catalog summary — minor trim opportunities.

4 / 5

Actionability

Concrete, specific guidance (5-12 questions, 4-8 segments, named scoring patterns A-D with choice criteria, worked B2B SaaS/content/onboarding mapping examples, named anti-patterns), but the conceptual framing sections are less directly actionable.

4 / 5

Workflow Clarity

The 12-consideration framework is a clear sequenced design/audit checklist with measurement checkpoints (#10 drop-off, #11 lead-quality-by-segment, #12 audit cadence) and the investment section gives explicit gates, though validation feedback loops are only implicit.

4 / 5

Progressive Disclosure

A focused overview body with nine one-level-deep reference files, each signaled inline ('Detail in references/...') and indexed in a 'Reference files' section with one-line descriptions; all referenced files exist and navigation is easy.

5 / 5

Total

17

/

20

Passed

Description

96%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, concrete description that answers what and when with comprehensive trigger coverage and specific activity listing. The only weakness is minor overlap risk with the parent lead-magnet-design skill on the lead-magnet-oriented triggers.

DimensionReasoningScore

Specificity

Names the domain and lists multiple concrete actions — 'Question architecture, scoring algorithms, result categorization, recommendation mapping, lead capture integration' — giving comprehensive coverage of the skill's activities.

5 / 5

Completeness

Explicitly answers 'what' (designing quizzes/assessments that segment users) and 'when' ('Triggers on...' plus 'Also triggers when...'), both with concrete trigger phrases.

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' covers natural synonyms and a phrase users actually say.

5 / 5

Distinctiveness Conflict Risk

Quiz-specific triggers (personality test, scorecard, fit evaluator, what-type-of-X-are-you) carve a clear niche, but 'categorization-driven lead magnet' and 'vanity quiz producing engagement but no qualified leads' overlap with the sibling lead-magnet-design skill.

4 / 5

Total

19

/

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.

Validation15 / 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
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.