surger SKILL.md skillB

surger from coderperseus/skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add coderperseus/skills/surger@git:20260625.72f8a78

Pins git:20260625.72f8a78 in mdr.lock. Pin the fingerprint instead.

Audit grade
B, 16 of 17 checks passed
Kind
SKILL.md skill
Repository
coderperseus/skills
Path
skills/surger/SKILL.md
Versions recorded
1
Latest version
git:20260625.72f8a78, committed Jun 25, 2026
Size
9,472 bytes
Repository stars
2
License
none declared

Diagnose and operate Surge for Mac through terminal-first workflows. Use when the user asks about Surge, surge-cli, proxy/VPN/TUN/enhanced mode, system proxy, DNS timeout, "no internet", "network not working", proxy nodes, policy groups, profile validation, modifying Surge profiles, reloading Surge, or helping a non-technical Mac user fix Surge-related network problems safely.

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

# Surger

Operate Surge for Mac as a terminal-first network assistant. Prefer `surge-cli` and macOS network commands before GUI actions, explain findings in plain language, and avoid exposing proxy secrets.

This skill combines a user-safe workflow with Surge's bundled official CLI reference. For advanced command semantics, full `dump`/`test` command lists, `set` key-path behavior, streaming command behavior, platform limits, and environment field definitions, read [references/command-reference.md](references/command-reference.md). The bundled official skill is mirrored at [references/official-skill.md](references/official-skill.md).

Authoritative sources:

- Surge manual CLI page: `https://manual.nssurge.com/others/cli.html`
- Official app-bundled skill: `/Applications/Surge.app/Contents/Resources/Skills/surge/`
- Local mirrored reference: [references/command-reference.md](references/command-reference.md)

After a Surge app update, refresh the mirrored official reference:

```bash
bash scripts/sync_official_surge_skill.sh
```

## Safety Rules

- Start read-only unless the user explicitly asks to change something.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add coderperseus/skills/surger@sha256:019ed30b6bad1268

The line at the top of this page pins the label git:20260625.72f8a78, 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_rvzjolsdidve6hcr.svg)](https://markdownregistry.com/a/art_rvzjolsdidve6hcr)

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

Versions

The registry has recorded 1 version of this file, committed on Jun 25, 2026.

versioncommittedcommitsizeaudit
git:20260625.72f8a78 latest2026-06-25 72f8a78 9,472 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:8888)
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (9472 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

coderperseus/skills · 2 stars · license none declared · pushed 2026-10-28 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_rvzjolsdidve6hcr
GET https://markdownregistry.com/api/v1/resolve?ref=coderperseus/skills/surger
GET https://markdownregistry.com/api/v1/blob/019ed30b6bad12684ac11338a0acc4095d353dc4e1b3b83c2c805f033ac11a61

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 coderperseus/skills

polish-spoken-video SKILL.md skill
coderperseus/skills · polish-spoken-video/SKILL.md · 精修用户提供的口播、录屏讲解或实测视频,去除卡顿、重说和无意义空白,保留必要演示,添加低存在感的浅灰圆角底字幕,直接交付成片。用户说“按上次标准剪口播”“柔和灰底字幕”“不用确认直接剪”时使用;不用于从零生成视频。
git:20261020.5b402d5 · audit A · 2 stars
bug-hunt SKILL.md skill
coderperseus/skills · skills/bug-hunt/SKILL.md · Systematic root-cause debugging for software bugs (frontend, backend, mobile). Use when the user reports a symptom that…
git:20260525.95477a8 · audit A · 2 stars
mygo-intro-animation SKILL.md skill
coderperseus/skills · skills/mygo-intro-animation/SKILL.md · Build a first-run / install intro animation ("安装动画", "开场动画", "首次启动动画", onboarding intro) for a myGo native-UI macOS app…
git:20261028.1b4899a · audit A · 2 stars
pdf-to-epub SKILL.md skill
coderperseus/skills · skills/pdf-to-epub/SKILL.md · Convert a PDF book into a reflowable EPUB (strip running headers/footers/watermarks, rebuild paragraphs, split…
git:20260819.72eb71c · audit A · 2 stars
seo-geo-playbook SKILL.md skill
coderperseus/skills · skills/seo-geo-playbook/SKILL.md · Audit, design, implement, and verify production-grade Technical SEO and Generative Engine Optimization (GEO / AI Search…
git:20261028.3ec2fc2 · audit B · 2 stars

Every file in coderperseus/skills

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