QA Test — Testing skill for Claude Code

qa-test

A Claude Code skill for automated front-end QA testing. It drives a real browser through Playwright MCP, testing your application the way a user would - clicking buttons, filling forms, navigating pages, and verifying that everything works.

What It Does

The qa-test skill gives Claude Code two personas and five testing modes to thoroughly test any web application through its UI:

• Quinn - A veteran QA engineer who methodically tests against your success criteria, documenting every pass and failure with screenshots
• Jinx - A chaos tester who receives only a URL and systematically tries to break everything, with no knowledge of how the app is "supposed" to work

Testing Modes

Mode	Flag	Description
Standard	(default)	Quinn tests against a provided success criteria file, verifying each criterion with screenshots and detailed reporting
Discovery	--discover	Quinn crawls the application, clicking through every nav item, sidebar link, and modal to build a complete page inventory
Adversary	--adversary	Jinx tries to break the app with extreme inputs, rapid clicks, navigation attacks, and viewport abuse
Full	--full	Runs all three modes in sequence: discover the site, test criteria, then try to break it
Parallel	--parallel	Spawns multiple agents with dedicated browser instances for large apps - Quinn agents test criteria concurrently while Jinx runs adversary testing

Installation

Copy the skill files to your Claude Code skills directory:

mkdir -p ~/.claude/skills/qa-test
cp SKILL.md SUCCESS-CRITERIA-TEMPLATE.md RESEARCH.md BEST-PRACTICES.md ~/.claude/skills/qa-test/

Or clone this repo directly:

git clone https://github.com/adampaulwalker/qa-test.git ~/.claude/skills/qa-test

MCP Dependencies

**Required:**

claude mcp add playwright -- npx @playwright/mcp@latest

**Recommended:**

claude m