Umbraco.Automate: Skill for Claude Code

Demo Site Management

Manage the Umbraco.Automate demo site with automatic port discovery via named pipes.

Command: $ARGUMENTS

Execute the requested demo site operation.

Available commands

• start: Start demo site with DemoSite-Claude profile on dynamic port
• stop: Stop the running demo site
• status: Check if site is running and show port/pipe info
• restart: Stop and restart the demo site
• open: Open the demo site in default browser (discovers port automatically)

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 querying site address endpoint via named pipe (see "Query site address via named pipe" section)
   • 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. If not running, start in background: cd demos/v{major}/Umbraco.Automate.DemoSite && dotnet run --launch-profile DemoSite-Claude
4. Wait 15-20 seconds for startup
5. Query site address endpoint via named pipe to get port and pipe name (see "Query site address via named pipe" section)
6. Report:
   • Task ID for later stopping (save this for future commands)
   • Port number (from site address endpoint)
   • Pipe name (format: umbraco.demosite.{branch-or-worktree})
   • Site URL

For "stop"

1. Find background tasks related to demo site:

   • Look for tasks with "DemoSite" or "demo-site" in name
   • Extract task ID from task list

2. If task found:

   • Use TaskStop with the task ID to stop gracefully
   • Wait 2-3 seconds for cleanup