Skip to main content
skill CX Codex

turbo-browser — Claude Code skill: what it does, how to install

The turbo-browser skill for Claude Code drives browser tasks using compact MCP tools. It reduces token consumption during page inspection, form filling, and complex action chaining.

MIT ★ 139 updated 2026-11-17

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add Tthanh2k6/turbo-browser-mcp --skill turbo-browser -a claude-code
Open on GitHub

What turbo-browser does

The skill operates through tabs_batch, inspect_compact, smart_fill_form, act_fast, and batch_actions to control browser sessions. It streamlines interactions by grouping multiple operations into single calls, which keeps token usage low while navigating pages or verifying submissions.

To use it, trigger commands like inspect_compact with onlyChanged or batch_actions for multi-step workflows. For secure form submissions, the skill requires allowSubmit to be set to true and a submissionKey to prevent duplicate events. If a task requires human intervention for logins, the skill provides a pause mechanism to resume after the session is established.

The skill requires Node.js and the npx utility for integration into the development environment.

What it helps with

  • automate form completion in one call
  • chain browser actions together
  • retrieve page state after complex interactions
  • scrape data from dynamic lists
  • perform secure form submissions with verification

Example prompts for the agent

  • /plugin:turbo-browser inspect_compact {"mode":"forms"}
  • /plugin:turbo-browser smart_fill_form {"fields":[{"selector":"#email","value":"[email protected]"}]}
  • /plugin:turbo-browser batch_actions {"steps":[{"action":"click","text":"Next"}]}

How to install turbo-browser

1Skills CLI (Vercel)

npx skills add Tthanh2k6/turbo-browser-mcp --skill turbo-browser -a claude-code

2Manually: put the files in place

~/.claude/skills/turbo-browser/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/turbo-browser/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about turbo-browser

How to install turbo-browser in Claude Code?

Run npx skills add Tthanh2k6/turbo-browser-mcp --skill turbo-browser -a claude-code in your project terminal.

What does turbo-browser do?

It provides a set of MCP tools that allow an agent to interact with web pages efficiently by reading content, filling forms, and chaining actions while minimizing token usage.

What is required to use turbo-browser?

The skill requires Node.js to be installed and an environment configured to manage MCP tools within your AI platform.

Source text

SKILL.md · MIT
---
name: turbo-browser
description: Use when driving a browser through the turbo-browser MCP tools (tabs_batch, inspect_compact, smart_fill_form, act_fast, batch_actions). Gives the low-token loop for reading pages, filling forms, chaining steps and verifying a submit.
---

# Driving a browser with turbo-browser

Aim for few calls and small results. Each call below replaces several one-action calls.

## 1. Look once, then only changes

Call `inspect_compact` once. Later calls pass `onlyChanged` so the result lists only new or changed elements (marked `*`). Narrow big pages with `query` or `selector`. Use refs from the latest snapshot only.

```
inspect_compact {"mode":"forms"}
inspect_compact {"onlyChanged":true}
inspect_compact {"mode":"article","selector":"main","maxChars":3000}
```

For plain reading use `extract_clean_text` (`format` markdown or text).

## 2. Fill a whole form in one call

`smart_fill_form` takes every field at once. Comboboxes use `option`, uploads use file paths. It stops before Submit.

```
smart_fill_form {"fields":[{"selector":"#email","value":"[email protected]"},{"ref":"f0:e7","option":"Vietnam"},{"selector":"input[type=file]","file":"cv.pdf"},{"ref":"f0:e9","check":true}],"returnSnapshot":true,"snapshotMode":"forms"}
```

## 3. Chain steps

`batch_actions` runs steps in order. Set `returnSnapshot` to get the end state in the same reply. Add `snapshotQuery` when a re-render is large and you only need part of it.

```
batch_actions {"steps":[{"action":"click","text":"Next"},{"action":"wait","textNew":"Step 2"},{"action":"fill","selector":"#phone","value":"0900000000"}],"returnSnapshot":true,"snapshotQuery":"phone|Continue"}
```

Read feeds with `collect`, which scrolls, reads and de-duplicates:

```
batch_actions {"steps":[{"action":"navigate","url":"https://example.com/list"},{"action":"collect","selector":".row","scrolls":8,"maxItems":100}]}
```

## 4. Waiting

In `act_fast` or a step, `wait` accepts `text`, `textGone`, `url` or `loadState`. Use `textNew` to wait for text that was not on the page when the step started; plain `text` returns at once if the words already exist.

```
act_fast {"action":"wait","textNew":"Saved|Error","timeoutMs":8000}
```

## 5. Submit safely

Final actions (Submit, Send, Pay, Book, Schedule) are blocked unless `allowSubmit` is true. Pass `expect` so the reply says whether it worked. Prefer `textNew` over `textMatches`, because old text on the page also matches `textMatches`. Add `submissionKey` to stop a second submit.

```
batch_actions {"steps":[{"action":"click","text":"Schedule meeting"}],"allowSubmit":true,"expect":{"textNew":"confirmed","timeoutMs":8000},"submissionKey":"booking-2026-11-20"}
```

Check `submitVerified` in the result. If it is false, inspect the page before retrying.

## 6. Login, captchas, 2FA

Use `wait_for_human` with `urlMatches` or `selector`. The agent resumes in the same tab. Do not try to solve checks.

```
wait_for_human {"message":"Log in, then return","urlMatches":"/dashboard","timeoutMs":300000}
```

## 7. Tabs and separate sessions

`tabs_batch` opens and lists tabs in one call. Give `isolatedContext` a name to get separate cookies and storage, for example two accounts at once.

```
tabs_batch {"operations":[{"action":"open","url":"https://example.com","isolatedContext":"acct-a"},{"action":"open","url":"https://example.com","isolatedContext":"acct-b"}]}
tabs_batch {"operations":[{"action":"open_many","urls":["https://example.com/a","https://example.com/b"]}]}
```

## Habits

- Prefer `text` or `ref` targets over coordinates.
- One `batch_actions` call beats five `act_fast` calls.
- Treat an error as data: read it, fix the target, retry once.

© Tthanh2k6 · MIT · Tthanh2k6/turbo-browser-mcp

Similar skills

All skills for Agent setup: memory, context, orchestration →

Project sponsors

Companies that keep this analytics open