Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add adobe/skills --skill domain-mask -a claude-code
Open on GitHub

What 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.adventures to serve content from https://gabrielwalt.github.io
  • Show me the command to mask https://main--mysite--org.aem.page under demo.site
  • Check if the wknd.adventures entry is still in /etc/hosts after stopping the proxy

How to install domain-mask

1Skills CLI (Vercel)

npx skills add adobe/skills --skill domain-mask -a claude-code

2Manually: put the files in place

~/.claude/skills/domain-mask/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/domain-mask/

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

Similar skills

All skills for DevOps and infrastructure →

From the same set108

The whole set →
page-collect page-collect pulls icons, metadata, text, forms, videos and social links from a page via the web CLI. Use it when migrating to Edge Delivery Services or auditing a site. CX Codex +1 283installs page-langs The page-langs skill compares language signals in a page’s markup with languages found in its visible text. Use it to check hreflang and investigate localization mismatches. CX Codex +1 282installs cdp-ext-pilot cdp-ext-pilot launches Chromium with an unpacked extension, opens its side panel, popup or options page, and drives it via CDP. Built for testing and automating extension UI. CX Codex +1 282installs page-reduce The page-reduce skill turns a webpage into a structural skeleton with tokens for content and interface elements. Use it to map a page for an AEM Edge Delivery Services migration or block planning. CX Codex +1 281installs page-prep page-prep is a Claude Code skill that detects and clears cookie banners, paywalls, and blocking modals before web scraping or taking screenshots via Playwright CLI. CX Codex +1 281installs commerce-app-migrate commerce-app-migrate migrates Adobe Commerce App Builder projects from starter kits to the App Management approach. Runs in the project root. CX Codex +1 256installs qa Runs an automated read-only QA sweep on deployed AEM Edge Delivery Services sites. It spots regressions, template flaws, and broken links without editing code. CX Codex +1 253installs run-workflow Routes agent requests to the run-workflow MCP server. It lets an agent build, run, publish, and save Adobe Firefly workflows. CX Codex +1 250installs

Project sponsors

Companies that keep this analytics open