Skip to main content
ClaudeWave
Skill333 repo starsupdated today

quiz-and-assessment-design

This Claude Code skill provides a framework for designing quizzes and assessments that segment audiences into actionable categories with specific recommendations, rather than generating engagement without qualified leads. Use it when scoping a new quiz or assessment, auditing existing quizzes that produce clicks but no qualified leads, designing result categories and recommendation matching, or deciding whether a quiz is the right format to drive a specific business outcome.

Install in Claude Code
Copy
git clone --depth 1 https://github.com/rampstackco/claude-skills /tmp/quiz-and-assessment-design && cp -r /tmp/quiz-and-assessment-design/dist/pi/.agents/skills/quiz-and-assessment-design ~/.claude/skills/quiz-and-assessment-design
Then start a new Claude Code session; the skill loads automatically.

SKILL.md

# Quiz and Assessment Design

A senior growth practitioner's playbook for designing quizzes and assessments that produce actionable segmentation rather than generating clicks for clicks' sake. Question architecture, scoring algorithms, result categorization, recommendation mapping. The discipline of building a quiz the audience actually uses to make a decision.

Most quizzes on the web are clickbait. "What kind of pizza are you?" energy applied to brand-building, with results that flatter the taker but drive no specific next step. The quiz captures emails because the format implies fun; the leads are unqualified because the result told them nothing they could act on.

The quizzes that work as compounding assets do something different. They categorize the taker into a defined segment with a specific recommendation matched to that segment. The taker comes away knowing what to do next, not just what they are. The brand becomes the source of the recommendation the audience acted on.

This skill is one of the specific lead-magnet types covered as its own skill. The parent-frame methodology lives in `lead-magnet-design`; the quiz-specific methodology (scoring algorithms, result categorization, recommendation matching) lives here.

The voice is the senior growth practitioner who has watched quizzes earn long-term subscribers and watched them produce engagement metrics with no downstream impact. Practical, opinionated about the difference between fun-quiz and decision-quiz, willing to call out when a quiz is the wrong format for the goal.

When to use this skill: scoping a quiz or assessment for the first time, auditing a quiz that produces engagement but no qualified leads, designing the result categories that drive specific recommendations, or deciding which inputs warrant the lead-capture step.

---

## What this skill covers

This skill spans quiz and assessment design as one specific lead-magnet type. The growth-tooling distinctions:

- `lead-magnet-design` is the parent-frame methodology. Quizzes are one specific lead-magnet type.
- `calculator-design` is a sister tool type. Calculators give numbers; quizzes give categories. The methodology differs.
- **`quiz-and-assessment-design` (this skill)** is quiz-specific methodology (question architecture, scoring algorithms, result categorization, recommendation matching).
- `discovery-research-synthesis` is customer-research synthesis (this skill is user-facing assessment, not internal research).
- `landing-page-copy` is the quiz landing page (downstream of quiz design).

The audience: growth marketers, product marketers, content marketers, agencies running quiz-based growth tooling for clients.

Out of scope: lead-magnet design at the parent-frame level (covered by `lead-magnet-design`); calculator design (covered by `calculator-design`); landing-page copy (covered by `landing-page-copy`); the engineering implementation of the quiz (handed off via `pm-spec-writing`).

---

## The quiz/assessment decision: when this format earns investment

Before designing the quiz, decide whether a quiz is the right tool for the audience and the goal.

**Quizzes earn investment when:**

- 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; 30 questions stops being a quiz and becomes a survey.
- The brand has a portfolio of recommendations that match the segments. A quiz that produces 5 segments and only one recommendation does not justify the format; 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; audiences who do not (technical buyers, enterprise) often see quizzes as gimmicks.

**Quizzes do NOT earn investment when:**

- The categorization is trivial. "What plan is right for you" with two plans does not need a quiz; a comparison table works.
- The categorization is irrelevant to the next step. A personality quiz with no product-recommendation tie-in entertains but does not convert.
- The brand has no varied recommendations. A quiz with one outcome is bait; the segmentation is decorative.
- The audience disrespects quizzes in this context. Enterprise buyers often see quizzes as unprofessional; the format choice has to fit the audience.

The decision is not "should we have a quiz"; it is "is the quiz the right next investment for this specific audience and decision."

Detail in [`references/quiz-investment-criteria.md`](references/quiz-investment-criteria.md).

---

## Clickbait-quiz vs vanity-result vs actionable-segmentation

The keystone framing.

**Clickbait-quiz.** "What kind of pizza are you?" energy. Generates engagement (shares, comments, brief virality), segments nothing useful. Fun but not strategic. Cost: the engagement metric looks fine; the leads have no qualification signal because the quiz did not reveal anything actionable about them.

**Vanity-result.** Elaborate-feeling result that flatters the taker but does not drive any specific next step. "You are an INTJ visionary entrepreneur" with a description that reads like horoscope, no actionable follow-up. Cost: the taker enjoyed the result, did not act on it, did not return. The quiz produced a moment of attention, not a relationship.

**Actionable-segmentation.** Result places the taker into a defined category with a specific recommendation matched to that category. The result tells them what to DO next, not just what they ARE. The category and the recommendation are the value; the taker comes away with a next step.

The litmus test. After taking the quiz, can a stranger in the target audience name the next thing they should do? Can they describe the recommendation matched to their resul
accessibility-auditSkill

Run a comprehensive WCAG accessibility audit covering perceivable, operable, understandable, and robust principles. Use this skill whenever the user wants to audit accessibility, review WCAG compliance, fix accessibility issues, prepare for accessibility certification, address an accessibility lawsuit risk, or systematically improve a site's accessibility. Triggers on accessibility audit, WCAG audit, a11y audit, accessibility compliance, ADA compliance, screen reader test, keyboard navigation, accessibility report, fix accessibility, axe scan. Also triggers when accessibility issues have been reported and need systematic remediation.

ads-creative-developmentSkill

How to produce ad creative that converts at performance scale. Hook patterns, format selection, video pacing, variation systems, sequential testing methodology, fatigue detection, brand-voice alignment without conversion dilution, and platform-specific creative norms. Triggers on ad creative, ad design, hook patterns, ad video pacing, creative testing, ad variations, creative refresh, creative fatigue, refresh ad creative, video ads for Meta, TikTok creative, LinkedIn ad creative, ad asset library. Also triggers when a team is producing creative at scale, planning a creative test cycle, or auditing why creative is not converting.

ads-performance-analyticsSkill

How to read paid media dashboards without fooling yourself. Attribution models, platform reporting quirks, multi-platform reconciliation, ROAS vs LTV horizon traps, statistical noise in performance metrics, incrementality testing, and the failure modes that produce expensive lessons. Triggers on read paid media dashboard, attribution analysis, ROAS vs LTV, multi-platform reconciliation, ad incrementality, geo holdout, conversion lift study, ghost bidding, paid media reporting, board-deck paid media metrics, blended CAC, MMM, MTA, last-click attribution. Also triggers when a marketer is about to scale, kill, or rebudget a campaign based on platform metrics, or when reconciling platform reports against warehouse revenue.

after-action-reportSkill

Run a structured after-action review (postmortem, retrospective) on a launch, incident, or completed project to capture timeline, root cause analysis, contributing factors, and actionable lessons. Use this skill whenever the user wants to run a postmortem, retrospective, AAR, or after-action review on any past event. Triggers on after-action report, AAR, postmortem, retrospective, retro, post-incident review, what went well what didn't, lessons learned, blameless postmortem, root cause analysis, RCA, five whys. Also triggers when the user has just shipped something or just resolved an incident and wants to capture learnings.

ai-content-collaborationSkill

How humans and AI compose in content workflows. Where AI legitimately participates, where humans must own, hybrid workflow patterns, voice ownership preservation, the AI slop problem, disclosure and transparency, team calibration, and the ethics of intellectually honest AI-assisted content production. Triggers on AI content workflow, AI-assisted writing, hybrid content production, AI in editorial, AI slop, AI disclosure, AI usage policy, AI content ethics, voice preservation with AI, team AI calibration. Also triggers when content feels generic despite quality tools, when team AI usage has drifted into inconsistency, or when a regulated or trust-sensitive context requires explicit AI policy.

analytics-strategySkill

Design measurement frameworks including event taxonomy, KPI hierarchy, dashboard architecture, attribution models, and analytics implementation strategy. Use this skill whenever the user wants to plan analytics, design dashboards, build event taxonomies, define KPIs, set up tracking, or audit existing measurement. Triggers on analytics strategy, measurement plan, event taxonomy, tracking plan, KPI framework, dashboard design, north star metric, attribution model, conversion tracking, GA4 setup, Mixpanel setup, analytics audit. Also triggers when the user has data but no clear way to use it, or wants to make decisions but doesn't know what to track.

art-directionSkill

Direct visual and creative work for campaigns, photography, illustration, video, and branded experiences. Use this skill whenever the user wants to brief a photographer, direct illustrators, plan a creative campaign, develop visual concepts, write a creative direction document, or evaluate creative work for fit. Triggers on art direction, photo brief, photography brief, illustration brief, campaign concept, creative concept, visual direction, mood board, look and feel, visual treatment, video direction. Also triggers when the user has approved brand identity but needs to extend it into specific creative deliverables.

backup-and-disaster-recoverySkill

Plan and run backups, set recovery objectives, and run disaster recovery drills. Use this skill when defining RPO/RTO targets, designing backup architecture, deciding what to back up and how often, planning for full-region or platform outages, or running a restoration drill. Triggers on backup, restore, RPO, RTO, disaster recovery, DR, business continuity, what if the database is gone, what if our hosting goes down, recovery drill, ransomware planning. Also triggers when an incident reveals a gap in restoration capability.