agent-browser-policy

Enforces consent, credential safety, and session ownership rules for agent-browser automation.

Updated Aug 2, 2026
One-click install
npx skills add https://github.com/leonardoacosta/agents --skill agent-browser-policy-leonardoacosta
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agent-browser-policy
Source: https://github.com/leonardoacosta/agents/tree/main/skills/agent-browser-policy
Command: npx skills add https://github.com/leonardoacosta/agents --skill agent-browser-policy-leonardoacosta

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Browser automation with AI agents risks leaking credentials, hijacking user profiles, and blurring the boundary between CLI-driven and harness-provided browsers. This Skill defines the consent, privacy, and session-ownership rules that must accompany every agent-browser session. ## Core Features & Use Cases - Consent and privacy rules: Governs when confirmation is required, how authorized test-persona logins and reauthentication are handled, and how credentials must stay out of logs, output, and artifacts. - Runtime boundaries: Separates CLI evidence from harness browser evidence, restricts CDP attachment to approved endpoints, and requires pinned tabs for shared sessions. - Profile and session management: Verifies private profile paths and ownership, handles profile locks safely, and mandates task-unique named sessions with scoped cleanup. - Use Case: When an agent needs to log into a staging app with a test persona via agent-browser, this policy ensures credentials are entered through a secret-safe helper, identity is verified after login, and only the task-owned session is closed afterward. ## Quick Start Load the agent-browser-policy skill alongside agent-browser before performing any browser automation that involves logins, profiles, or CDP endpoints.

Frequently Asked Questions about agent-browser-policy

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I safely automate browser logins with an AI agent?

Authorized login requires explicit user approval for a named test persona and application. Credentials must be entered through a bounded local helper that keeps values out of logs, output, and shell history, with origin rechecked before entry and identity verified afterward.

What is the agent-browser-policy skill used for?

It supplements the agent-browser core skill with consent, privacy, runtime boundary, and session ownership rules. It governs credential handling, CDP endpoint approval, private profile loading, and cleanup scope whenever agent-browser is used.

Can an AI agent reuse my existing browser profile?

A private profile may be loaded only when the user names or approves the exact path, and the path must be an existing directory owned by the same user. Profile data must never be copied, migrated, or exposed, and lock files must never be deleted.

When is it safe to attach to a browser via CDP?

CDP attachment is allowed only with an explicitly approved endpoint; agents must never probe ports or attach to unapproved browsers. When multiple sessions share CDP, each must use --pin-tab to stay bound to its own tab.

Why does a loaded browser profile appear signed out?

A profile may open as a temporary snapshot and appear signed out, which is a runtime limitation rather than evidence the source profile is logged out. Cookies must never be extracted to diagnose or bypass this condition.