# ThinkFizz Brand Review Skill

## Purpose
Use this skill to review any ThinkFizz output — copy, UI design, code, or content — against brand standards. Returns a structured pass/fail/note report.

## How to Use
Provide the content to review and specify the review type:
- `voice` — Does the copy sound like ThinkFizz?
- `visual` — Does the design match the visual system?
- `content` — Is the educational content accurate and appropriately framed?
- `full` — All of the above.

## Voice Review Checklist

### Must Pass
- [ ] Written in second person ("you") or active narrative voice
- [ ] No passive voice constructions ("it was discovered that…")
- [ ] No academic framing ("learning objectives", "upon completion", "it should be noted")
- [ ] No unexplained jargon — every technical term has immediate plain-English payoff
- [ ] Opens with a hook, question, or surprising fact — not a definition
- [ ] Sentences are short and punchy (aim for avg < 20 words per sentence)
- [ ] Contractions used naturally (it's, you'll, that's, here's)

### Should Pass
- [ ] Celebrates the Aha! moment somewhere in the piece
- [ ] Numbers used for impact where relevant ("100 billion neurons" not "many neurons")
- [ ] Ends with a tease, a new question, or a feeling of "now you know something cool"
- [ ] Tone calibrated to context (see `brand-voice.md` tone table)

### Red Flags — Immediate Revision Required
- Uses "please proceed", "module", "learning objectives", "deliverables", "utilize"
- Addresses reader as "students" or "users" instead of "you"
- Longer than needed — if it can be shorter, it should be
- Summarizes itself at the end instead of leaving a hook
- Sounds like a Wikipedia article

## Visual Review Checklist

### Colors
- [ ] Uses only brand palette (Coral/Green/Violet/Amber/Blue/Spark/Ink/Cloud)
- [ ] Max 3 brand colors per component
- [ ] Coral reserved for primary CTA only
- [ ] Text contrast meets WCAG AA (4.5:1 body, 3:1 large)
- [ ] Dark backgrounds use white logo variant

### Typography
- [ ] Headings in Fredoka 600
- [ ] Body and UI in Nunito Sans
- [ ] No other fonts introduced without explicit approval
- [ ] Type scale follows 8px base grid

### Shape & Layout
- [ ] Cards use 12px radius
- [ ] Buttons use 8px radius
- [ ] Spacing uses multiples of 8px
- [ ] Logo has adequate clear space (one bubble height on all sides)

### Logo
- [ ] Not stretched, rotated, or recolored
- [ ] Correct variant for background (color/black/white)
- [ ] Symbol-only used when width < 120px
- [ ] No drop shadow applied to logo

### Motion (if applicable)
- [ ] Durations 200–400ms
- [ ] Spring easing for delight moments
- [ ] Motion never blocks user interaction

## Content Accuracy Review

### For Educational Content
- [ ] Facts are verifiable from multiple authoritative sources
- [ ] Dates, names, measurements are precise
- [ ] Nuance acknowledged where the "simple" version is misleading
- [ ] Sources or confidence level noted in metadata (even if not shown to user)

### Framing
- [ ] Content framed as discovery, not instruction
- [ ] Difficulty level appropriate for general adult audience
- [ ] Cultural sensitivity considered for history/geography content

## Review Output Format

When reviewing, return structured feedback:

```
## Brand Review: [Content Title]
**Type:** voice | visual | content | full
**Overall:** ✅ Pass | ⚠️ Pass with notes | ❌ Needs revision

### Voice
- ✅ Strong hook opener
- ✅ Active voice throughout
- ⚠️ "It has been shown that" — revise to active (line 3)
- ❌ Jargon "photosynthesis" used without immediate plain-English payoff

### Visual (if applicable)
- ✅ Correct font pairing
- ❌ Button radius is 4px, should be 8px

### Suggested Revisions
[Specific line-by-line suggestions]
```

## Common Quick-Fix Patterns

| ❌ Original | ✅ ThinkFizz |
|---|---|
| "It has been discovered that…" | "Scientists found something wild:…" |
| "Learning objective: understand X" | "By the end, you'll see X in a whole new way." |
| "Please note that…" | "Here's the catch:" |
| "Various studies indicate…" | "Study after study shows…" / "The data is clear:" |
| "Students will explore…" | "You're about to find out…" |
| "In conclusion…" | *(delete — end on a hook instead)* |
| "Utilize" | "Use" |
| "Furthermore" | "And here's where it gets interesting:" |
| "It is important to note" | "This is the part that trips everyone up:" |