User Testing Agent
A Claude Code plugin that simulates realistic user personas for UX testing. The agent embodies different user archetypes with authentic behaviors, timing patterns, and frustration triggers to identify usability issues before real users encounter them.
Features
- 25 Personas across 6 categories with gender variants (75 total personalities)
- Multi-Persona Testing to compare experiences across user types
- Session Recording with Playwright Trace export
- A/B Testing to compare URL variants
- Mobile/Tablet/Desktop viewport testing
- Network Throttling (slow-3g, fast-3g, offline)
- WCAG Audit with compliance scoring
- Cookie Consent Audit for GDPR/CCPA compliance
- Form Fuzzing for security testing (XSS, SQLi, unicode)
- Stripe Checkout Testing with official test cards
- GitHub PR Comments for CI/CD integration
- JSON Export for pipeline automation
Quick Start
Prerequisites
- Claude Code CLI (v2.0.73+)
- Claude in Chrome extension (v1.0.36+)
- Google Chrome browser
Installation
# In Claude Code
/plugins
# Select "Add Marketplace" and enter:
ncklrs/claude-chrome-user-testing
Basic Usage
# Start Claude with Chrome
claude --chrome
# Run a user test
/user-test --url https://example.com --persona genz-digital-native
# With tasks
/user-test --url https://shop.example.com --persona boomer-tech-averse --tasks "find product, checkout"
Available Personas
| Category | Personas |
|---|
| Generational | boomer-tech-averse, boomer-tech-friendly, millennial-tech-skeptic, genz-digital-native, genalpha-tablet-kid |
| Accessibility | screen-reader-user, low-vision-user, keyboard-only-user, cognitive-adhd-user |
| Professional | busy-executive, developer-critic, designer-critic, support-agent |
| Context | bad-connection-user, distracted-parent, non-native-english, power-user |
| Shopping | comparison-shopper, impulse-buyer, return-customer, gift-buyer |
| International | german-business-user, japanese-user, arabic-rtl-user, brazilian-user |
See docs/personas.md for detailed persona documentation.
Commands
| Command | Purpose |
|---|
/user-test | Main testing command with all options |
/stripe-test | Dedicated Stripe checkout testing |
/ab-test | Compare two URL variants |
/smoke-test | Quick validation with presets |
/critical-path | Test must-work journeys |
/check-links | Find broken links |
/wcag-audit | WCAG 2.1 accessibility audit |
/cookie-audit | GDPR/CCPA compliance audit |
/user-test-create-persona | Create custom personas |
See docs/commands.md for full command reference.
Common Examples
# Multi-persona comparison
/user-test --url https://example.com --personas "boomer-tech-averse,genz-digital-native" --quiet
# Mobile + slow network
/user-test --url https://example.com --persona impulse-buyer --viewport mobile --network slow-3g
# Stripe checkout testing
/stripe-test --url https://shop.example.com/checkout --card success
# A/B testing
/ab-test --url-a https://example.com --url-b https://staging.example.com --persona genz-digital-native
# Security fuzzing
/user-test --url https://example.com/signup --persona developer-critic --fuzz
# Cookie compliance
/cookie-audit --url https://example.com --regulation gdpr
# CI/CD with PR comment
/user-test --url https://staging.example.com --persona genz-digital-native --quiet --pr 123
CI/CD Integration
- name: Run User Tests
env:
ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
run: |
claude --chrome "/user-test \
--url ${{ env.PREVIEW_URL }} \
--persona genz-digital-native \
--quiet \
--output json \
--pr ${{ github.event.pull_request.number }}"
Documentation
- Personas - All 25 personas with behaviors and timing
- Commands - Full command reference
- Features - Detailed feature documentation
- Ralph Loop - Autonomous testing with Ralph Wiggum
Plugin Structure
user-testing-agent/
├── commands/ # Command definitions
├── agents/ # Testing agent
├── skills/ # Feature implementations
│ ├── user-testing/ # Personas and behaviors
│ ├── stripe-checkout/# Payment testing
│ ├── wcag-auditor/ # Accessibility audit
│ ├── cookie-auditor/ # Privacy compliance
│ ├── form-fuzzer/ # Security testing
│ └── ...
├── docs/ # Documentation
└── README.md
Contributing
See CONTRIBUTING.md for guidelines on adding personas.
License
MIT - See LICENSE
ncklrs