From review-squad
Dispatches subagents role-playing users across tech sophistication spectrum to report first impressions, confusion, and friction on a site. Use before launch, redesigns, or new pages.
npx claudepluginhub 2389-research/claude-plugins --plugin review-squadThis skill uses the workspace's default tool permissions.
Dispatch a panel of subagents, each role-playing a person with a different level of tech sophistication, who land on a site with zero context. They report what they understand, what confuses them, and where they give up. The organizing principle is the **sophistication spectrum** — from expert to novice.
Generates design tokens/docs from CSS/Tailwind/styled-components codebases, audits visual consistency across 10 dimensions, detects AI slop in UI.
Records polished WebM UI demo videos of web apps using Playwright with cursor overlay, natural pacing, and three-phase scripting. Activates for demo, walkthrough, screen recording, or tutorial requests.
Delivers idiomatic Kotlin patterns for null safety, immutability, sealed classes, coroutines, Flows, extensions, DSL builders, and Gradle DSL. Use when writing, reviewing, refactoring, or designing Kotlin code.
Dispatch a panel of subagents, each role-playing a person with a different level of tech sophistication, who land on a site with zero context. They report what they understand, what confuses them, and where they give up. The organizing principle is the sophistication spectrum — from expert to novice.
This is NOT a technical review. The review-squad:experts skill handles code quality, SEO, accessibility compliance, etc. This skill answers: "Do real people understand my site?"
digraph normies {
rankdir=TB;
"User requests first-time review" -> "Present default persona panel";
"Present default persona panel" -> "Ask: add, remove, or adjust?";
"Ask: add, remove, or adjust?" -> "Finalize panel";
"Finalize panel" -> "Ensure dev server is running";
"Ensure dev server is running" -> "Dispatch agents sequentially";
"Dispatch agents sequentially" -> "After each: report key impression";
"After each: report key impression" -> "All done?";
"All done?" -> "After each: report key impression" [label="no"];
"All done?" -> "Compile confusion matrix + recommendations" [label="yes"];
}
Sequential dispatch required. Browser MCP tools share a single browser instance. Agents must run one at a time, not in parallel.
Present this spectrum to the user before dispatching. They may adjust.
| # | Persona | Sophistication | Patience | Gives up after |
|---|---|---|---|---|
| 1 | Senior Developer | Expert | Low — notices every flaw | 30 seconds of confusion |
| 2 | Product Manager | High | Medium — goal-oriented, wants to "get it" fast | 45 seconds without clarity |
| 3 | College Student | Medium — digital native, low effort | Very low — scrolls fast, judges visually | 10 seconds of boredom |
| 4 | Small Business Owner | Medium — uses web daily, not technical | Low — busy, needs answers NOW | 60 seconds without finding what they need |
| 5 | Retired Teacher | Low — reads carefully, confused by jargon | High — will try, but gives up when lost | 2 minutes of confusion |
| 6 | Someone's Grandparent | Minimal — icons are meaningless, jargon is alien | Very high — wants to understand, easily defeated | First moment of real confusion |
Suggest additions based on the site's audience. If the site targets developers, add a junior dev. If it's a restaurant, add a hungry person on their phone. Match the personas to who will actually visit.
Every agent prompt MUST follow this structure:
You are [NAME], a [AGE]-year-old [OCCUPATION/DESCRIPTION].
[2-3 sentences of personality and web behavior.]
You have NEVER seen this site before. You know NOTHING about it.
Do NOT read any source code or project files. You are a visitor, not a developer.
If browser MCP tools are available, use them to visit the site at [URL].
YOUR EXPERIENCE:
1. Navigate to [URL]. Take a screenshot.
2. In the first [TIME LIMIT] seconds, answer: What is this site about?
If you can't tell, say so honestly.
3. Try to find [SOMETHING RELEVANT TO THIS PERSONA].
4. Navigate wherever feels natural to you. Take screenshots.
5. Note every moment you feel confused, lost, or unsure what to do.
6. Note every piece of jargon or text you don't understand.
7. When you would give up in real life, STOP. Say why.
Write your report IN CHARACTER as [NAME]. Be honest. Structure it as:
- **First Impression** (what I saw and thought in the first 5 seconds)
- **What I Think This Site Is About** (honest interpretation)
- **Where I Got Confused** (every point of friction, in order)
- **Where I Gave Up** (what finally stopped me, or "I didn't")
- **What I Couldn't Find** (things I wanted but couldn't locate)
- **Words I Didn't Understand** (jargon list)
- **What I Liked** (be fair)
Critical elements:
Sequential, not parallel. Browser MCP shares a single browser instance.
Agent 1 (Senior Developer) → collect report
Agent 2 (Product Manager) → collect report
...
Agent 6 (Grandparent) → collect report
After each agent completes, briefly share the headline impression with the user before moving to the next.
After all personas report, compile a confusion matrix:
## Normies Review: [Site Name]
### Confusion Matrix
| Issue | Dev | PM | Student | Business | Retired | Grandparent |
|-------|:---:|:--:|:-------:|:--------:|:-------:|:-----------:|
| Can't tell what site is about | | | ✗ | ✗ | ✗ | ✗ |
| Can't find contact info | | | | ✗ | ✗ | ✗ |
| Jargon in hero text | | | | ✗ | ✗ | ✗ |
| Hamburger menu not recognized | | | | | | ✗ |
### Severity (by how many personas hit it)
- **6/6 or 5/6** → CRITICAL — nearly everyone is confused
- **3/6 or 4/6** → IMPORTANT — most non-technical visitors struggle
- **1/6 or 2/6** → MINOR — only edge cases
### Recommendations (prioritized)
| Priority | Issue | Who's confused | Suggested fix |
|----------|-------|---------------|---------------|
| 1 | ... | 5/6 personas | ... |
| 2 | ... | 3/6 personas | ... |
The confusion matrix is the key deliverable. It shows at a glance which problems are universal vs. which only affect certain sophistication levels.