firecrawl-demo-walkthrough — Claude Code skill: what it does
Walks an agent through a product's main flows in the Firecrawl browser and returns a markdown walkthrough of screens, actions and friction points.
npx skills add firecrawl/firecrawl-workflows --skill firecrawl-demo-walkthrough -a claude-codeWhat firecrawl-demo-walkthrough does
The skill drives an agent through a product step by step. It opens pages in the Firecrawl browser, snapshots each state, and records what a user sees and can do there. The deliverable is a markdown report: product overview, a walkthrough per flow, key findings, recommendations, and every page visited.
When the product address is already clear from the conversation, it starts right away. Otherwise it asks up to three short questions: the address, the flow to focus on, and credentials for protected areas. Big jobs get split across parallel sub-agents covering homepage, signup and onboarding, pricing, docs, dashboard, and support. Each one reports screens, actions, observations and friction. Observation stays separate from opinion; that is written into the quality bar.
You need FIRECRAWL_API_KEY for hosted Firecrawl requests, so add it before the first run. Signups, purchases and irreversible actions are off limits unless you explicitly allow them and have the rights, which means the account area and checkout are yours to open. Worth deciding upfront which steps the agent may touch.
What it helps with
- walk the signup and onboarding of a product screen by screen
- pull together material for a product demo
- read a pricing page the way a newcomer would
- spot friction in a first-run experience
- turn the whole tour into one markdown report with recommendations
Example prompts for the agent
- Walk the product flows: homepage, signup, pricing, dashboard. Snapshot each step and write the report in markdown.
- Do a UX teardown of onboarding and docs, keep observations apart from opinions.
- Cover pricing only, leave the rest alone: set focus: pricing in the rerun inputs.
How to install firecrawl-demo-walkthrough
1Skills CLI (Vercel)
npx skills add firecrawl/firecrawl-workflows --skill firecrawl-demo-walkthrough -a claude-code2Manually: put the files in place
~/.claude/skills/firecrawl-demo-walkthrough/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/firecrawl-demo-walkthrough/
1Skills CLI (Vercel)
npx skills add firecrawl/firecrawl-workflows --skill firecrawl-demo-walkthrough -a codex2Manually: put the files in place
.agents/skills/firecrawl-demo-walkthrough/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add firecrawl/firecrawl-workflows --skill firecrawl-demo-walkthrough -a cursor2Manually: put the files in place
.cursor/skills/firecrawl-demo-walkthrough/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install firecrawl/firecrawl-workflows firecrawl-demo-walkthrough2Manually: put the files in place
.github/skills/firecrawl-demo-walkthrough/SKILL.md1Skills CLI (Vercel)
npx skills add firecrawl/firecrawl-workflows --skill firecrawl-demo-walkthrough -a gemini-cli2Platform CLI
gemini skills install https://github.com/firecrawl/firecrawl-workflows --path skills/firecrawl-demo-walkthroughManually: put the files in place
.devin/skills/firecrawl-demo-walkthrough/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add firecrawl/firecrawl-workflows --skill firecrawl-demo-walkthrough -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about firecrawl-demo-walkthrough
How do I install firecrawl-demo-walkthrough in Claude Code?
Run npx skills add firecrawl/firecrawl-workflows --skill firecrawl-demo-walkthrough -a claude-code. The skill lands at ~/.claude/skills/firecrawl-demo-walkthrough/SKILL.md.
What does firecrawl-demo-walkthrough do?
It opens a product in the Firecrawl browser, walks its key flows, and writes a markdown walkthrough with screens, findings, recommendations and the pages it visited.
What do I need before the first run?
A Firecrawl API key in FIRECRAWL_API_KEY. That variable is required, since hosted Firecrawl requests use it.
Source text
SKILL.md · ISC
---
name: firecrawl-demo-walkthrough
description: Walk through a product's key flows with Firecrawl browser and produce a structured UX/product walkthrough. Use for signup, onboarding, pricing, docs, dashboard, product demo prep, UX teardown, and first-run experience analysis.
license: ISC
metadata:
author: firecrawl
version: "0.1.0"
homepage: https://www.firecrawl.dev
source: https://github.com/firecrawl/firecrawl-workflows
inputs:
- name: FIRECRAWL_API_KEY
description: Firecrawl API key for hosted Firecrawl requests.
required: true
---
# Firecrawl Demo Walkthrough
Use this to document a product experience step by step.
## Onboarding Interview
Infer the product URL, flow focus, and output format from context. If the URL is clear, proceed immediately.
Ask at most 1-3 concise questions only if blocked, such as the URL, desired flow focus, or credentials/constraints for protected areas.
## Firecrawl Collection Plan
Use Firecrawl browser to open the product and navigate key flows. Snapshot at each step, scrape pages when useful, and document what the user sees and can do.
Do not submit real credentials, purchases, or irreversible actions unless the user explicitly instructs and has permission.
## Parallel Work
If appropriate, use sub-agents or equivalent parallel task runners:
- Homepage and Marketing
- Signup and Onboarding
- Pricing and Plans
- Docs and Developer Experience
- Dashboard and Core Product
- Help and Support
Each walker should return screens visited, actions taken, observations, friction, and source URLs.
## Final Deliverable
```markdown
# Product Walkthrough: [Product]
## Product Overview
[What the product does]
## Flow Walkthroughs
### [Flow Name]
1. [Screen/Page] - what appears and what action is available
2. [Next Screen] - what changes
## Key Findings
[First impression, standout patterns, friction points]
## Recommendations
[UX/product improvements]
## Pages Visited
[URLs]
## Rerun Inputs
workflow: firecrawl-demo-walkthrough
url: [url]
focus: [full/signup/pricing/docs/dashboard]
```
## Quality Bar
- Be specific about screens, CTAs, forms, and transitions.
- Separate observation from opinion.
- Preserve every page visited.
© firecrawl · ISC · firecrawl/firecrawl-workflows
