custom-environment-setup

Original：🇺🇸 English

Translated

Project-specific environment setup for issue workflows. Calculates test ports and provides initialization context for minions.

1installs

Sourceedanstarfire/claudecode_webui

Added on2026-03-04

NPX Install

npx skill4agent add edanstarfire/claudecode_webui custom-environment-setup

SKILL.md Content

View Translation Comparison →

Custom Environment Setup

Purpose

This is a project-specific custom skill called by generic workflow skills at defined checkpoints. It provides environment configuration specific to this project (claudecode_webui).

Generic workflow skills invoke this skill if it exists; if absent, the workflow continues without project-specific environment setup.

Input

```
issue_number
```
(from $1 argument): The issue number being worked on

Output

When invoked, this skill should set the following environment variables/context for the caller:

Port Calculation

Backend Port = 8000 + (issue_number % 1000)
Vite Port = 5000 + (issue_number % 1000)

Examples:

Issue #42 -> Backend: 8042, Vite: 5042
Issue #372 -> Backend: 8372, Vite: 5372
Issue #1234 -> Backend: 8234, Vite: 5234

Initialization Context Fragment

Return this context fragment for inclusion in minion initialization:

Test Server Configuration:
- Backend Port: ${BACKEND_PORT} (8000 + issue_number % 1000)
- Vite Port: ${VITE_PORT} (5000 + issue_number % 1000)
- Data Directory: Default (data/) - DO NOT use --data-dir flag

Status Display Context

For

/status_workers

, provide:

Port range info: Backend ports 8000-8999, Vite ports 5000-5999

How to check running servers:

bash

# Check backend ports
lsof -i :8000-8999 2>/dev/null | grep LISTEN

# Check vite ports
lsof -i :5000-5999 2>/dev/null | grep LISTEN

Usage by Generic Skills

Generic workflow skills call this skill like:

Invoke custom-environment-setup skill with issue_number=$1

The skill returns port configuration and any project-specific init context. If this skill does not exist, the generic workflow proceeds without port/environment configuration.