skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
2389-research/review-squad61 installs

regulars

Verifies that key user flows work end-to-end by having agents role-play real users completing site-specific tasks on a live site. Use before launch, after deploy, or after a refactor to confirm critical paths still work. Requires a running dev server and browser MCP tools.

How do I install this agent skill?

npx skills add https://github.com/2389-research/review-squad --skill regulars
view source ↗

Is this agent skill safe to install?

  • Gen Agent Trust Hubpass

    This skill is a website testing tool that simulates user personas to verify end-to-end flows. It is safe to use and includes explicit instructions to keep the agent focused on the browser environment and away from local source files.

  • Socketpass

    No alerts

  • Snykwarn

    Risk: MEDIUM · 1 issue

What does this agent skill do?

Regulars

Overview

Dispatch a panel of subagents, each role-playing a real user with a specific task to complete on the site. They navigate using browser MCP tools, attempt to complete their goal, and report what broke, what was frustrating, and whether they succeeded. The organizing principle is task completion — can users do what they came to do?

This is NOT a QA test suite or expert audit. Regulars agents behave like real users — they don't inspect source code, they don't check every element, and they don't follow a test matrix. They try to accomplish a goal the way a real person would.

Prerequisites

  • Running dev server — agents navigate a live URL; every task requires a real, accessible site.
  • Browser MCP tools — the claude-in-chrome (or equivalent) MCP server must be connected and configured for the target site. Without it, agents cannot click through flows or take screenshots.

When to Use

  • Before launch: "Does the site actually work end-to-end?"
  • After deploy: "Did we break any user flows?"
  • After refactor: "Can users still do the important things?"
  • Periodic check: "Are the critical paths still working?"

Workflow

digraph regulars {
  rankdir=TB;
  "User requests smoke test" -> "Identify key user tasks for this site";
  "Identify key user tasks for this site" -> "Present task panel with personas";
  "Present task panel with personas" -> "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 pass/fail + key issue";
  "After each: report pass/fail + key issue" -> "All done?";
  "All done?" -> "After each: report pass/fail + key issue" [label="no"];
  "All done?" -> "Compile results scorecard" [label="yes"];
}

Sequential dispatch required. Browser MCP tools share a single browser instance.

Designing the Task Panel

Unlike review-squad:experts (fixed default panel) or review-squad:normies (fixed sophistication spectrum), regulars tasks are site-specific. You must design them based on what the site does.

Step 1: Ask the user what the key user flows are, OR read the site's navigation/content to identify them.

Step 2: For each flow, create a persona with a goal:

ComponentExample
Name + personality"Sarah, a busy parent browsing on her phone during lunch break"
Goal"Find a birthday gift under $50 and add it to cart"
How they'd approach it"Scrolls fast, uses search if available, sorts by price"

Step 3: Present the panel to the user for approval.

Example Panels by Site Type

See references/example-panels.md for ready-made panels for personal blogs/portfolios, e-commerce sites, and SaaS/product sites.

Agent Prompt Template

You are [NAME], a [DESCRIPTION].
[1-2 sentences of personality and how you browse.]
You have come to this site to: [SPECIFIC GOAL].

Do NOT read any source code or project files. You are a real user.
Use the browser MCP tools to navigate the site at [URL].
[If mobile persona: First, set viewport to 375x812.]

YOUR TASK:
1. Navigate to [URL]. Take a screenshot.
2. Try to accomplish your goal: [GOAL].
3. Do what feels natural — click what looks right, search if you can,
   scroll where you'd scroll. Don't be methodical — be human.
4. Take a screenshot at each major step.
5. If something doesn't work (broken button, error page, dead end),
   try what a real person would try (back button, refresh, different path).
6. Test one unhappy path: [SPECIFIC EDGE CASE FOR THIS TASK].
7. When you've either completed your goal or given up, STOP.

Report as [NAME]:
- **Goal**: [restate the goal]
- **Result**: COMPLETED / PARTIALLY COMPLETED / FAILED
- **Steps Taken**: numbered list of what you did
- **Where It Broke**: exact moment something went wrong (if applicable)
- **Frustrations**: anything annoying even if it technically worked
- **Time to Complete**: rough estimate (fast / reasonable / painfully slow)
- **Would I Come Back?**: honest yes/no

Critical elements:

  • No-code guard — "Do NOT read any source code." Regulars are users, not developers.
  • Specific goal — Not "explore the site" but "find a gift under $50 and add it to cart."
  • One unhappy path per agent — Test what happens when things go wrong (invalid input, empty cart, back button mid-flow).
  • Human behavior — "Do what feels natural" not "follow this test script step by step."
  • Honest verdict — "Would I come back?" forces a real assessment.

Dispatch Pattern

Sequential, not parallel. Browser MCP shares a single browser instance.

After each agent, briefly report pass/fail + headline issue to the user.

Consolidating Results

Compile into a scorecard:

## Regulars Review: [Site Name]

### Scorecard

| # | Task | Persona | Result | Issues |
|---|------|---------|--------|--------|
| 1 | Find and read blog post | Blog reader | ✅ PASS | Minor: date format inconsistent |
| 2 | Subscribe to newsletter | Casual visitor | ❌ FAIL | Form returns 500 error |
| 3 | Find contact info | Old friend | ✅ PASS | |
| 4 | Browse photo gallery | Gallery visitor | ⚠️ PARTIAL | Lightbox doesn't close on mobile |
| 5 | Find RSS feed | RSS subscriber | ❌ FAIL | No visible RSS link anywhere |
| 6 | Navigate from shared link | Social visitor | ✅ PASS | |

### Result: 4/6 PASS, 1 PARTIAL, 1 FAIL

### Blockers (failed tasks)
| Task | What broke | Severity |
|------|-----------|----------|
| Newsletter signup | 500 error on form submit | CRITICAL |
| Find RSS feed | No RSS link discoverable | IMPORTANT |

### Friction (passed but painful)
| Task | What was frustrating |
|------|---------------------|
| Browse gallery | Lightbox close button too small on mobile |

### What Worked Well
- Blog reading flow is smooth end-to-end
- Contact info is easy to find
- Shared link landing experience is clean

After the Report

  1. Present the scorecard
  2. Blockers are the priority — tasks that completely failed
  3. Ask if the user wants to fix blockers now
  4. Friction items go on the backlog

Common Mistakes

  • Reading the code — Regulars don't know the codebase. Neither should the agents.
  • Generic tasks — "Browse the site" is not a valid task. Each agent needs a specific goal with a clear pass/fail.
  • Only happy paths — Real users hit edge cases. Each agent should test one unhappy path.
  • QA test scripts — "Click element #submit, verify response code 200" is a test script, not what regulars do. Agents should behave like humans.
  • Running in parallel — Browser MCP is a shared resource. Sequential only.
  • Using the same panel for every site — Tasks must match what THIS site offers. A blog doesn't need a "checkout flow" tester.

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/2389-research/review-squad/regulars">View regulars on skillZs</a>