run-opendesign
Use after any OpenDesign build to serve ./opendesign/ over HTTP and give the user a clickable preview link. Handles duplicate server prevention and python/node runtime detection.
How do I install this agent skill?
npx skills add https://github.com/manalkaff/opendesign --skill run-opendesignIs this agent skill safe to install?
- Gen Agent Trust Hubwarn
The skill starts a local web server to preview files. However, it serves the entire project directory rather than just the preview files, which could expose sensitive information like configuration files to others on the same local network. It also downloads a standard serving tool from the npm registry if Python is not found.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
You are starting the OpenDesign preview server. Complete all steps below in order.
Port
Always use 8289.
Steps
-
Detect the platform.
Run:
uname -s 2>/dev/null- If the output starts with
MINGW,CYGWIN, orMSYS, or ifunameis not found, treat the platform as Windows. - Otherwise treat it as POSIX (Linux / macOS / WSL).
- If the output starts with
-
Check if a server is already running on port 8289.
POSIX:
lsof -ti tcp:8289- If no output, nothing is bound — continue to step 3.
- If a PID is returned, something is bound to :8289.
Windows (cmd/PowerShell):
netstat -ano | findstr LISTENING | findstr :8289- If no output, nothing is bound — continue to step 3.
- If output is returned, something is bound to :8289.
When something is bound on either platform, probe whether it is the OpenDesign server:
curl -sf -o /dev/null -w "%{http_code}" http://localhost:8289/opendesign/index.html- If the status code is
200, the OpenDesign server is already running. Skip to step 5. - Otherwise, tell the user:
Port 8289 is in use by another process. Please free the port and try again. Then stop.
-
Detect available runtime. Check in this order:
POSIX:
python3 --version 2>/dev/null || python --version 2>/dev/null || node --version 2>/dev/nullWindows:
python --version 2>$null; if ($LASTEXITCODE -ne 0) { python3 --version 2>$null }; if ($LASTEXITCODE -ne 0) { node --version 2>$null }Priority order (both platforms):
- POSIX:
python3→python→node - Windows:
python→python3→node(Windows distributions ship aspython, notpython3) - None found → tell the user: "Could not start the preview server — python, python3, and node are all unavailable. Open
./opendesign/index.htmlmanually or install Python." Then stop.
- POSIX:
-
Start the server in the background, serving from the project root (not from
./opendesign/).POSIX — capture the absolute project root first:
PROJECT_ROOT=$(pwd)Then start:
- python3:
python3 -m http.server 8289 --directory "$PROJECT_ROOT" & - python:
python -m http.server 8289 --directory "$PROJECT_ROOT" & - node:
npx --yes serve -l 8289 "$PROJECT_ROOT" &
Windows —
cdto the project root first (the--directoryflag is available on Python 3.7+ butcdis the safest cross-version approach), then start:- python:
Start-Process python -ArgumentList '-m','http.server','8289' -WorkingDirectory (Get-Location) -WindowStyle Hidden - python3:
Start-Process python3 -ArgumentList '-m','http.server','8289' -WorkingDirectory (Get-Location) -WindowStyle Hidden - node:
Start-Process npx -ArgumentList '--yes','serve','-l','8289',(Get-Location) -WindowStyle Hidden
Wait 1–2 seconds after starting, then confirm the port is now bound using the same check from step 2 for the detected platform. If nothing is bound after the wait, report: "Server failed to start. Try running
python -m http.server 8289manually from your project root." Then stop. - python3:
-
Print the clickable link to the user:
OpenDesign viewer is live: http://localhost:8289/opendesign/
Sidebar lists all mockups. Click any file to preview it in the iframe.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/manalkaff/opendesign/run-opendesign">View run-opendesign on skillZs</a>