Agent skill

Skyvern Browser Automation

by Skyvern-AI in Skyvern-AI/skyvern

Automates websites with Skyvern's AI browser agent to fill forms, extract data, download files, log in and run multi-step workflows through SDKs, REST, MCP or a CLI.

AGPL-3.0Auto-check passedProductivity & Automation

Install Skyvern Browser Automation

skills CLI
$ npx skills add Skyvern-AI/skyvern --skill skyvern -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Skyvern-AI/skyvern skyvern --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Skyvern-AI/skyvern.git skills-src && mkdir -p .claude/skills && cp -r skills-src/docs .claude/skills/skyvern && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
skyvern
GitHub stars
23k
Token cost
~1.9k tokens
SKILL.md length
496 words
Files
513
Skills in repo
6
Repo updated
First seen
Licence
AGPL-3.0

At a glance

Automates websites with Skyvern's AI browser agent to fill forms, extract data, download files, log in and run multi-step workflows through SDKs, REST, MCP or a CLI.

  • Filling out a web form on a site that has no API
  • SKILL.md covers When to use Skyvern, Capabilities, Constraints and Key references
  • Calls curl, claude and pip; reaches news.ycombinator.com and api.skyvern.com; needs SKYVERN_API_KEY
  • Extracting structured data such as prices or table rows from a web page

What it does

Skyvern drives a browser with language models and computer vision, so it can work on sites it has never seen. A single task takes a natural-language prompt and a starting URL, with optional inputs such as a JSON schema for structured output and a proxy country code for geo-routing. The same capability is reachable through a Python SDK, a TypeScript SDK, a REST API, an MCP server and a CLI.

For longer jobs, workflows chain blocks for navigation, actions, extraction, loops, login, file download and parsing, upload, email, webhooks, validation, waiting and code into reusable automations. Typical uses are filling forms, scraping prices or table rows, downloading invoices or reports from portals, and signing in to sites before acting. It needs a Skyvern Cloud API key or a self-hosted instance; the Python SDK requires Python 3.11 or newer and the TypeScript SDK Node.js 18 or newer.

When your agent uses it

  • Filling out a web form on a site that has no API
  • Extracting structured data such as prices or table rows from a web page
  • Downloading invoices or statements from a customer portal after logging in
  • Running a multi-step browser workflow that spans several websites

Example prompts

  • “Log in to our supplier portal and download last month's invoices.”
  • “Extract the top three posts from news.ycombinator.com as JSON with title and URL.”
  • “Set up Skyvern's MCP server so my coding agent can run browser tasks.”

Requirements

  • A Skyvern Cloud API key or a self-hosted Skyvern instance
  • Python 3.11 or newer for the Python SDK
  • Node.js 18 or newer for the TypeScript SDK
  • Compatibility (from SKILL.md): Requires a Skyvern Cloud API key (https://app.skyvern.com) or a self-hosted Skyvern instance. Python SDK requires Python 3.11+. TypeScript SDK requires Node.js 18+. MCP server works with Claude Code, Claude Desktop, Cursor, Windsurf, and VS Code.

What it can do on your machine

Read from SKILL.md and the folder at commit f5f3f28. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • curl
    • claude
    • pip

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • news.ycombinator.com
    • api.skyvern.com

    Also links to:

    • skyvern.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • SKYVERN_API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

  • Compatibility

    Requires a Skyvern Cloud API key (https://app.skyvern.com) or a self-hosted Skyvern instance. Python SDK requires Python 3.11+. TypeScript SDK requires Node.js 18+. MCP server works with Claude Code, Claude Desktop, Cursor, Windsurf, and VS Code.

    From compatibility in the SKILL.md frontmatter.

Context cost

Skyvern Browser Automation loads about 1.9k tokens when it runs. Until then it costs about 93 tokens; SKILL.md has 496 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~93
When it runs · the whole SKILL.md, loaded when a task matches
~1.9k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from Skyvern-AI/skyvern at commit f5f3f28, republished under its AGPL-3.0 licence (© Skyvern-AI). 496 words, ~1,893 tokens.

Download SKILL.mdSave it as .claude/skills/skyvern/SKILL.md (or your agent's skills folder). This skill also uses 512 other files; get the full folder from GitHub.
name
skyvern
description
Automate any website with AI-powered browser automation. Use when the user needs to interact with a website like filling forms, extracting data, downloading files, logging in, or running multi-step workflows. Skyvern navigates sites it has never seen before using LLMs and computer vision. Integrates via Python SDK, TypeScript SDK, REST API, MCP server, or CLI.
compatibility
Requires a Skyvern Cloud API key (https://app.skyvern.com) or a self-hosted Skyvern instance. Python SDK requires Python 3.11+. TypeScript SDK requires Node.js 18+. MCP server works with Claude Code, Claude Desktop, Cursor, Windsurf, and VS Code.
license
AGPL-3.0
metadata.author
skyvern-docs
metadata.version
1.0
metadata.docs
https://skyvern.com/docs
metadata.github
https://github.com/Skyvern-AI/skyvern

Skyvern: AI Browser Automation

Skyvern automates browser-based workflows using LLMs and computer vision. It navigates websites it has never seen before, filling forms, extracting data, and completing multi-step tasks via a simple API.

SDK reference (all methods, parameters, types in one page): https://skyvern.com/docs/sdk-reference/complete-reference

When to use Skyvern

  • The user needs to interact with a website programmatically (fill forms, click buttons, navigate pages)
  • The user needs to extract structured data from a website (scrape prices, addresses, table rows)
  • The user needs to download files from a web portal (invoices, reports, statements)
  • The user needs to log in to a website and perform actions behind authentication
  • The user needs to automate a multi-step workflow across one or more websites
  • The user needs to run browser automation from an AI assistant (Claude, Cursor, Windsurf)

Capabilities

Run a single task

Execute a one-shot browser automation with natural language instructions.

Inputs:

  • prompt (required): Natural language description of what to do
  • url (required): Starting page URL
  • data_extraction_schema (optional): JSON schema for structured output
  • proxy_location (optional): Country code for geo-routing (e.g., US, DE)

Python SDK:

python
from skyvern import Skyvern

client = Skyvern(api_key="YOUR_API_KEY")
result = await client.run_task(
    prompt="Get the title of the top post on Hacker News",
    url="https://news.ycombinator.com",
)

TypeScript SDK:

typescript
import Skyvern from "@skyvern/client";

const client = new Skyvern({ apiKey: "YOUR_API_KEY" });
const result = await client.runTask({
    prompt: "Get the title of the top post on Hacker News",
    url: "https://news.ycombinator.com",
});

REST API:

bash
curl -X POST https://api.skyvern.com/api/v2/run \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "Get the top post title", "url": "https://news.ycombinator.com"}'
Extract structured data

Define a JSON schema to get consistent, typed output from any page.

python
result = await client.run_task(
    prompt="Extract the top 3 posts",
    url="https://news.ycombinator.com",
    data_extraction_schema={
        "type": "object",
        "properties": {
            "posts": {
                "type": "array",
                "items": {
                    "type": "object",
                    "properties": {
                        "title": {"type": "string"},
                        "url": {"type": "string"},
                        "points": {"type": "integer"}
                    }
                }
            }
        }
    },
)
Build multi-step workflows

Chain task blocks, loops, conditionals, data extraction, and file operations into reusable automations.

Block types: NavigationBlock, ActionBlock, ExtractBlock, LoopBlock, TextPromptBlock, LoginBlock, FileDownloadBlock, FileParseBlock, UploadBlock, EmailBlock, WebhookBlock, ValidationBlock, WaitBlock, CodeBlock, ForLoopBlock, WhileLoopBlock, FileURLParsingBlock, DownloadToS3Block, SendEmailBlock.

Use a ForLoopBlock when the workflow already has a fixed list to iterate over, such as extracted rows, uploaded files, or user-provided URLs. Use a WhileLoopBlock when the workflow should keep repeating until a condition changes, such as paginating while a Next button remains enabled, polling until a status is complete, or retrying while a recoverable page state is visible.

python
workflow = await client.create_workflow(
    title="Invoice Downloader",
    blocks=[...],  # See workflow blocks reference
)
run = await client.run_workflow(workflow_id=workflow.workflow_id)
Show full SKILL.md (202 more words)Show less
Manage browser sessions

Persist a live browser across multiple tasks to maintain login state, cookies, and page context.

python
session = await client.create_session()
# Run multiple tasks on the same browser
await client.run_task(prompt="Log in", url="https://example.com", browser_session_id=session.browser_session_id)
await client.run_task(prompt="Download invoice", url="https://example.com/billing", browser_session_id=session.browser_session_id)
await client.close_session(session.browser_session_id)
Handle authentication

Store passwords, TOTP/2FA secrets, and credit cards securely. Skyvern auto-fills login forms and generates 2FA codes during automation.

Supported credential providers: Skyvern vault (built-in), Bitwarden, 1Password, Azure Key Vault.

Use via MCP server

Connect AI assistants directly to browser automation. The MCP server exposes 75+ tools.

Install for Claude Code:

bash
claude mcp add skyvern-cloud -- npx @anthropic-ai/skyvern-mcp@latest --skyvern-api-key YOUR_API_KEY

Install for Cursor/VS Code: Add to MCP config:

json
{
  "mcpServers": {
    "skyvern": {
      "command": "npx",
      "args": ["@anthropic-ai/skyvern-mcp@latest", "--skyvern-api-key", "YOUR_API_KEY"]
    }
  }
}
Use via CLI
bash
pip install skyvern
export SKYVERN_API_KEY="YOUR_KEY"

skyvern browser session create          # Start a cloud browser
skyvern browser act "Click the login button"  # Natural language action
skyvern browser extract '{"title": "string"}' # Extract structured data
skyvern browser screenshot              # Capture screenshot
skyvern task run --prompt "..." --url "..."   # Run a task
skyvern workflow run --id wf_xxx        # Run a workflow

Constraints

  • Tasks run in cloud browsers managed by Skyvern (or self-hosted browsers). They do not run in the user's local browser by default.
  • Each task step consumes credits. Set max_steps to control costs.
  • Browser automation takes 30-120 seconds per task depending on complexity.
  • Skyvern works best with natural language prompts that describe the goal, not low-level click instructions.
  • For websites that require login, credentials must be stored via the credentials API before running tasks.
  • Self-hosted deployments require Docker and a PostgreSQL database.

Key references

© Skyvern-AI, AGPL-3.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 512 other files in docs of Skyvern-AI/skyvern.

  • SKILL.md
  • api-reference/openapi.json
  • changelog-emails/2026-05-may.md
  • changelog-emails/2026-06-june.md
  • changelog-emails/2026-07-july.md
  • changelog-emails/2026-08-august.md
  • changelog-emails/images/2026-04-01-copilot-v2.png
  • changelog-emails/images/2026-04-02-mcp-oauth.png
  • changelog-emails/images/2026-04-03-cli-schedule-config.png
  • changelog-emails/images/2026-04-04-ai-summarize.png
  • changelog-emails/images/2026-04-05-error-code-mapping.png
  • changelog-emails/images/2026-04-06-debugger-run-dialog.png
  • changelog-emails/images/2026-05-00-header.png
  • changelog-emails/images/2026-05-01-draggable-editor.png
  • changelog-emails/images/2026-05-02-run-page-redesign.png
  • changelog-emails/images/2026-05-03-while-loop.png
  • changelog-emails/images/2026-05-04-analytics-dashboard.png
  • changelog-emails/images/2026-05-05-copilot.png
  • … and 495 more

Open the folder on GitHubat commit f5f3f28

Compare with similar skills

Skyvern Browser Automation next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Skyvern Browser Automation compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Skyvern Browser Automation this skillSkyvern-AI/skyvern23k—~1.9kAutomated safety check: PassAGPL-3.0
Anti Detect Browserantibrow/anti-detect-browser-skills17—~9.8kAutomated safety check: WarnMIT
Firecrawl Interact Integrationfirecrawl/firecrawl190k1 repos~731Automated safety check: PassISC
Brightdata SDK JSbrightdata/skills264—~3kAutomated safety check: PassMIT
Tiered Web Browsing and Scrapingcode-yeongyu/oh-my-openagent70k—~2.7kAutomated safety check: WarnCustom licence
Cloudflare Browser Renderingeinverne/dotfiles121—~4.9kAutomated safety check: PassGPL-3.0

Similar skills

  • Anti Detect Browser

    antibrow/anti-detect-browser-skills

    Drive Chromium from standard Playwright APIs with a real-device fingerprint applied in the kernel, one persistent isolated profile per identity, and a per-profile proxy whose exit IP sets timezone…

    17 GitHub stars~9.8k tokensUpdated 1 mo ago
    Testing & QAAuto-check: warnings
  • Guides adding Firecrawl's /interact endpoint to product code for pages that need clicks, forms, pagination or logged-in flows beyond plain scraping.

    190k GitHub starsUsed in 1 repo~731 tokens
    Data & AnalyticsAuto-check passed
  • Brightdata SDK JS

    brightdata/skills

    Web data extraction and discovery using the Bright Data JavaScript/TypeScript SDK (@brightdata/sdk).

    264 GitHub stars~3k tokensUpdated 3 days ago
    Productivity & AutomationAuto-check passed
  • Tiered Web Browsing and Scraping

    code-yeongyu/oh-my-openagent

    Routes a web request through the cheapest tier that can finish it, from headless extraction with WAF bypass up to a real stealth or signed-in browser, with screenshots as proof.

    70k GitHub stars~2.7k tokensUpdated today
    Productivity & AutomationAuto-check: warnings
  • Guide for implementing Cloudflare Browser Rendering - a headless browser automation API for screenshots, PDFs, web scraping, and testing.

    121 GitHub stars~4.9k tokensUpdated 1 mo ago
    Productivity & AutomationAuto-check passed
  • Xiaohongshu Hub

    OpenMinis/MinisSkills

    Skill for reading and writing Xiaohongshu (XHS) data using Python + UV.

    446 GitHub stars~2.7k tokensUpdated 3 days ago
    Productivity & AutomationAuto-check passed

More from Skyvern-AI/skyvern

  • Skyvern Browser Automation

    Skyvern-AI/skyvern

    Picks the right Skyvern CLI command for a web task, from quick yes/no checks to reusable multi-page workflows, instead of falling back to plain page fetching.

    23k GitHub starsUsed in 1 repo~2.9k tokens
    Auto-check passed
  • Skyvern Version Bump

    Skyvern-AI/skyvern

    Walks through a Skyvern open-source release bump: update the version, rebuild the Python and TypeScript SDKs with Fern, commit, and open a pull request.

    23k GitHub stars~1k tokensUpdated yesterday
    Auto-check: notes
  • Smoke-tests a Skyvern deployment by checking the backend API, frontend rendering, browser session provisioning and workflow execution in sequence.

    23k GitHub stars~1.5k tokensUpdated yesterday
    Auto-check passed
  • Diff-Driven Smoke Tests

    Skyvern-AI/skyvern

    Reads your git diff, writes a handful of happy-path browser smoke tests, runs them with Skyvern or Chrome DevTools MCP and posts screenshot evidence to the PR.

    23k GitHub stars~5.2k tokensUpdated yesterday
    Auto-check passed
  • Diff-Driven QA

    Skyvern-AI/skyvern

    Reads your git diff, decides whether the change needs browser QA, API checks or repo tests, runs that validation and reports pass or fail with evidence.

    23k GitHub stars~4.7k tokensUpdated yesterday
    Auto-check: warnings

Questions about Skyvern Browser Automation

What does Skyvern Browser Automation do?

Automates websites with Skyvern's AI browser agent to fill forms, extract data, download files, log in and run multi-step workflows through SDKs, REST, MCP or a CLI. Skyvern drives a browser with language models and computer vision, so it can work on sites it has never seen. A single task takes a natural-language prompt and a starting URL, with optional inputs such as a JSON schema for structured output and a proxy country code for geo-routing.

When should I use Skyvern Browser Automation?

Skyvern Browser Automation fits situations like: filling out a web form on a site that has no API; extracting structured data such as prices or table rows from a web page; downloading invoices or statements from a customer portal after logging in; running a multi-step browser workflow that spans several websites.

How do I install Skyvern Browser Automation in Claude Code?

Run `npx skills add Skyvern-AI/skyvern --skill skyvern -a claude-code`. Or copy the skill folder (docs in Skyvern-AI/skyvern) into .claude/skills/skyvern in your project. Claude Code loads it when a task matches its description.

How do I install Skyvern Browser Automation in Codex?

Run `npx skills add Skyvern-AI/skyvern --skill skyvern -a codex`. Or copy the skill folder (docs in Skyvern-AI/skyvern) into .agents/skills/skyvern in your project. Codex loads it when a task matches its description.

Can I use Skyvern Browser Automation in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Skyvern-AI/skyvern --skill skyvern -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/skyvern, .gemini/skills/skyvern, .github/skills/skyvern and .opencode/skills/skyvern in your project.

What does Skyvern Browser Automation need to run?

Going by SKILL.md and its folder, Skyvern Browser Automation needs the command-line tools its instructions call (curl, claude and pip) and credentials named SKYVERN_API_KEY. Our summary lists: A Skyvern Cloud API key or a self-hosted Skyvern instance; Python 3.11 or newer for the Python SDK; Node.js 18 or newer for the TypeScript SDK. Compatibility (from SKILL.md): Requires a Skyvern Cloud API key (https://app.skyvern.com) or a self-hosted Skyvern instance. Python SDK requires Python 3.11+. TypeScript SDK requires Node.js 18+. MCP server works with Claude Code, Claude Desktop, Cursor, Windsurf, and VS Code..

Does Skyvern Browser Automation access the network?

SKILL.md names 3 domains. In commands or code: news.ycombinator.com and api.skyvern.com; the agent is likely to contact these when it follows the instructions. As links in the text: skyvern.com. This is read from the text; nothing was executed.

Is Skyvern Browser Automation safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Skyvern Browser Automation use?

Skyvern Browser Automation is published under the AGPL-3.0 licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Skyvern Browser Automation use?

About 1.9k tokens (SKILL.md is roughly 7.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Skyvern Browser Automation?

Skills that share tags, products or a category with Skyvern Browser Automation: Anti Detect Browser (antibrow/anti-detect-browser-skills, 17 stars), Firecrawl Interact Integration (firecrawl/firecrawl, 190k stars), Brightdata SDK JS (brightdata/skills, 264 stars) and Tiered Web Browsing and Scraping (code-yeongyu/oh-my-openagent, 70k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Skyvern Browser Automation?

Skyvern-AI (a GitHub organization) maintains it in Skyvern-AI/skyvern, which has 23,172 GitHub stars. The repository holds 6 skills in this directory. The repository was last updated on October 10, 2026.

Source: Skyvern-AI/skyvern on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.