firecrawl-qa

Goes over a live website hunting for what's broken, and writes up every problem it finds with the exact steps to see it happen yourself, worst first.

WHEN TO USE

SCOPE

USE FOR

Run an exploratory QA pass before launching a site.
Check a site's forms end-to-end, including edge cases and validation.
Test navigation and links across a site for broken paths.
Compare a page's load performance against an earlier version.

This is a saved copy of the skill's SKILL.md instructions. It may differ from the upstream file or the version you install.

In this document (6)

Firecrawl QA

Use this to test a live site and return a unified QA report.

Onboarding Interview

Infer the URL, QA focus, and output format from context. If the target URL is clear, proceed immediately.

Ask at most 1-3 concise questions only if blocked, such as the URL, the focus area, or credentials/constraints for protected flows.

Firecrawl Collection Plan

Use Firecrawl map to discover pages. Use Firecrawl browser for interactions, forms, navigation, and responsive/manual checks when available. Use scrape for page content and link extraction.

Parallel Work

If appropriate, use sub-agents or equivalent parallel task runners:

Full: Navigation and Links, Forms and Interactions, Content and Visual, Error States.
Forms: Form Discovery, Happy Path, Edge Cases, Validation.
Navigation: Sitemap, Nav Testing, Link Checker, Routing.
Responsive: Desktop, Tablet, Mobile, Interaction.
Performance: Page Load, Asset Audit, Content Efficiency, Comparison.

Each tester should return severity, URL, description, evidence, and reproduction steps.

Final Deliverable

# QA Report: [Site]

## Summary
- Health score: [x/10]
- Pages tested: [count]
- Issues found: [critical/major/minor]

## Critical Issues
[C-1] URL | Description | Steps to reproduce | Expected vs actual

## Major Issues
[M-1] URL | Description | Steps to reproduce

## Minor Issues
[m-1] URL | Description

## Positive Observations
[What works well]

## Pages Tested
[URLs]

## Agent/Test Summary
[Who tested what]

## Rerun Inputs
workflow: firecrawl-qa
url: [url]
focus: [full/forms/navigation/responsive/performance]

Quality Bar

Include reproduction steps for functional issues.
Do not report speculative bugs without evidence.
Deduplicate findings across testers.

Account or credentials required

1 FOR YOU

01
Add your Firecrawl API key
Get an API key from firecrawl.dev and set it as FIRECRAWL_API_KEY so the workflow can run the hosted Firecrawl map, browser, and scrape calls used to test the live site.
You set: FIRECRAWL_API_KEY

Listed as free: Connected services may require an account or charge fees.
Setup details: Expect some account or credential setup.

This skill ships inside the Firecrawl Workflows plugin.

Needs the Firecrawl CLI or MCP server. Set that up first — this skill doesn't include it.

Install just this skill

Run this outside your AI tool, using Node.js 22.20.0 or newer. Skills CLI 1.7.2 skips skill selection; prompts cancel installation without an interactive terminal. If choosing Project when asked about installation scope, open your project's folder before running this.

Install checklist

Check selected tools if a picker appears; Claude Code may be unchecked under Additional agents. ↑/↓ moves, Space toggles selections, Enter confirms.
Without a tool picker, check Installing to: for your intended tool. Stop if it names a different tool.
If asked, choose Symlink (Recommended) for shared files or Copy to all agents for separate copies; review the summary before confirming installation.
Install the find-skills skill? defaults to Yes, adding another skill for all projects. Choose No if you don't want that extra installation.

Skills CLI 1.7.2 sends install data to skills.sh by default, including the source, skill names, target tools and file details; GitHub sources are reported only when GitHub confirms the repository is public, while other remote sources can also be reported. Confirmed-public GitHub sources also trigger a security-audit request. Before installing, set the environment variable DO_NOT_TRACK=1 or DISABLE_TELEMETRY=1 to disable both.

npx skills add firecrawl/firecrawl-workflows --skill "firecrawl-qa" --full-depth

After installing for Claude Code, open it in the installation project if you chose Project; Global makes the skill available across projects on this computer. Once Claude Code loads the skill, its description helps Claude decide when to use it.

If installation created a top-level skills folder that did not exist when your Claude Code session started, run /reload-skills in that session. Run it again after later changes in that folder.

Install the whole plugin

This route installs the Firecrawl Workflows plugin package selected for your AI tool.

PLUGIN MARKETPLACE

Add the marketplace, then install the plugin

Typed inside the agent's own prompt, not in a terminal. The marketplace is called firecrawl-workflows, which is the part after the @.

/plugin marketplace add firecrawl/firecrawl-workflows

/plugin install firecrawl-workflows@firecrawl-workflows

Open plugin page ↗

What's inside

Files included with this skill.

View on GitHub