mcpField
P
polite-browser-use

polite-browser-use

github.com/jord-jdAgent workflows68 installs
Repository

About polite-browser-use

polite-browser-use is a skill for keeping browser operations unobtrusive and safe around audio, windows, and cleanup. It is intended for agents performing browser tasks and specifies when to mute, use hidden or headless browsing, and close task-owned tabs.

Key features

  1. 01Mute before audio may start
  2. 02Prefer headless or hidden browsing
  3. 03Avoid stealing focus or changing settings
  4. 04Close task-owned tabs and browsers
  5. 05Verify tab removal when possible

Use cases

  1. 01Navigating pages that may play audio
  2. 02Running browser work without disrupting the user
  3. 03Cleaning up tabs opened for a task

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/jord-jd/jord-skills --skill polite-browser-use

After installing, type/polite-browser-usein Claude Code to confirm it loaded.

Details

From the project README

Polite browser use

Keep browser work silent and out of the user's way. Apply these rules before the first operation, including hidden previews. Search APIs, HTTP retrieval, and reading saved screenshots do not trigger this skill.

Mute before audio can start. Mute the tab, process, or application before navigation or interaction that could play sound. Cover HTML media, Web Audio, music, effects, and new windows. Inspect the mute state when available; headless, hidden, or background operation does not prove silence. Do not press Play or Start without reliable muting.

Prefer existing mute controls. If those are insufficient and editing the application is authorized, use a focused test-only mute mode enabled before audio initializes; keep normal launches unchanged. Never modify third-party or read-only applications to silence them. Otherwise use a silent environment or skip the audio-producing interaction and report the limitation. Test actual audio through silent recording or virtual output; get permission before testing through speakers.

Avoid disruptive windows. Use headless external browsers and hidden internal previews unless the user expects a visible window. Avoid stealing focus or changing the user's browser settings.

Clean up what you opened. Close task-owned tabs and stop task-only browsers and servers when finished, unless they need to remain available for the task or the user asked to keep them. Never close the user's tabs or kill a shared browser to clean up your own work.

Use an explicit tab-close control and verify removal when possible. Hidden, detached, and unavailable do not mean closed. Do not claim closure from hiding, navigation, or window.close() alone. If the tools cannot close a tab or verify closure, report that briefly and accurately.

Comments

Markdown supported