Skip to main content
GitHub Repository: scoutqa-dot-ai/claude-code
The Scout skill for Claude Code brings vibe testing to your AI coding workflow. Ask Claude to test your web applications using natural language commands - no test scripts, no complex setup.

​
What is Vibe Testing with Claude Code?

Vibe testing is a new approach to software testing where you describe what to test in plain English, and AI handles the execution. With the Scout skill installed in Claude Code, you can:
  • Ask Claude to “test the login flow” and get real results
  • Run accessibility audits by saying “check WCAG compliance”
  • Validate user journeys without writing a single test script
This is testing for the AI-assisted development era - as fast and fluid as vibe coding itself.

​
Features

Natural Language Testing

Describe tests conversationally. “Test the checkout flow” or “Find accessibility issues on the homepage.”

Accessibility Audits

Automatically identify WCAG compliance issues and accessibility barriers.

User Flow Validation

Verify critical journeys like signup, login, checkout, and onboarding work correctly.

Usability Analysis

Detect UX friction, confusing interfaces, and potential user frustrations.

​
Installation

​
Prerequisites

First, install the Scout CLI: 
npm install -g @scoutqa/cli@latest
scoutqa auth login

​
Add the Skill to Claude Code

# Add the Scout marketplace
claude plugin marketplace add https://github.com/scoutqa-dot-ai/claude-code

# Install the Scout skill
claude plugin i scoutqa-plugin@scoutqa-marketplace

​
Usage

Once installed, simply ask Claude to run tests: 
Test the login flow on https://staging.myapp.com
- Try valid credentials
- Try invalid credentials
- Check error messages are helpful

​
Example Workflow

You: Test the user registration on https://staging.myapp.com/signup

Claude: I'll run exploratory tests on the signup flow. Starting Scout...

[Scout executes tests]

Claude: Here's what I found:

Issues Detected:
1. Email validation accepts invalid formats (high severity)
2. Password requirements not clearly displayed (medium)
3. Missing aria-label on submit button (accessibility)

Recommendations:
- Add regex validation for email field
- Display password requirements before user types
- Add aria-label="Create account" to submit button

​
Troubleshooting

IssueSolution
Skill not foundRun claude plugin list to verify installation
Authentication errorsRun scoutqa auth login to re-authenticate
Tests failing to startVerify target URL is publicly accessible
For debugging, run: 
claude --debug
scoutqa --version

​
Why Use Vibe Testing with Claude Code?

Traditional TestingVibe Testing with Scout
Write and maintain test scriptsDescribe tests in natural language
Brittle selectors break oftenAI adapts to UI changes
Limited to predefined scenariosExploratory - finds unexpected issues
Requires testing expertiseAnyone can write tests

​
Frequently Asked Questions

A Claude Code skill is a plugin that extends Claude’s capabilities. The Scout skill adds vibe testing functionality, allowing Claude to run real tests on your web applications when you ask.
When you ask Claude to test something, the Scout skill executes AI-powered exploratory tests on your target URL. Scout’s agent navigates your app, performs actions, checks for issues, and reports findings back to Claude - who then summarizes results for you.
Yes! Scout performs WCAG accessibility audits. Just ask Claude to “check accessibility” or “audit for WCAG compliance” on any URL.
Scout requires publicly accessible URLs. For localhost testing, use a tunneling service like ngrok to expose your local server, then test using the tunnel URL.
The Scout CLI is a standalone terminal tool. The Claude Code skill integrates Scout directly into your Claude Code workflow, so you can test without leaving your conversation with Claude.
Scout requires a publicly accessible URL to run tests. Deployed environments like staging and production work immediately.For localhost testing, use a tunneling service like ngrok:
# Start your app, then create a tunnel
ngrok http 3000
Then ask Claude to test using the ngrok URL:
Test the login flow on https://abc123.ngrok.io
*Third-party tunneling services are not affiliated with Scout. Use at your own risk.