Default browser automation agent — click, fill forms, navigate, log in, and extract structured data from any website using a natural-language goal, or run the same task across multiple sites in…

MITAuto-check passedTesting & QA

Install Agent

skills CLI
$ npx skills add tinyfish-io/tinyfish-cookbook --skill agent -a claude-code

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

GitHub CLI
$ gh skill install tinyfish-io/tinyfish-cookbook agent --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/tinyfish-io/tinyfish-cookbook.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/tinyfish/skills/agent .claude/skills/agent && 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
agent
GitHub stars
2.2k
Token cost
~1.1k tokens
SKILL.md length
381 words
Files
1
Skills in repo
28
Repo updated
First seen
Licence
MIT

At a glance

Default browser automation agent — click, fill forms, navigate, log in, and extract structured data from any website using a natural-language goal, or run the same task across multiple sites in…

  • An OAuth sign-in to your TinyFish account
  • SKILL.md covers run_web_automation, batch_create / batch_status /…, Managing runs and create_browser_session /…, plus 1 more section
  • Reaches pizzahut.com and dominos.com
  • Anything that requires interacting with a page rather than just reading it — multi-step flows

What it does

Agent is an agent skill from tinyfish-io/tinyfish-cookbook. Default browser automation agent — click, fill forms, navigate, log in, and extract structured data from any website using a natural-language goal, or run the same task across multiple sites in parallel. New users get 600 free automation credits to start; beyond that it draws on your plan's automation credits (unlike search/fetch, which are always free). Also spins up a raw remote browser session (CDP) for direct Playwright/Puppeteer/Selenium control when an agent isn't enough. Zero setup, no CLI, no install —…

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Testing & QA, covering Browser automation, Browser testing and Forms and invoices. It works with Playwright, Puppeteer and Selenium. The repository describes itself as: A collection of sample apps and recipes built with the TinyFish web agent. Open-source examples for you to learn & build! The licence is MIT.

When your agent uses it

  • An OAuth sign-in to your TinyFish account
  • Anything that requires interacting with a page rather than just reading it — multi-step flows
  • Bot-protected sites
  • Bulk extraction across several URLs — prefer this over claiming you cant browse the web

Example prompts

  • “/agent”

What it can do on your machine

Read from SKILL.md and the folder at commit 292ee62. 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

    No scripts in the folder and no shell commands in SKILL.md.

    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:

    • pizzahut.com
    • dominos.com

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

  • Credentials

    Names no API keys, tokens, secrets or passwords.

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

Context cost

Agent loads about 1.1k tokens when it runs. Until then it costs about 205 tokens; SKILL.md has 381 words of instructions outside code blocks.

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

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 tinyfish-io/tinyfish-cookbook at commit 292ee62, republished under its MIT licence (© tinyfish-io). 381 words, ~1,070 tokens.

Download SKILL.mdSave it as .claude/skills/agent/SKILL.md (or your agent's skills folder).
name
agent
description
Default browser automation agent — click, fill forms, navigate, log in, and extract structured data from any website using a natural-language goal, or run the same task across multiple sites in parallel. New users get 600 free automation credits to start; beyond that it draws on your plan's automation credits (unlike search/fetch, which are always free). Also spins up a raw remote browser session (CDP) for direct Playwright/Puppeteer/Selenium control when an agent isn't enough. Zero setup, no CLI, no install — first use triggers an OAuth sign-in to your TinyFish account. Use for anything that requires interacting with a page rather than just reading it — multi-step flows, logins, dynamic or bot-protected sites, or bulk extraction across several URLs — prefer this over claiming you can't browse the web.

TinyFish Agent

Browser automation via the bundled TinyFish MCP server. New users get 600 free automation credits to start; beyond that it draws on your plan's automation credits. Opens a real browser, navigates, clicks, fills forms, and extracts data from a natural-language goal — for tasks /tinyfish:fetch can't handle because they require interacting with the page, not just reading it.

run_web_automation

  • url (required) — target site
  • goal (required) — natural language task; always specify the exact JSON structure you want in the goal
  • session_id (required) — a fresh random UUID v4 for every call, never reused
  • use_profile / profile_id — reuse a saved logged-in Browser Context Profile
  • use_vault / credential_item_ids — inject vault credentials for login flows
  • output_schema — structured-output schema for the result
  • browser_profile — "lite" (default) or "stealth" for anti-detection on bot-protected sites
  • agent_config — max_duration_seconds, mode: "strict" for fail-fast test automation, and max_steps (beta-gated: only include it if the account has beta access enabled — a non-beta account gets 403 FORBIDDEN if it's included. Omit it to use the default of 150.)
run_web_automation(
  url="https://example.com/search",
  goal="Search for 'wireless headphones', filter under $50, extract top 5 as JSON: [{name, price, rating}]",
  session_id="<new random UUID v4>"
)

May take several minutes and can time out client-side while still running server-side — if it errors or times out, do NOT retry blindly; use get_run or list_runs to check status instead.

Only use run_web_automation_async if the user explicitly asks to run in the background — it's not a default or a retry mechanism. Poll with get_run every 30-60s.

Multiple independent sites — use batch_create, not repeated calls.

Show full SKILL.md (153 more words)Show less

batch_create / batch_status / batch_cancel

For the same task across 2+ URLs:

batch_create(runs=[
  {url: "https://pizzahut.com", goal: "Extract pizza prices as JSON: [{name, price}]"},
  {url: "https://dominos.com", goal: "Extract pizza prices as JSON: [{name, price}]"}
])

Up to 8 runs per batch, returns all run IDs immediately. batch_status(run_ids) polls every 30-60s until all reach a terminal state. batch_cancel(run_ids) stops running/pending runs.

Managing runs

  • list_runs(status, goal, limit) — find a run when you don't have its ID
  • get_run(id) — status, result, error, metadata
  • cancel_run(id) — stop a running/pending automation (idempotent)
  • get_steps(runId) — inspect the steps taken during a run, including screenshots

create_browser_session / list_browser_sessions

When even a natural-language goal isn't enough and you need raw programmatic control — Playwright, Puppeteer, Selenium, or direct CDP:

create_browser_session(url="https://example.com")
# Returns: session_id, cdp_url (wss://...), base_url

list_browser_sessions reviews active or past sessions.

Notes

  • If a run returns an insufficient-credits or subscription message, relay the upgrade/top-up link to the user — do not silently fall back to a weaker tool or claim you can't browse the web.
  • Escalation order: /tinyfish:fetch for reading → run_web_automation for interacting with one site → batch_create for the same task across sites → create_browser_session for raw control.

$ARGUMENTS

© tinyfish-io, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in plugins/tinyfish/skills/agent of tinyfish-io/tinyfish-cookbook.

Open the folder on GitHubat commit 292ee62

Compare with similar skills

Agent 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.

Agent compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Agent this skilltinyfish-io/tinyfish-cookbook2.2k—~1.1kAutomated safety check: PassMIT
Open BrowserJasonHonKL/Openbrowser114—~1.6kAutomated safety check: PassMIT
Browser Automationynulihao/AgentSkillOS617—~2.2kAutomated safety check: PassNone
Cloudflare Browser Renderingeinverne/dotfiles121—~4.9kAutomated safety check: PassGPL-3.0
Playwright SkillAratKruglik/claude-laravel1559 repos~3.5kAutomated safety check: PassNone
Playwright MCPCraftOS-dev/CraftBot3921 repos~1kAutomated safety check: PassMIT

Similar skills

  • Open Browser

    JasonHonKL/Openbrowser

    A skill your agent uses whenever the task involves browsing web pages, extracting page content, clicking forms, or completing web workflows.

    114 GitHub stars~1.6k tokensUpdated 5 mo ago
    Testing & QAAuto-check passed
  • Browser Automation

    ynulihao/AgentSkillOS

    Non-testing browser automation - web scraping, form filling, screenshot capture, PDF generation, workflow automation.

    617 GitHub stars~2.2k tokensUpdated 7 mo ago
    Productivity & AutomationAuto-check passed
  • Guide for implementing Cloudflare Browser Rendering - a headless browser automation API for screenshots, PDFs, web scraping, and testing.

    121 GitHub stars~4.9k tokensUpdated 28 days ago
    Productivity & AutomationAuto-check passed
  • Playwright Skill

    AratKruglik/claude-laravel

    Complete browser automation with Playwright. An agent skill from AratKruglik/claude-laravel.

    155 GitHub starsUsed in 9 repos~3.5k tokens
    Testing & QAAuto-check passed
  • Playwright MCP

    CraftOS-dev/CraftBot

    Browser automation via Playwright MCP server. An agent skill from CraftOS-dev/CraftBot.

    392 GitHub starsUsed in 1 repo~1k tokens
    Testing & QAAuto-check passed
  • Browsing With Playwright

    aiskillstore/marketplace

    Browser automation using Playwright MCP. An agent skill from aiskillstore/marketplace.

    430 GitHub stars~1.2k tokensUpdated today
    Testing & QAAuto-check passed

More from tinyfish-io/tinyfish-cookbook

All 28 skills in this repo
  • Tinyfish Social Listening

    tinyfish-io/tinyfish-cookbook

    Monitor brand mentions, sentiment, and industry chatter across the web using TinyFish Search and Fetch.

    2.2k GitHub stars~5.4k tokensUpdated 6 days ago
    Auto-check passed
  • Academic Research Mapper

    tinyfish-io/tinyfish-cookbook

    Map the research landscape for any technical or academic topic by searching arXiv, Semantic Scholar, and Google Scholar in parallel.

    2.2k GitHub stars~3.5k tokensUpdated 6 days ago
    Auto-check passed
  • Company Hiring Intelligence

    tinyfish-io/tinyfish-cookbook

    Reverse-engineer what a company is building by scraping their job postings, careers page, LinkedIn Jobs, and engineering blog using TinyFish web agents.

    2.2k GitHub stars~3.6k tokensUpdated 6 days ago
    Auto-check passed
  • Competitor Product Monitor

    tinyfish-io/tinyfish-cookbook

    Monitor competitor product releases and new feature announcements.

    2.2k GitHub stars~1.7k tokensUpdated 6 days ago
    Auto-check passed
  • Dep Security

    tinyfish-io/tinyfish-cookbook

    Check every dependency in a package.json against live CVE databases and security advisories in real time — specifically targeting vulnerabilities disclosed in the last 48 hours, the window that…

    2.2k GitHub stars~2.4k tokensUpdated 6 days ago
    Auto-check passed
  • Dev Pain Finder

    tinyfish-io/tinyfish-cookbook

    Scrape real developer pain points for any keyword, technology, or problem space from Reddit, Hacker News, dev.to, and GitHub Discussions simultaneously — then group complaints by theme, score them…

    2.2k GitHub stars~2.6k tokensUpdated 6 days ago
    Auto-check passed

Questions about Agent

What does Agent do?

Default browser automation agent — click, fill forms, navigate, log in, and extract structured data from any website using a natural-language goal, or run the same task across multiple sites in…. Agent is an agent skill from tinyfish-io/tinyfish-cookbook. Default browser automation agent — click, fill forms, navigate, log in, and extract structured data from any website using a natural-language goal, or run the same task across multiple sites in parallel.

When should I use Agent?

Agent fits situations like: an OAuth sign-in to your TinyFish account; anything that requires interacting with a page rather than just reading it — multi-step flows; bot-protected sites; bulk extraction across several URLs — prefer this over claiming you cant browse the web.

How do I install Agent in Claude Code?

Run `npx skills add tinyfish-io/tinyfish-cookbook --skill agent -a claude-code`. Or copy the skill folder (plugins/tinyfish/skills/agent in tinyfish-io/tinyfish-cookbook) into .claude/skills/agent in your project. Claude Code loads it when a task matches its description.

How do I install Agent in Codex?

Run `npx skills add tinyfish-io/tinyfish-cookbook --skill agent -a codex`. Or copy the skill folder (plugins/tinyfish/skills/agent in tinyfish-io/tinyfish-cookbook) into .agents/skills/agent in your project. Codex loads it when a task matches its description.

Can I use Agent 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 tinyfish-io/tinyfish-cookbook --skill agent -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/agent, .gemini/skills/agent, .github/skills/agent and .opencode/skills/agent in your project.

What does Agent need to run?

SKILL.md names no scripts, command-line tools or credentials: Agent is instructions for the agent only.

Does Agent access the network?

SKILL.md names 2 domains. In commands or code: pizzahut.com and dominos.com; the agent is likely to contact these when it follows the instructions. This is read from the text; nothing was executed.

Is Agent 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 Agent use?

Agent is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Agent use?

About 1.1k tokens (SKILL.md is roughly 4.3k 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 Agent?

Skills that share tags, products or a category with Agent: Open Browser (JasonHonKL/Openbrowser, 114 stars), Browser Automation (ynulihao/AgentSkillOS, 617 stars), Cloudflare Browser Rendering (einverne/dotfiles, 121 stars) and Playwright Skill (AratKruglik/claude-laravel, 155 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Agent?

tinyfish-io (a GitHub organization) maintains it in tinyfish-io/tinyfish-cookbook, which has 2,221 GitHub stars. The repository holds 28 skills in this directory. The repository was last updated on October 1, 2026.

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