Skip to content
mcp/skillhub

Agent Skill

hive.browser-automation skill

hive.browser-automationaden-hive/hivecore/framework/skills/_default_skills/browser-automation/SKILL.md

Required before any hive-browser CLI command. The browser is driven from the terminal by running `hive-browser <command> ... --json` via terminal_exec — not via MCP tools. Teaches the browser lifecycle rules (the bridge attaches to the USER'S running Chrome — never kill or launch browser processes; timeouts are transport issues, not crashes), the screenshot + coordinate workflow (hive-browser interact with a fractional coordinate) that reaches shadow-DOM inputs selectors can't see, the viewport-fraction coordinate rule (not pixels), rich-text editor quirks ("send button stays disabled" failures), and CSP gotchas. Covers Chrome via CDP through the GCU Beeline extension.

11kApache-2.0

always on

142 tokname + description

once used

11,043 tokSKILL.md body

bundled files

0

repo stars

11kGitHub

Install the hive.browser-automation skill

Skills CLI (Claude Code, Codex, Cursor and others)

npx skills add https://github.com/aden-hive/hive --skill hive.browser-automation

Claude Code, by hand (all projects)

git clone --depth 1 https://github.com/aden-hive/hive.git /tmp/hive
mkdir -p ~/.claude/skills
cp -R /tmp/hive/core/framework/skills/_default_skills/browser-automation ~/.claude/skills/browser-automation

For one project only, copy the folder into .claude/skills/ in that project instead. The agent picks it up when a task matches its description.

What it costs your context

Agent Skills load in three steps. Tokens counted with the o200k tokenizer; your model's count will differ a little.

WhenWhat loadsCost
Every sessionName and description142 tok
When the agent uses itThe SKILL.md instructions11,043 tok
Only if openedNo bundled files—

Until it is used, hive.browser-automation costs about 9.6× less than the median MCP server we measured (1,362 tokens on every turn). Installing all 24 skills from aden-hive/hive would load 1,783 tokens of descriptions. Skills vs MCP study

Checks

  • The instructions are over 5,000 tokens, the Agent Skills specification's guideline for SKILL.md.
  • The name breaks the specification (lowercase letters, digits and single hyphens, up to 64 characters).

Checked 2026-10-22 · method

What's inside

The headings of its SKILL.md. Read the full file on GitHub.

  • GCU Browser Automation
  • Browser lifecycle & recovery — read this before "fixing" anything
  • Targeting a specific Chrome profile / account
  • Working on LinkedIn?
  • Coordinates
  • Screenshot + coordinates is shadow-agnostic — prefer it on shadow-heavy sites
  • Recommended workflow on shadow-heavy sites
  • The click→type loop (canonical pattern)
  • Empirically verified (2026-04-11)
  • Shadow-piercing selectors
  • Navigation and waiting
  • The basics
  • Timing expectations (measured against real sites)
  • After navigate, always let SPA hydrate
  • Reading pages efficiently
  • Typing and keyboard input
  • ALWAYS click before typing into rich-text editors
  • Safe "click-then-type-then-verify" pattern
  • Why the type action uses Input.insertText by default
  • Neutralizing beforeunload draft dialogs
  • Verified site-specific quirks
  • Plain text into a real input
  • Keyboard shortcuts (Ctrl+A, Shift+Tab, Cmd+Enter)
  • Special keys

More skills from aden-hive/hive

All skills in this repo
  1. browser-edge-casesaden-hive/hive

    SOP for debugging browser automation failures on complex websites. Use when browser tools fail on specific sites like LinkedIn, Twitter/X, SPAs, or sites with Shadow DOM.

    11k1039 tok idle · 1,605 in use
  2. Required reading whenever any chart_* tool is available. Teaches the one-tool embedding contract (call chart_render → live chart appears in chat AND a downloadable PNG lands in the queen session dir), the ECharts (data viz) vs Mermaid (structural diagrams) decision, the BI/financial-grade aesthetic baseline (no chartjunk, restrained palette, proper typography, single message per chart), and the canonical spec patterns for the 12 most-common chart types. Skipping this leads to 1990s-Excel charts, missing downloads, and the agent writing markdown image links by hand instead of letting chart_render drive the UI.

    11k133 tok idle · 2,493 in use
  3. Claim tasks, record step progress, and verify SOP gates in the colony SQLite queue. Applies when your spawn message includes a db_path field.

    11k36 tok idle · 1,091 in use
  4. Proactively extract critical values from tool results into working notes before automatic context pruning destroys them.

    11k24 tok idle · 231 in use
  5. hive.error-recoveryaden-hive/hive

    Follow a structured recovery decision tree when tool calls fail instead of blindly retrying or giving up.

    11k25 tok idle · 278 in use
  6. hive.image-generationaden-hive/hive

    Required before calling image_generate. Create and edit images from a prompt — generate an image, make a picture / logo / illustration / icon / banner / poster / thumbnail / hero image / mockup / product shot / social graphic, or edit / restyle / combine existing images from reference images. Uses OpenAI gpt-image-2 through the Hive image service, billed to the user's Hive credits like an LLM call (no API key needed). Teaches the exact call shape, the quality/cost tradeoff (quality="low" is the default and cheapest), reference-image editing, how to show the result to the user with attach_file, and the failure modes (out of credits, model unavailable, moderation).

    11k149 tok idle · 1,193 in use
  7. Read before automating LinkedIn with browser_* tools. LinkedIn combines shadow DOM (#interop-outlet), strict Trusted Types CSP that silently drops innerHTML, Lexical composer, native beforeunload dialogs that hang the bridge, and aggressive spam filters — each has bitten us at least once. Verified flows for profile messaging, connection-request acceptance, feed composition, and search. Requires hive.browser-automation. Verified against logged-in production 2026-04-11.

    11k99 tok idle · 5,000 in use
  8. hive.note-takingaden-hive/hive

    Maintain a free-form scratchpad of decisions, extracted values, and open questions so context pruning doesn't lose anything you still need.

    11k30 tok idle · 225 in use