Give Codex the BrowseFleetMCP operating manual as a skill.

The skill teaches the agent to start with browser_health, inspect sessions explicitly, prefer BrowseFleet tools over fallback browser tooling, and use the right recovery path when the extension or transport looks stale.

This is separate from MCP client installation. Use the skill when you want Codex to operate BrowseFleet more reliably after the server is already configured.

mkdir -p ~/.codex/skills
cp -R /absolute/path/to/browsefleetmcp/examples/skills/browsefleetmcp ~/.codex/skills/

What it does

It gives the agent a BrowseFleet-specific workflow instead of generic browser guesses.

Starts with browser_health and session inspection.
Treats sessions as explicit state, not a hidden current tab.
Uses BrowseFleet recovery commands in the right order.
Remembers that focus-sensitive actions serialize.
Prefers BrowseFleet when BrowseFleet itself is the system under test.

Repo location

The skill ships in the repo as a normal drop-in folder.

Copy the folder directly from the repo checkout or from GitHub:

examples/skills/browsefleetmcp/SKILL.md

https://github.com/JakubJDolezal/browsefleetmcp/tree/main/examples/skills/browsefleetmcp

Important boundary

The skill helps Codex operate BrowseFleet. It does not replace MCP client setup.

Cursor, Claude Code, and Claude Desktop still need the normal launcher or bundle configuration from the other docs pages. The skill is for Codex-style environments that load folders from ~/.codex/skills.

Client configs

Install the server in Codex, Cursor, or Claude Code.

Use this if you still need the launcher config itself.

Install

Build the extension, run the server, and attach the first tab.

Use this if the browser side is not wired up yet.

---
name: browsefleetmcp
description: Use when working with BrowseFleetMCP to control Chrome through the local MCP server and extension, especially for session management, browser automation, extension reloads, transport recovery, or validating BrowseFleet behavior itself.
---

# BrowseFleetMCP

Use this skill when:

- the task is specifically about controlling Chrome through BrowseFleetMCP
- the task involves the local BrowseFleetMCP extension, broker, or session pool
- the task needs real browser interaction through the existing BrowseFleet MCP tools
- the task is debugging BrowseFleet rather than replacing it with another browser tool