ports

Read PORTS.md, check active ports with ss, and propose next available ports.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/fernando-fernandez3/claude-code-resources --skill ports
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ports
Source: https://github.com/fernando-fernandez3/claude-code-resources/tree/main/my-config/skills/ports
Command: npx skills add https://github.com/fernando-fernandez3/claude-code-resources --skill ports

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps teams quickly identify which ports are in use and determine the next available ports to prevent conflicts when creating new apps or services.

Core Features & Use Cases

  • Read current port assignments from PORTS.md to reveal active mappings.
  • Check running services on common port ranges (e.g., 8000, 3000, 5000) to verify availability.
  • Propose next available ports for Python backends, Node.js apps, and frontend development, and optionally register new ports in PORTS.md.

Quick Start

Use the ports skill to display the port registry and get suggested next available port numbers.

Frequently Asked Questions about ports

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

FAQPage Schema
How do I find the next available port for a new Node.js or Python backend?

To find the next available port, this skill reads your PORTS.md file and checks active ports using the ss command. It then proposes open ports in the 3000, 5000, or 8000 ranges for your Node.js, frontend, or Python backend deployment.

What is the best way to track port usage and avoid conflicts during project setup?

Tracking port usage involves maintaining a PORTS.md registry and checking active services. This skill automates that by reading current assignments, verifying availability with ss, and optionally registering new ports in PORTS.md to prevent deployment conflicts.

How do I check if a specific port range is already in use on my system?

To check if a port range is in use, this skill utilizes the ss command to scan for running services. It cross-references these active ports against your PORTS.md file to verify if ranges like 3000, 5000, or 8000 are currently available.

Can I automatically update my port registry when assigning a new service?

Yes, you can update your port registry automatically. After identifying the next available port for your Python or Node.js app, this skill can register the new assignment directly into your PORTS.md file to keep your project setup accurate.

Does this tool work with a specific port range for frontend development?

Yes, this tool works with the 5000 range for frontend development. It also handles the 3000 range for Node.js apps and the 8000 range for Python backends, checking availability and suggesting the next open port within these configured ranges.

Why do I need a PORTS.md file to check port availability?

A PORTS.md file provides a centralized registry of your project's assigned ports. This skill reads it to understand your existing mappings and cross-references it with active ss command results, ensuring proposed available ports do not conflict with your documented services.