skills.rest
timothyshen
timothyshenCOMMUNITY
Explore all skills by this author →
Website𝕏@timtimtim_ethGitHub

port-allocator

Scan code directories for package.json projects and allocate 10-port ranges starting from 3000.

Updated Jan 24, 2026
Search Tags:#automation#development environment#port management#docker#conflict resolution#project discovery
One-click install
npx skills add https://github.com/timothyshen/word-game --skill port-allocator-timothyshen
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: port-allocator
Source: https://github.com/timothyshen/word-game/tree/main/.claude/skills/skill-portallocation
Command: npx skills add https://github.com/timothyshen/word-game --skill port-allocator-timothyshen

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill prevents port conflicts between multiple development instances by automatically allocating and managing unique port ranges for each project.

Core Features & Use Cases

  • Automatic Port Allocation: Assigns a dedicated 10-port range to each detected project.
  • Conflict Avoidance: Ensures that different development servers do not try to use the same ports.
  • Project Discovery: Scans directories to find new projects and allocate ports.
  • Use Case: When running multiple microservices or frontend applications simultaneously, this skill ensures each has its own set of ports, preventing "port already in use" errors.

Quick Start

Run /port-allocator scan to discover and allocate ports for all projects in your code directory.

Frequently Asked Questions about port-allocator

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I prevent port conflicts when running multiple development servers simultaneously?▼

To prevent port conflicts, you can scan code directories for projects containing package.json and automatically assign each project a dedicated 10-port range starting from 3000. This ensures different development servers do not try to use the same ports.

How does automatic port allocation work for projects with a package.json file?▼

Automatic port allocation works by scanning your local file system to discover projects containing package.json, then executing shell commands to assign each detected project a unique 10-port range to avoid overlapping server usage.

Can I use this to manage ports for multiple microservices or frontend applications?▼

Yes, you can manage ports for multiple microservices or frontend applications. The tool discovers new projects and allocates unique port ranges, preventing "port already in use" errors when running multiple instances concurrently.

What is the best way to list and configure allocated development server ports?▼

The best way to list and configure allocated development server ports is by using specific commands provided by the port manager to list active assignments, scan for new projects, and configure local file system configurations.

Do I need Docker to resolve development server port conflicts across multiple instances?▼

You do not need Docker strictly, as port conflict resolution operates by interacting with local file system configurations and executing shell commands for process management and file discovery across multiple Claude Code instances.

Related Skills

Explore More Software Engineering Skills→
twillcockstwillcocks

portal-setup

Initialize a Showpane workspace by installing dependencies and applying the SQLite Prisma schema.

Community
Advanced
k2worksk2works

killing-processes

Terminate Node.js development processes and free ports via CLI options.

Community
Intermediate
wrsmith108wrsmith108
4

docker

Run npm scripts inside Docker containers to isolate development tasks.

Community
Intermediate
ssv445ssv445
1

portless

Assign named .localhost URLs to local dev servers via a CLI proxy.

Community
Intermediate