Umbraco.Automate: Skill for Claude Code

Demo Site Management

Manage the Umbraco.Automate demo site. Each worktree gets its own stable dev port, assigned once by Umbraco.Community.WorktreeDevPort and stored in that worktree's own git config — no named pipe, socket, or discovery endpoint to query.

Command: $ARGUMENTS

Execute the requested demo site operation.

Available commands

• start: Start demo site with the DemoSite profile
• stop: Stop the running demo site
• status: Check if site is running and show its port
• restart: Stop and restart the demo site
• open: Open the demo site in default browser

Current Environment

• Working directory: !pwd
• Git branch: !git branch --show-current 2>/dev/null || echo "not in git repo"
• Background tasks: !echo "Check with /tasks command for active background tasks"

Implementation Guide

For "start"

1. Check if already running using multi-method detection:
   • Try reading the port (see "Get the worktree's dev port" section) and connecting to it
   • Check if background tasks exist with "DemoSite" in description
   • If running, report and exit
2. Detect demo site path:
   • Read Directory.Packages.props and extract the major from the Umbraco.Cms.Core version (range lower bound or fixed, e.g. [18.0.0, …) or 18.0.0 → 18)
   • Demo site path: demos/v{major}/Umbraco.Automate.DemoSite
3. Ensure the frontend assets exist (a fresh clone or worktree has none, and the Automate section then renders blank with no error):
   • Run scripts/build-frontend.ps1 (Windows) or bash scripts/build-frontend.sh (macOS/Linux) from the repo root
   • On Windows, run it with the PowerShell tool, not pwsh ... through Bash: a worktree-isolated session's Bash tool refuses to shell out to pwsh
   • Safe to run every start: it is a no-op when both wwwroot folders are already populated
   • On a fresh worktree it runs npm ci + npm run build at the repo root and can take a few minutes - allow a long timeout and never run npm by hand instead
   • It handles the Node version itself (reads engines.node, and prepends an installed nvm-for-windows version to PATH for that process only - never run nvm use)
   • If it exits non-zero, stop and report its message: starting the site anyway gives a blank section with no error
4. If not running, start in background: cd demos/v{major}/Umbraco.Automate.DemoSite && dotnet run --launch-profile DemoSite
5. Wait 15-20 seconds for startup (the package picks a free port on first run in this worktree, or reuses the one it already picked)
6. Read the port (see "Get the worktree's dev port" section)
7. Report:
   • Task ID for later stopping (save this for future commands)
   • Port number
   • Site URL (https://127.0.0.1:<port>)