domain-mask — Claude Code skill: mask domains for demos
domain-mask shows a real URL under a clean domain through a local HTTPS proxy with a trusted certificate. For demos, screen recordings and screenshots.
Apache-2.0 281 installs ★ 335 updated 2026-10-24
npx skills add adobe/skills --skill domain-mask -a claude-codeWhat domain-mask does
The skill spins up a reverse proxy on port 443 with an mkcert certificate and a /etc/hosts entry so the browser address bar displays a custom domain (e.g. wknd.adventures) with a padlock while content is served from the actual URL (https://main--mysite--org.aem.page). The proxy runs via web mask with sudo until Ctrl+C, then the hosts entry is removed automatically.
Requires Node 22+, installed mkcert (via brew install mkcert && mkcert -install) and superuser access for the privileged port and /etc/hosts changes. macOS only. URLs inside HTML, CSS and JS are not rewritten — the proxy passes responses as is.
What it helps with
- display a clean domain in the address bar during demo recordings
- mask the real site URL under a custom domain with a trusted certificate
- substitute a local domain for screenshots without browser warnings
Example prompts for the agent
- Set up a proxy for
wknd.adventuresto serve content fromhttps://gabrielwalt.github.io - Show me the command to mask
https://main--mysite--org.aem.pageunderdemo.site - Check if the
wknd.adventuresentry is still in/etc/hostsafter stopping the proxy
How to install domain-mask
1Skills CLI (Vercel)
npx skills add adobe/skills --skill domain-mask -a claude-code2Manually: put the files in place
~/.claude/skills/domain-mask/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/domain-mask/
1Skills CLI (Vercel)
npx skills add adobe/skills --skill domain-mask -a codex2Manually: put the files in place
.agents/skills/domain-mask/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add adobe/skills --skill domain-mask -a cursor2Manually: put the files in place
.cursor/skills/domain-mask/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install adobe/skills plugins/web/skills/domain-mask2Manually: put the files in place
.github/skills/domain-mask/SKILL.md1Skills CLI (Vercel)
npx skills add adobe/skills --skill domain-mask -a gemini-cli2Platform CLI
gemini skills install https://github.com/adobe/skills --path plugins/web/skills/domain-maskManually: put the files in place
.devin/skills/domain-mask/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add adobe/skills --skill domain-mask -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about domain-mask
How to install domain-mask in Claude Code?
Run npx skills add adobe/skills --skill domain-mask -a claude-code, the skill will land in ~/.claude/skills/domain-mask/SKILL.md.
What does domain-mask do?
Spins up a local HTTPS proxy with a trusted certificate so a real URL appears in the browser under a different domain. Built for demos and recordings where a clean domain with a padlock matters.
What does domain-mask require?
Node 22+, installed mkcert (brew install mkcert && mkcert -install) and sudo access for port 443 and /etc/hosts changes. macOS only.
Source text
SKILL.md · Apache-2.0
---
name: domain-mask
license: Apache-2.0
compatibility: macOS only. Requires Node 22+, mkcert and sudo (port 443, /etc/hosts); uses the web CLI (plugins/web/cli)
description: >-
Serves a real URL behind a custom display domain through a local trusted-HTTPS
reverse proxy (mkcert certificate, /etc/hosts entry) with `web mask`, so demos
and recordings show a clean domain with a padlock. macOS only. Use when the user
wants to mask, alias, or fake a domain for a demo, recording, or screenshot.
---
# domain-mask
Mask a URL behind a custom domain for demos and recordings. An HTTPS reverse
proxy makes the address bar show a clean domain (e.g. `wknd.adventures`) while
content is served from the real URL (e.g. `https://main--mysite--org.aem.page`).
Trusted certificate via mkcert, no browser warnings.
## Requirements
- Node 22+, mkcert (`brew install mkcert && mkcert -install`), sudo (port 443 and `/etc/hosts`)
- The `web` CLI (`playwright-cli` is not needed for this command). Locate it once:
```bash
# <skill-dir> is the directory containing this SKILL.md
WEB=$(command -v web || echo "node <skill-dir>/../../cli/dist/web.mjs")
```
then run `$WEB …`; it prints exactly one JSON document on stdout,
so `$WEB … > file.json` is safe.
Fallback when published: `npx -y @adobe/web-cli`. Use an absolute `<skill-dir>`; don't `cd` into it.
## Workflow
### Step 1: Gather inputs
Ask the user for (or extract from their message):
- **Display domain**: the domain to show (e.g. `wknd.adventures`)
- **Target URL**: the real URL to proxy (e.g. `https://gabrielwalt.github.io`)
### Step 2: Check prerequisites
```bash
which mkcert || echo "Install mkcert: brew install mkcert && mkcert -install"
```
If mkcert is missing, tell the user to install it and run `mkcert -install` once.
### Step 3: Have the user start the proxy
The command prompts for the sudo password and stays in the foreground until
Ctrl+C, so the user runs it in their own terminal. Give them the command with
`WEB` expanded to the resolved form:
```bash
sudo env CAROOT="$(mkcert -CAROOT)" $WEB mask "<display-domain>" "<target-url>"
```
`CAROOT` is resolved before `sudo`, so mkcert signs with the CA the user
installed rather than one under root's home, which the browser would not trust.
Without root the command exits 2 (USAGE).
It adds `127.0.0.1 <display-domain>` to `/etc/hosts`, generates a trusted
certificate via mkcert, starts an HTTPS reverse proxy on port 443, and prints
`{ url, displayDomain, targetUrl }`.
Tell the user:
- Open `https://<display-domain>`; the address bar shows the display domain with a padlock
- Press **Ctrl+C** when done: the hosts entry is removed and the certs are cleaned up
### Step 4: Confirm cleanup
After the user stops the proxy, check that the hosts entry is gone (no output
means clean):
```bash
grep -Fx '127.0.0.1 <display-domain>' /etc/hosts
```
If the line is still there, have the user remove it. Escape the dots so `sed`
matches only that line, e.g. for `wknd.adventures`:
```bash
sudo sed -i '' '/^127\.0\.0\.1 wknd\.adventures$/d' /etc/hosts
```
## Limitations
- macOS only (`/etc/hosts` path, `brew install mkcert`)
- Requires sudo (privileged port 443 + hosts file)
- One display domain per invocation
- Does not rewrite URLs inside HTML/CSS/JS response bodies
© adobe · Apache-2.0 · adobe/skills