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
npx skills add Tthanh2k6/turbo-browser-mcp --skill turbo-browser -a claude-codeWhat 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-code2Manually: put the files in place
~/.claude/skills/turbo-browser/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/turbo-browser/
1Skills CLI (Vercel)
npx skills add Tthanh2k6/turbo-browser-mcp --skill turbo-browser -a codex2Manually: put the files in place
.agents/skills/turbo-browser/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add Tthanh2k6/turbo-browser-mcp --skill turbo-browser -a cursor2Manually: put the files in place
.cursor/skills/turbo-browser/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install Tthanh2k6/turbo-browser-mcp skills/turbo-browser2Manually: put the files in place
.github/skills/turbo-browser/SKILL.md1Skills CLI (Vercel)
npx skills add Tthanh2k6/turbo-browser-mcp --skill turbo-browser -a gemini-cli2Platform CLI
gemini skills install https://github.com/Tthanh2k6/turbo-browser-mcp --path skills/turbo-browserManually: put the files in place
.devin/skills/turbo-browser/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.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 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