local-web-surface SKILL.md skillA

local-web-surface from adonis0123/adonis-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add adonis0123/adonis-skills/local-web-surface@v1.4.0

Pins v1.4.0 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
adonis0123/adonis-skills
Path
skills/local-web-surface/SKILL.md
Versions recorded
2
Latest version
v1.4.0, committed Sep 1, 2026
First version recorded
Aug 8, 2026
Size
19,960 bytes
Repository stars
4
License
MIT

Build or extend a persistent macOS local web surface when the request includes a stable *.localhost URL, an existing loopback daemon/gateway, login startup, or a thin .app launcher that opens or wakes a persistent local HTTP surface. Once triggered, it can add file-backed CRUD or local/public content projections without changing public publishing. Covers domain ownership, exact Host routing, explicit access/threat boundaries, safe mutations, launchd lifecycle, TDD, curl checks, and…

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

# Local Web Surface

把一个“本地页面”交付成可长期使用的产品入口:固定 `*.localhost` URL、登录后自动可用、可选 `.app` 启动器、真实运行验收。

此 Skill 编排已有代码与系统能力,不规定前端框架。默认优先复用现有 loopback daemon;只有证据证明生命周期、权限或故障域必须隔离时,才新增监听进程。

## 适用性门槛

请求至少要包含一个持久 surface 信号:稳定 `*.localhost` 身份、loopback daemon/gateway、登录自启、共享 listener,或为持久本地 HTTP surface 提供唤醒/打开能力的 macOS `.app` launcher。只包装 `https://...` 公网或内网页面的 `.app` 不属于本 Skill。普通 dev server 上的页面/CRUD 实现不使用本 Skill;只需打开、操作或截图现有 URL 时交给 Browser/`agent-browser`。站点扫描与修复应交给当前环境中已安装且匹配的审计流程;不要硬路由到未验证存在的 Skill。

## 先定义可验证结果

开始前写出以下合同:

```text
Local Web Surface Contract
- Surface: <name>
- Canonical URL: http://<name>.localhost:<port>/
- Data owner: <repo/module>
- Transport owner: <existing daemon or new service>
- Read boundary: <what may be displayed>
- Publish boundary: <none or what may leave the machine>
- Write boundary: <none or exact mutations>
- Access/threat boundary: <trusted local user/processes, or exact authentication/authorization>
- Launcher: <none or App name>
- Done signals: <evidence selected by Change surfaces; Host/handler-only = focused tests + diff scope + curl 200/421/404>
```

若用户已授权自主完成,可从代码和本机状态解析这些值,不重复询问。若选择会改变数据真相源、公开范围、访问/认证边界或占用未知服务端口,先停在一个决策问题上。

## 第一性原理
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add adonis0123/adonis-skills/local-web-surface@sha256:037ca94caebaaf9f

The line at the top of this page pins the label v1.4.0, 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_novuvnw626z7ho2m.svg)](https://markdownregistry.com/a/art_novuvnw626z7ho2m)

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

Versions

The registry has recorded 2 versions of this file, between Aug 8, 2026 and Sep 1, 2026, about one every 24 days.

versioncommittedcommitsizeaudit
v1.4.0 latest2026-09-01 0590e3c 19,960 BA view · diff
v1.3.02026-08-08 b7c2645 16,685 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (19960 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 link to a raw IP address
  • pass: No script tag

Source

GitHub

adonis0123/adonis-skills · 4 stars · license MIT · pushed 2026-10-20 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_novuvnw626z7ho2m
GET https://markdownregistry.com/api/v1/resolve?ref=adonis0123/adonis-skills/local-web-surface
GET https://markdownregistry.com/api/v1/blob/037ca94caebaaf9f0034ea344c0aebafe54049be7974d6d5b0630c8ef386e8df

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 adonis0123/adonis-skills

agent-symlink-init SKILL.md skill
adonis0123/adonis-skills · .agents/skills/agent-symlink-init/SKILL.md · Initialize or migrate agent-skill symlinks in any repository. Use when a project needs `.claude/skills` linked to…
git:20260914.ce3286b · audit A · 4 stars
code-inspector-init SKILL.md skill
adonis0123/adonis-skills · .agents/skills/code-inspector-init/SKILL.md · Set up or migrate code-inspector-plugin across modern frontend frameworks. Use when you need click-to-source IDE…
git:20260914.ce3286b · audit A · 4 stars
commit SKILL.md skill
adonis0123/adonis-skills · .agents/skills/commit/SKILL.md · Generate read-only emoji-prefixed Conventional Commit messages or create focused local commits from staged changes or a…
git:20260923.3e02ac9 · audit A · 4 stars
copywriting SKILL.md skill
adonis0123/adonis-skills · .agents/skills/copywriting/SKILL.md · When the user wants to write, rewrite, or improve marketing copy for any page — including homepage, landing pages…
v1.0.0 · audit A · 4 stars
css-tailwind-styling SKILL.md skill
adonis0123/adonis-skills · .agents/skills/css-tailwind-styling/SKILL.md · Expert guidance for writing clean, performant CSS and Tailwind CSS. Use when creating styles, designing components…
git:20260923.15ed8b9 · audit A · 4 stars
lingui-best-practices SKILL.md skill
adonis0123/adonis-skills · .agents/skills/lingui-best-practices/SKILL.md · Implement or review Lingui message macros, catalog configuration, locale loading, and React or JavaScript integration…
git:20260923.15ed8b9 · audit A · 4 stars
lingui-workflow SKILL.md skill
adonis0123/adonis-skills · .agents/skills/lingui-workflow/SKILL.md · Choose and troubleshoot extract, translation-check, compile, and catalog-manifest commands in an existing Lingui…
git:20260905.8844a98 · audit A · 4 stars
repo-skill-creator SKILL.md skill
adonis0123/adonis-skills · .agents/skills/repo-skill-creator/SKILL.md · Create and maintain repository skills for adonis-skills. Use when users ask to scaffold a new skill under skills/…
git:20260923.15ed8b9 · audit A · 4 stars
weekly-report SKILL.md skill
adonis0123/adonis-skills · .agents/skills/weekly-report/SKILL.md · Generate structured weekly reports from Git commit history across one or multiple repositories. Use when you need…
v1.1.1 · audit A · 4 stars
AGENTS.md AGENTS.md file
adonis0123/adonis-skills · AGENTS.md
git:20260317.cd91537 · audit B · 4 stars
CLAUDE.md CLAUDE.md file
adonis0123/adonis-skills · CLAUDE.md
git:20261018.53d2379 · audit A · 4 stars
DESIGN.md DESIGN.md file
adonis0123/adonis-skills · DESIGN.md · Catalog site for Nika's agent skills. Near-white warm gray pages, one fresh leaf-green accent used on small areas, and…
alpha · audit A · 4 stars

Every file in adonis0123/adonis-skills

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