> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scoutqa.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Claude Code Skill - Vibe Testing Integration

> Vibe testing integration for Claude Code - test web apps using natural language directly from your AI coding assistant.

<Info>
  **GitHub Repository**: [scoutqa-dot-ai/claude-code](https://github.com/scoutqa-dot-ai/claude-code)
</Info>

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

<CardGroup cols={2}>
  <Card title="Natural Language Testing" icon="comments">
    Describe tests conversationally. "Test the checkout flow" or "Find accessibility issues on the homepage."
  </Card>

  <Card title="Accessibility Audits" icon="universal-access">
    Automatically identify WCAG compliance issues and accessibility barriers.
  </Card>

  <Card title="User Flow Validation" icon="route">
    Verify critical journeys like signup, login, checkout, and onboarding work correctly.
  </Card>

  <Card title="Usability Analysis" icon="lightbulb">
    Detect UX friction, confusing interfaces, and potential user frustrations.
  </Card>
</CardGroup>

## Installation

### Prerequisites

First, install the Scout CLI:

```bash theme={null}
npm install -g @scoutqa/cli@latest
scoutqa auth login
```

### Add the Skill to Claude Code

```bash theme={null}
# 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:

<Tabs>
  <Tab title="Login Flow">
    ```
    Test the login flow on https://staging.myapp.com
    - Try valid credentials
    - Try invalid credentials
    - Check error messages are helpful
    ```
  </Tab>

  <Tab title="Accessibility">
    ```
    Run an accessibility audit on https://myapp.com/signup
    Check for WCAG 2.1 AA compliance
    ```
  </Tab>

  <Tab title="Smoke Test">
    ```
    Run a quick smoke test on https://staging.myapp.com
    Verify the homepage loads and main navigation works
    ```
  </Tab>

  <Tab title="Checkout">
    ```
    Test the checkout process on https://myapp.com
    Add items to cart, go through checkout, verify order confirmation
    ```
  </Tab>
</Tabs>

## 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

| Issue                  | Solution                                        |
| ---------------------- | ----------------------------------------------- |
| Skill not found        | Run `claude plugin list` to verify installation |
| Authentication errors  | Run `scoutqa auth login` to re-authenticate     |
| Tests failing to start | Verify target URL is publicly accessible        |

For debugging, run:

```bash theme={null}
claude --debug
scoutqa --version
```

## Why Use Vibe Testing with Claude Code?

| Traditional Testing             | Vibe Testing with Scout               |
| ------------------------------- | ------------------------------------- |
| Write and maintain test scripts | Describe tests in natural language    |
| Brittle selectors break often   | AI adapts to UI changes               |
| Limited to predefined scenarios | Exploratory - finds unexpected issues |
| Requires testing expertise      | Anyone can write tests                |

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="What is a Claude Code skill?">
    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.
  </Accordion>

  <Accordion title="How does vibe testing work in Claude Code?">
    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.
  </Accordion>

  <Accordion title="Can I use this for accessibility testing?">
    Yes! Scout performs WCAG accessibility audits. Just ask Claude to "check accessibility" or "audit for WCAG compliance" on any URL.
  </Accordion>

  <Accordion title="Does this work with localhost?">
    Scout requires publicly accessible URLs. For localhost testing, use a tunneling service like [ngrok](https://ngrok.com/our-product/secure-tunnels) to expose your local server, then test using the tunnel URL.
  </Accordion>

  <Accordion title="What's the difference between this and the Scout CLI?">
    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.
  </Accordion>
</AccordionGroup>

## Related

* [Scout CLI](/tooling/cli) - Run Scout from any terminal
* [Cursor Rules](/tooling/cursor-rules) - Use Scout in Cursor IDE
* [Kiro Power](/tooling/kiro-power) - Use Scout in Kiro IDE

***

<AccordionGroup>
  <Accordion title="Testing localhost applications">
    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](https://ngrok.com/our-product/secure-tunnels):

    ```bash theme={null}
    # 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.
  </Accordion>
</AccordionGroup>