| name | browserbase-fix |
| description | Guide Claude through debugging and fixing failing browser automations |
Fix Automation Skill
Guide Claude through debugging and fixing failing browser automations.
When to Use
Use this skill when:
- A Browserbase Function is failing in production
- An automation stopped working (site changed)
- User reports errors from their automation
- CI/CD pipeline failures related to browser functions
Context Sources
Before debugging, gather context from:
- Error messages - What the user reported or CI logs show
- Function code - The automation script itself
- Recent invocations - Check for patterns in failures
- Function history - When did it last work?
stagehand fn errors <function-name>
stagehand fn logs <function-name>
Debugging Workflow
1. Reproduce the Issue
Start a Browserbase session to see what's happening:
stagehand session create
stagehand session live
Navigate to the target URL:
stagehand goto <target-url>
2. Compare Expected vs Actual State
Take a snapshot of the current page:
stagehand snapshot
Compare with what the automation expects:
- Are the expected elements present?
- Have selectors changed?
- Is there a login wall or CAPTCHA?
- Has the page structure changed?
3. Common Failure Patterns
Selector Changes
