rampstackco/claude-skills / skills/quiz-and-assessment-design
quiz-and-assessment-design
VerifiedDesigning 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.
| File | Kind | Size |
|---|---|---|
| README.md | markdown | 367 B |
| SKILL.md | skill md | 21.1 KB |
| references/clickbait-vs-actionable-distinctions.md | markdown | 10.6 KB |
| references/common-quiz-failures.md | markdown | 9.5 KB |
| references/lead-capture-integration-patterns.md | markdown | 9.9 KB |
| references/question-architecture-patterns.md | markdown | 10.3 KB |
| references/quiz-anti-patterns.md | markdown | 10.3 KB |
| references/quiz-investment-criteria.md | markdown | 9.0 KB |
| references/result-categorization-patterns.md | markdown | 10.2 KB |
| references/result-to-recommendation-mapping.md | markdown | 11.4 KB |
| references/scoring-algorithm-patterns.md | markdown | 11.1 KB |
references/result-to-recommendation-mapping.md
View on GitHub# Result-to-recommendation mapping
The action attached to each category. Mapping discipline and worked examples. The recommendation is what the taker does next; without it, the quiz produces awareness without action.
The mapping is where the quiz earns its conversion. A great segmentation produces nothing if each segment lacks a matched, actionable recommendation.
---
## The mapping principle
Each segment maps to a specific recommendation. The recommendation is what the taker does next.
**The principle's three requirements.**
- The recommendation is real (the brand actually offers the recommended next step).
- The recommendation matches the segment specifically (no two segments share the same recommendation).
- The recommendation is valuable to that specific segment (not a generic offer applied to everyone).
Quizzes that hit all three produce action. Quizzes that miss any of the three produce vanity-result patterns.
---
## What a recommendation can be
The next step the taker should take. Many forms.
**Product or service.** "Solo founders benefit most from our Starter plan with the founder-led onboarding path." The recommendation is a specific tier or configuration matched to the segment.
**Content or resource.** "Mid-market operators benefit most from our 30-day playbook for unifying multi-rep teams." The recommendation is a specific resource matched to the segment.
**Conversation or consultation.** "Enterprise buyers benefit most from a 30-minute conversation with our team." The recommendation is a specific human touchpoint.
**Path or sequence.** "Creators just starting benefit most from our 4-part onboarding sequence." The recommendation is a structured next experience.
**Configuration or setup.** "Teams using Salesforce benefit most from our integration setup wizard." The recommendation is a specific technical configuration.
The form depends on the brand's offerings and the segment's situation. The discipline is that the recommendation is specific, not generic.
---
## The mapping discipline
Each segment-to-recommendation mapping should pass these tests.
**Test 1: Does the recommendation actually exist?** The brand currently offers it; it is not aspirational or in development.
**Test 2: Does the recommendation match the segment specifically?** Other segments would not benefit from this recommendation as much; the matching is real.
**Test 3: Does the recommendation deliver value to this segment?** The segment that gets this recommendation can act on it and benefit from it.
**Test 4: Is the recommendation deliverable?** The brand can provide what is being recommended in the timeframe and form the taker expects.
**Test 5: Does the recommendation include a clear action?** The taker knows what to do (click here, start here, talk to someone, download this).
When all five pass, the mapping is honest. When any fails, the mapping is decorative or misleading.
---
## Worked example: B2B SaaS pricing quiz
A SaaS platform offering 4 plan tiers with industry-specific configurations.
**Segments and recommendations.**
**Segment 1: "Solo founder just starting"**
- Description: 1-person team, exploring options, pre-revenue or early revenue.
- Recommendation: Starter plan ($X / month) with the founder-led onboarding path. Free for first 30 days; no credit card required.
- Action: "Start your 30-day trial." Direct link to signup pre-filled with the recommended plan.
**Segment 2: "Growing team without CRM"**
- Description: 2-15 people, no CRM today, sales process is informal but starting to need structure.
- Recommendation: Growth plan ($Y / month) with the team-onboarding path. 30-day setup support included.
- Action: "Talk to our team about your setup." Calendar booking link.
**Segment 3: "Mid-market with multiple reps"**
- Description: 16-100 people, multiple sales reps, defined process but inconsistent execution.
- Recommendation: Business plan ($Z / month) with multi-rep configuration and 60-day implementation support.
- Action: "Get a custom demo." Form for demo request.
**Segment 4: "Enterprise with complex sales cycles"**
- Description: 100+ people, multi-stage sales process, integration-heavy environment.
- Recommendation: Enterprise plan (custom pricing) with dedicated implementation manager.
- Action: "Talk to enterprise sales." Direct line to enterprise contact.
**Segment 5: "Integration-heavy team"**
- Description: Any size, but the primary need is integrating with their existing tool stack.
- Recommendation: Any plan plus the integration setup wizard. Detailed integration documentation linked.
- Action: "Explore our integrations." Integration catalog page.
Each segment maps to a distinct, specific recommendation. Each recommendation includes a clear action.
---
## Worked example: content-marketing quiz
A content-marketing brand offering multiple content paths.
**Segments and recommendations.**
**Segment 1: "Just starting in content"**
- Recommendation: 4-part email course covering content fundamentals.
- Action: "Get the 4-part course." Signup form.
**Segment 2: "Producing content but inconsistent results"**
- Recommendation: Content audit template + worked-example case study.
- Action: "Download the audit template." Direct download.
**Segment 3: "Scaling a content team"**
- Recommendation: Team-management playbook + interview with a content director.
- Action: "Read the playbook." Resource page with playbook and interview.
**Segment 4: "Optimizing for distribution"**
- Recommendation: Distribution-strategy framework + 5 worked examples.
- Action: "Read the framework." Resource page.
Each segment routes to a distinct content path matched to where the audience is.
---
## Worked example: readiness-assessment quiz
A consultancy offering readiness assessments before engagement.
**Segments and recommendations.**
**Segment 1: "Not yet ready"**
- Description: Foundation work needed before the consultancy's offering would help.
- Recommendation: Self-serve resources for foundation work. Honest acknowledgment that engagement is not warranted yet.
- Action: "Explore the foundation library." Free resources.
**Segment 2: "Ready for assessment"**
- Description: Foundation in place; specific gaps need addressing.
- Recommendation: 60-minute assessment call to identify specific engagement scope.
- Action: "Book the assessment call." Calendar link.
**Segment 3: "Ready for full engagement"**
- Description: Foundation in place; clear gaps; ready to engage.
- Recommendation: Direct engagement conversation.
- Action: "Talk to our partner." Direct contact.
**Segment 4: "Ongoing support"**
- Description: Already engaged, looking for continued partnership.
- Recommendation: Continuity-engagement options.
- Action: "Discuss your next phase." Direct contact.
The honest segmentation includes a "not yet ready" segment. This is honest and earns trust; not every taker should be sold to immediately.
---
## The "not for you" segment
Honest segmentation sometimes includes a segment that is not the brand's audience.
**The pattern.** A segment for takers who are not a fit. The recommendation acknowledges the lack of fit and offers something useful (a referral, a different brand's resource, a self-serve path).
**Why it works.**
- The taker who would have churned anyway leaves with respect for the brand.
- The brand earns "honest" reputation that compounds across audience segments.
- The unfit taker may refer fit takers later.
**The dishonest alternative.** Pretending every taker is a fit; routing everyone to a sales contact regardless of segment. Audiences that catch the dishonesty disengage.
---
## Recommendation freshness
Recommendations decay; the mapping needs maintenance.
**What decays.**
- Recommendations pointing to retired products.
- Recommendations referencing outdated pricing or features.
- Recommendations linking to broken pages or moved resources.
- Recommendations that no longer match the brand's strategic priorities.
**Maintenance cadence.** Quarterly review of every active recommendation. Update or replace as the brand's portfolio evolves.
**The drift indicator.** Sales-team feedback that quiz-sourced leads are landing on the wrong recommendation. The mapping has drifted; refresh.
---
## Recommendation testing
Test the recommendations as part of quiz launch and updates.
**Click-through testing.** What percentage of takers in each segment click the recommendation's CTA? Low click-through suggests the recommendation does not feel matched.
**Conversion testing.** What percentage of takers in each segment complete the recommended action (sign up, book a call, download the resource)? Low conversion suggests the recommendation does not deliver expected value.
**Feedback testing.** Direct user feedback ("does this recommendation feel right for you?"). Useful for early validation; rarely scalable.
---
## The recommendation-as-CTA discipline
The recommendation is also the call to action.
**The pattern.** The recommendation includes a specific button or link that takes the taker to the next step.
**Specific CTAs.**
- "Start your 30-day trial" (specific action, specific timeframe).
- "Book a 30-minute assessment call" (specific format, specific duration).
- "Download the audit template" (specific deliverable).
**Generic CTAs to avoid.**
- "Learn more" (about what?).
- "Get started" (started doing what?).
- "Click here" (no value statement).
The recommendation deserves a specific CTA matched to the action.
---
## Multi-recommendation results
Some quizzes produce multiple recommendations per segment.
**The pattern.** The result includes a primary recommendation and one or more secondary recommendations.
**When this works.** When the segment genuinely benefits from multiple paths (e.g., "you can start with X, or if you have specific need Y, consider Z instead").
**When this fails.** When multiple recommendations dilute the call to action; the taker does not know which to choose.
**The discipline.** Default to one primary recommendation. Add secondary recommendations only when the segment genuinely benefits from a choice.
---
## Common mapping failures
**Same recommendation across segments.** Different segments route to the same product or path; segmentation is decorative.
**Generic recommendations.** "Talk to our team" for every segment without segment-specific framing.
**Aspirational recommendations.** Recommendations for products or services not yet available; the taker tries the action and hits dead ends.
**Mismatched recommendations.** Recommendation does not match the segment's situation; takers feel unheard.
**Buried recommendations.** Recommendation appears 3 emails after the result rather than in the result itself.
**No clear CTA.** Recommendation describes what to do without providing the link or button to do it.
**No "not for you" segment.** Every taker routed toward sales; the audience that does not fit is treated as fitting; trust degrades.
---
## Methodology-level choices that stay in the public skill
The mapping principle and three requirements. Forms a recommendation can take. The mapping discipline (5 tests). Worked examples across quiz types. The "not for you" segment. Recommendation freshness. Recommendation testing. Recommendation-as-CTA discipline. Multi-recommendation results. Common failures.
## Implementation choices that stay internal
Specific segment-to-recommendation mappings for specific quizzes. Specific recommendation copy and CTAs in brand voice. Specific tracking for click-through and conversion per recommendation. The team's quarterly mapping audit calendar. These vary by team.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the work | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation code | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |