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.

70

Quality

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

SKILL.md
Quality
Evals
Security

Quality

Content

72%

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

A well-structured, domain-specific playbook that earns its context with genuine growth-marketing knowledge and excellent progressive disclosure. It is slightly held back by restated framing and the absence of explicit validation checkpoints in its audit workflow.

Suggestions

Tighten the closing section and anti-pattern entries that restate the clickbait/vanity/actionable framing already covered in the keystone section, to reduce redundancy and save tokens.

Add an explicit validate→fix→retry checkpoint to the 12-considerations framework (e.g., after scoring and segment mapping, verify segment balance and recommendation distinctiveness before shipping) to lift workflow clarity.

Consider converting the rapid-fire "Common failure modes" list into a symptom→diagnosis→fix table so each failure carries an actionable cure inline rather than only pointing to a reference.

DimensionReasoningScore

Conciseness

Mostly efficient and opinionated, but the closing section and several anti-pattern entries restate the keystone framing already established earlier, and the lead paragraphs echo the frontmatter description — some tightening would remove redundancy.

2 / 3

Actionability

Instruction-only skill with concrete, specific guidance (5-12 questions, 4-8 segments, four named scoring patterns with choice criteria, three lead-capture patterns), which the rubric treats as actionable without requiring code.

3 / 3

Workflow Clarity

The 12-considerations framework gives a sequenced audit checklist, but there are no explicit validation checkpoints and "Common failure modes" is rapid-fire without a validate→fix→retry loop.

2 / 3

Progressive Disclosure

Clean overview body with nine well-signaled, one-level-deep references (all verified to exist on disk) plus a consolidated "Reference files" index and no nested references.

3 / 3

Total

10

/

12

Passed

Description

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.

A strong description: specific, third-person, with explicit trigger guidance and a distinctive niche. It answers both what and when without padding.

DimensionReasoningScore

Specificity

Lists multiple concrete action areas — "Question architecture, scoring algorithms, result categorization, recommendation mapping, lead capture integration" — rather than vague domain language, matching the multiple-specific-actions anchor.

3 / 3

Completeness

Clearly states what it does ("segment users into actionable categories") and gives explicit when-guidance via "Triggers on…" and "Also triggers when…" clauses, satisfying both what AND when.

3 / 3

Trigger Term Quality

Enumerates natural phrasings a user would actually say — "quiz, assessment, personality test, recommendation tool, scorecard, diagnostic, fit evaluator, what-type-of-X-are-you, persona quiz" — giving good coverage including the colloquial form.

3 / 3

Distinctiveness Conflict Risk

Occupies a clear niche anchored by the three-pattern framing (clickbait-quiz / vanity-result / actionable-segmentation) with a narrow trigger set, making conflict with adjacent skills unlikely.

3 / 3

Total

12

/

12

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.