agent-chrome SKILL.md skillB

agent-chrome from hanzhangzzz/agent-skills-zh is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add hanzhangzzz/agent-skills-zh/agent-chrome@git:20261028.d40f720

Pins git:20261028.d40f720 in mdr.lock. Pin the fingerprint instead.

Audit grade
B, 16 of 17 checks passed
Kind
SKILL.md skill
Repository
hanzhangzzz/agent-skills-zh
Path
agent-chrome/SKILL.md
Versions recorded
1
Latest version
git:20261028.d40f720, committed Oct 28, 2026
Size
5,675 bytes
Repository stars
1
License
MIT

本机 AI 浏览器自动化的统一 Chrome 启动器与约定:每个登录态一个 profile(~/.chrome-profiles/<站点>-<别名>),用正式版 Google Chrome 在固定 CDP 端口上 up/down,agent-browser、Playwright、python CDP 都只连端口、不自己起浏览器。Use when 需要浏览器自动化、需要某网站的登录态、要起 Chrome / 开 profile / 拿 CDP 端口、接 agent-browser --cdp、Playwright connectOverCDP、登录过期要重新登录或从主 Chrome 引导 cookie、新增一个网站账号。.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# agent-chrome

一个脚本管所有带登录态的自动化 Chrome:`scripts/agent_chrome.py`(python3 标准库;种 cookie、开后台窗口、优雅关闭用 Node ≥ 22 内置 WebSocket)。

## 约定

1. **二进制**:需要登录态的一律用正式版 `/Applications/Google Chrome.app`。Chrome for Testing / Playwright 自带 Chromium 只用于无登录的渲染测试。
2. **根目录与命名**:profile 都在 `~/.chrome-profiles/`(`$AGENT_CHROME_ROOT` 可改),登记在 `registry.json`。名字一律 `<站点>-<别名>`,首个账号别名固定 `main`(`x-main`、`goofish-main`),永不用裸站点名;`site_defaults` 把站点简名映射到默认 profile,所以 `up x` 等于 `up x-main`。
3. **登录态只存 profile 一份**:不导出 cookie 文件、不用 `--state` / `--session-name` 另存、不每次注入。
4. **主 Chrome 只读**:用户自己的 Chrome 不启动、不 kill、不写;只在 `seed --from-main` 时复制它的 Cookies 库读一次,作为新 profile 的首次引导。
5. **启动与端口**:端口池 19300–19399,登记时分配、固定不变;禁用 9222。headless 优先;有头窗口用 `open -g` + 无启动窗口 + CDP 后台开窗,不抢焦点。
6. **生命周期**:用前 `up`,用完 `down`(走 Browser.close,cookie 才落盘)。脚本里只 `down` 自己拉起的(`up` 输出 `reused:false`),`reused:true` 说明别人在用,不要关。`daemon:true` 的常驻 profile 没有 `--force` 拒绝关闭。
7. **keychain 自动识别**:Playwright 建的 profile 用 mock keychain 加密 cookie,正式 Chrome 建的用系统钥匙串;`add` 时自动检测写进 registry,`up` 据此决定是否加 `--use-mock-keychain`,否则会整体掉登录。
8. **新代码只走本脚本**:老代码(registry 里 note 写着 legacy 的)逐步迁,迁之前它们仍用自带端口或 Playwright 直接起,别同时用两边打开同一个目录。

## CLI 速查

```bash
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add hanzhangzzz/agent-skills-zh/agent-chrome@sha256:d1471ce809f00ab3

The line at the top of this page pins the label git:20261028.d40f720, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_snipjcp2h6kde4hn.svg)](https://markdownregistry.com/a/art_snipjcp2h6kde4hn)

1 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 1 version of this file, committed on Oct 28, 2026.

versioncommittedcommitsizeaudit
git:20261028.d40f720 latest2026-10-28 d40f720 5,675 BB view

Audit of the latest version

B  16 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • fail: No link to a raw IP address (matched: http://127.0.0.1)
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (5675 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No script tag

Starting a new one? Use a template for SKILL.md on mdpantry, which passes every one of these checks and says what to change in it.

Source

GitHub

hanzhangzzz/agent-skills-zh · 1 stars · license MIT · pushed 2026-10-29 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_snipjcp2h6kde4hn
GET https://markdownregistry.com/api/v1/resolve?ref=hanzhangzzz/agent-skills-zh/agent-chrome
GET https://markdownregistry.com/api/v1/blob/d1471ce809f00ab3911e32456d6606d29e8a2543f7891c16f8c41a2ccf1d320b

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from hanzhangzzz/agent-skills-zh

AGENTS.md AGENTS.md file
hanzhangzzz/agent-skills-zh · AGENTS.md
git:20260908.c2a51c6 · audit A · 1 stars
CLAUDE.md CLAUDE.md file
hanzhangzzz/agent-skills-zh · CLAUDE.md
git:20260908.c2a51c6 · audit B · 1 stars
audio-inbox SKILL.md skill
hanzhangzzz/agent-skills-zh · audio-inbox/SKILL.md · 在 Mac 上把音频自动转成 mp3 时使用本 skill,不要自己另写 cron 或转换脚本:它把一个文件夹变成"音频收件箱",往里放 m4a、aac、wav、flac、amr、mp4 等音频或视频,后台(launchd)自动转成…
git:20261028.e8906f2 · audit A · 1 stars
ci-review SKILL.md skill
hanzhangzzz/agent-skills-zh · ci-review/SKILL.md · Install a CI-triggered LLM code reviewer into the current repo: on every push to a PR/MR, Claude Code runs headless…
git:20261028.7206195 · audit A · 1 stars
do-something SKILL.md skill
hanzhangzzz/agent-skills-zh · do-something/SKILL.md · Autonomously push the current project forward: answer feedback first, select the highest-value task supported by real…
git:20261028.bd6709d · audit A · 1 stars
doc-reader SKILL.md skill
hanzhangzzz/agent-skills-zh · doc-reader/SKILL.md · Translate an English technical article (web URL) or a local PDF into accurate Chinese, section by section with…
git:20260904.c21f62b · audit A · 1 stars
gpt-image2-prompt-director SKILL.md skill
hanzhangzzz/agent-skills-zh · gpt-image2-prompt-director/SKILL.md · Turn a weak idea into a high-impact GPT image2 (gpt-image-2) generation brief: prompt director workflows, idea…
git:20260901.4d9bf39 · audit A · 1 stars
harness SKILL.md skill
hanzhangzzz/agent-skills-zh · harness/SKILL.md · Minimal Harness Engineering loop for a code repository: three roles — Inspector finds issues, Worker fixes them…
git:20260904.cb78277 · audit A · 1 stars
hkr-render SKILL.md skill
hanzhangzzz/agent-skills-zh · hkr-render/SKILL.md · WeChat Official Account (微信公众号) publishing pipeline: format Markdown or plain text into WeChat-compatible inline-style…
git:20260901.4d9bf39 · audit A · 1 stars
hook-test-kit SKILL.md skill
hanzhangzzz/agent-skills-zh · hook-test-kit/SKILL.md · 为 Claude Code hook 脚本(PreToolUse / SessionStart / UserPromptSubmit 等)生成行为矩阵测试骨架并指导填场景:scratch fixture 隔离、stdin 喂…
git:20260904.5bc92eb · audit A · 1 stars
launch-video SKILL.md skill
hanzhangzzz/agent-skills-zh · launch-video/SKILL.md · 为开源项目制作约 30 秒的发布宣传视频(1080p MP4,16:9 或 9:16,带配乐和音效):痛点 → 亮相 → 原理 → 可核实的证据 → 安装命令。先按项目、渠道和受众从 30 种视觉风格(扁平动态图形、动态排版、等轴…
git:20261028.efd4ad0 · audit A · 1 stars
DESIGN.md@md2view DESIGN.md file
hanzhangzzz/agent-skills-zh · md2view/DESIGN.md
git:20260831.3dc09f5 · audit A · 1 stars

Every file in hanzhangzzz/agent-skills-zh

Browse by kind, by grade B, or by owner.