Quiz
Verified@ivangdavila
npx machina-cli add skill @ivangdavila/quiz --openclawSituation Detection
| Context | Load |
|---|---|
| Knowledge assessment, exams, certifications | types.md → Knowledge section |
| Personality quizzes, "Which X are you?" | types.md → Personality section |
| Lead generation, marketing quizzes | types.md → Lead-gen section |
| Writing effective questions | questions.md |
| Building quiz UI/UX, gamification | implementation.md |
Universal Rules
One concept per question. Double-barreled questions confuse and measure nothing. "Do you like pizza and exercise?" → Bad.
Wrong answers must be plausible. If correct answer is obvious by elimination, you're testing pattern recognition, not knowledge.
Results must feel personal. Generic outcomes kill engagement. "You got 7/10" loses to "You're an 80s Movie Expert — you caught references most people miss."
Progress visibility motivates. Show question count, progress bar, time remaining. Uncertainty creates anxiety and abandonment.
Quiz Types Quick Reference
| Type | Goal | Typical Length | Results |
|---|---|---|---|
| Knowledge | Assess learning | 10-20 questions | Score + feedback per answer |
| Personality | Engagement, sharing | 5-12 questions | Personality type/category |
| Assessment | Diagnose level/fit | 10-30 questions | Detailed report |
| Lead-gen | Capture email | 5-8 questions | Results gated behind email |
| Trivia | Entertainment | Any | Leaderboard, social share |
Question Design Checklist
- Clear, unambiguous wording
- One correct answer (or explicit multi-select instruction)
- Distractors are plausible, not obviously wrong
- No "all of the above" or "none of the above" (lazy design)
- Avoid negatives ("Which is NOT...")
- Test the concept, not reading comprehension
Scoring Patterns
Simple percentage: Correct/total × 100. Best for knowledge tests.
Weighted scoring: Some questions worth more. Good for prioritized competencies.
Branching outcomes: Answer combinations map to results. Used in personality quizzes.
Diagnostic rubric: Score across multiple dimensions. Best for assessments and skill evaluations.
Engagement Boosters
- Immediate feedback after each answer (right/wrong + explanation)
- Visual progress indicator
- Streak rewards ("3 in a row!")
- Time pressure (optional, increases excitement but also anxiety)
- Social sharing of results
- Leaderboards for competitive contexts
Red Flags
- All correct answers in position B/C → Detectable pattern
- Questions testing obscure trivia vs actual learning objectives
- Results that don't connect to actions ("Now what?")
- Too long with no progress indication → Abandonment
- Mobile-unfriendly UI (tiny buttons, horizontal scroll)
When to Load More
| Situation | Reference |
|---|---|
| Designing for specific quiz type | types.md |
| Writing and reviewing questions | questions.md |
| Building quiz flow, UI, tools | implementation.md |
Overview
Quiz helps you design engaging assessments, lead-gen experiences, and personality tests with effective questions, scoring logic, and actionable results. It guides you from crafting questions to choosing scoring patterns and adding engagement boosters that drive learning and conversions.
How This Skill Works
Quiz enforces one concept per question, creates plausible distractors, and applies chosen scoring patterns (simple, weighted, branching, or diagnostic) to map responses to results. It also promotes engagement with progress indicators, immediate feedback, and validation via a question design checklist and practical UX considerations.
When to Use It
- Designing knowledge assessments, exams, or certifications
- Creating personality quizzes or 'Which X are you?' experiences
- Launching lead-generation quizzes to capture emails
- Writing and reviewing high-quality questions
- Building quiz flow, UI/UX, and gamification
Quick Start
- Step 1: Define the quiz objective (knowledge, personality, or lead-gen) and target audience
- Step 2: Design 5-12 questions with one concept per question and plausible distractors; avoid 'none of the above' or 'all of the above'
- Step 3: Choose a scoring pattern (simple, weighted, branching, or diagnostic) and implement progress indicators, instant feedback, and result delivery
Best Practices
- Ask one concept per question to avoid confusion
- Make distractors plausible and non-obvious
- Ensure results feel personal and actionable
- Show progress indicators and time cues to reduce anxiety
- Avoid lazy design such as 'all of the above' and ensure mobile-friendly UI
Example Use Cases
- An e-learning knowledge quiz with per-question explanations to reinforce learning
- A brand personality quiz that assigns a type and encourages sharing
- A marketing lead-gen quiz that gates results behind email submission
- A skills assessment using a diagnostic rubric across multiple dimensions
- A trivia quiz with a leaderboard and social sharing to boost engagement
