port-allocator

Community

Automatically prevent dev server port conflicts.

Authorsusuyan
Version1.0.0
Installs0

System Documentation

What problem does it solve?

This skill eliminates the manual overhead of managing port conflicts across multiple Claude Code instances by automatically allocating, tracking, and refreshing per-project port ranges.

Core Features & Use Cases

  • Per-project port allocation: assigns a dedicated 10-port range to each project containing a package.json.
  • Auto-detection & scanning: automatically detects code roots and discovers new projects via package.json.
  • Safe operations: avoids touching non-project processes and build artifacts, and persists state to a registry.

Quick Start

Use the /port-allocator commands to configure your code root, scan for projects, and query or assign ports for the current project.

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: port-allocator
Download link: https://github.com/susuyan/skills/archive/main.zip#port-allocator

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.