Skip to content

rampstackco/claude-skills / skills/quiz-and-assessment-design

quiz-and-assessment-design

Verified

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.

references/quiz-investment-criteria.md

View on GitHub
# Quiz investment criteria

When a quiz is the right tool for the audience and the goal, and when a comparison table or other format would serve. The conditions that warrant the quiz format.

A quiz is a meaningful build. Question architecture, scoring algorithm, result categorization, recommendation mapping, lead-capture integration. The quiz earns this investment only when specific conditions are present.

---

## When a quiz earns the build

Five conditions that, when present, make a quiz a strong investment.

**The audience faces a decision that benefits from categorization.** "Which of our products fits my situation," "what is my readiness for X," "what type of Y am I." The categorization has to map to a real next step.

**The categorization can be derived from a small number of questions.** 5-12 questions can produce meaningful segmentation. If the categorization needs 30+ questions, the format is closer to a survey or assessment than a quiz; the audience drop-off makes the format wrong.

**The brand has a portfolio of recommendations that match the segments.** A quiz that produces 5 segments and only one recommendation is decorative; the segment-recommendation mapping is the value.

**The result format suits the audience.** Audiences who enjoy quizzes (consumers, B2B mid-market, certain creator audiences) engage well. Audiences who do not (technical buyers, enterprise sales) often see quizzes as gimmicks.

**The success metric is defined.** Lead volume from the quiz, lead quality by segment, downstream conversion per segment, the audience acting on the recommendation. Without the success metric defined, evaluation is impossible.

When all five are present, the quiz is a strong investment. When two or fewer are present, a different format (comparison table, worked example, calculator) often serves better.

---

## When a quiz does NOT earn the build

Funnels where the quiz is the wrong tool.

**The categorization is trivial.** "What plan is right for you" with two plans does not need a quiz; a comparison table works. Quizzes earn investment when the categorization is non-trivial.

**The categorization is irrelevant to the next step.** A personality quiz with no product-recommendation tie-in entertains but does not convert. The categorization needs to map to action.

**The brand has no varied recommendations.** A quiz with one outcome is bait; the segmentation is decorative. Without a portfolio of segment-matched recommendations, the quiz cannot deliver the actionable-segmentation value.

**The audience disrespects quizzes in this context.** Enterprise buyers often see quizzes as unprofessional. Technical decision-makers often skip quizzes in favor of direct documentation. The format choice has to fit the audience the brand wants to serve.

**The team cannot maintain the quiz.** Quizzes decay as recommendations change, segments evolve, and audience preferences shift. Without maintenance commitment, the quiz becomes stale.

**The audience would convert without the quiz.** When the funnel is already producing the conversion the quiz would serve, the quiz adds friction without lift.

The honest assessment matters more than the default. "Should we have a quiz" is not the question. "Is the quiz the right investment for this audience and decision" is.

---

## The opportunity-cost frame

A quiz is a meaningful build. Account for the cost honestly.

**The build cost.** Question design, scoring algorithm, result categorization, recommendation mapping, UI design, mobile responsiveness, integration. A meaningful quiz often takes 30-100 engineering hours plus design, copy, and content for the recommendations.

**The maintenance cost.** Recommendations change; segments evolve; question phrasing decays. Quarterly review and updates run 3-8 hours per active quiz.

**The recommendation portfolio cost.** Each segment needs a matched recommendation. Building or curating those recommendations is itself work.

**The opportunity cost.** What else could the team have built? A funnel improvement, a content piece, a paid-traffic optimization. The quiz's success has to clear the bar of those alternatives.

The decision frame. The quiz earns investment when it produces more lift than the alternatives, accounting for the full cost of build plus maintenance plus recommendation portfolio.

---

## The recommendation-portfolio precondition

Without a portfolio of segment-matched recommendations, the quiz cannot deliver actionable segmentation.

The check. For the segmentation the quiz will produce, does the brand have a distinct, valuable recommendation for each segment?

If yes, the quiz can deliver actionable segmentation. The takers get matched to a recommendation that fits their result.

If no (the brand has one product, one resource, one recommendation regardless of segment), the quiz becomes vanity. The segmentation is decorative; the recommendation was predetermined.

**How to assess the recommendation portfolio.**

- Does the brand have multiple products, services, or content paths that fit different audience segments?
- Can the brand articulate which recommendation fits which segment specifically?
- Are the recommendations valuable enough to that segment to justify the quiz?

If yes to most of these, the recommendation portfolio supports the quiz. If no, the quiz is the wrong format until the portfolio exists.

---

## The decision worked example

A B2B SaaS company considering a "What CRM fits your team" quiz.

**Conditions check.**

- Decision benefits from categorization: yes. Prospects evaluate CRMs based on team size, use case, sales process maturity, integration needs. The categorization is non-trivial.
- Small number of questions sufficient: yes. 6-8 questions can capture team size, use case, sales process, integration needs.
- Recommendation portfolio: yes. The brand offers 3 plan tiers plus 2 industry-specific configurations. Each segment can map to a distinct recommendation.
- Audience-fit for quiz format: yes. B2B mid-market PMs and sales leads engage with quizzes when the recommendation is genuinely useful.
- Success metric: yes. Lead volume from the quiz, lead quality (audience-fit at SaaS companies above 25 employees), downstream conversion to demo or trial within 60 days.

**Decision.** Build the quiz. The conditions warrant it.

**Result categorization.** 5 segments: "Solo founder just starting," "Growing team without CRM," "Mid-market with multiple sales reps," "Enterprise with complex sales cycles," "Integration-heavy team."

**Recommendation per segment.** Each segment maps to a specific plan and onboarding path. The segment description explains why that recommendation fits.

**Lead capture.** Email after result for personalized PDF showing the recommendation, alternative options considered, and case study from a similar customer.

The decision was not "should we have a quiz" but "given these conditions, this is the quiz to build."

---

## When to choose a different format

The quiz is the wrong tool. What works.

**Comparison table.** When the choice is between 2-4 well-defined options with clear distinguishing features, a comparison table often serves better. The audience compares directly without going through questions.

**Worked-example resource.** When the audience benefits from seeing how others in their situation chose, a 2-page worked-example resource often serves better than a quiz. The audience identifies which example matches them.

**Calculator.** When the decision benefits from a calculation rather than a categorization, a calculator serves better. Detail in `calculator-design`.

**Direct documentation.** When the audience prefers self-directed research, a clear documentation page about which option fits which situation often serves better than a quiz.

The pattern. Many "we need a quiz" intuitions are actually "we need a clear way to communicate which option fits which audience." Often the simpler format works as well or better, at lower build cost.

---

## When to retire a quiz

Quizzes decay. Retiring them is part of the discipline.

**Retire when:**

- Lead volume has dropped below baseline for two consecutive quarters.
- The recommendation portfolio has shifted enough that the quiz routes to outdated recommendations.
- One segment now receives 80 percent of takers, suggesting the question architecture no longer distinguishes.
- A newer tool or magnet on the same topic is outperforming.
- The maintenance cost exceeds the lead value.

The retiring discipline frees capacity. Stale quizzes route audience to outdated recommendations and damage trust.

---

## Methodology-level choices that stay in the public skill

The investment conditions for whether to build a quiz. The opportunity-cost frame. The recommendation-portfolio precondition. The decision worked example. When to choose a different format. The retirement discipline.

## Implementation choices that stay internal

Specific quiz topics for specific audiences. The team's capacity benchmarks for build, maintenance, and recommendation curation. Specific tooling for quiz engineering and integration. Specific recommendation portfolios per segment. These vary by team.
finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the workStars: 323kUpdated Claude CodeCodexVerifiedInstall
systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixesStars: 323kUpdated Claude CodeCodexVerifiedInstall
test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation codeStars: 323kUpdated Claude CodeCodexVerifiedInstall
skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.Stars: 198kUpdated Claude CodeCodexVerifiedInstall