Portpilot Assistant
Inspect, diagnose, allocate, and free local development ports using the bundled PortPilot CLI. Use when finding available ports, inspecting port listeners, resolving port conflicts, freeing ports, or managing PortPilot configuration.
Install
npx skills add lingengyuan/my-skills --skill portpilot-assistantgit clone --depth 1 https://github.com/lingengyuan/my-skills.git /tmp/my-skills
mkdir -p ~/.claude/skills
cp -r /tmp/my-skills/.claude/skills/portpilot-assistant ~/.claude/skills/portpilot-assistantPersonal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.
From the SKILL.md
# PortPilot Assistant Skill Inspect, allocate, and manage local network development ports using the bundled PortPilot CLI. Node.js 18+ is required. No global npm installation is needed. ## CLI Location Resolve the bundled executable relative to this Skill's directory: ```bash node "<skill-dir>/assets/portpilot/bin/portpilot.js" --help ``` In POSIX environments, `scripts/run_portpilot.sh` provides an optional wrapper for the same binary. ## Commands Reference | Command | Description | Example | |---------|-------------|---------| | `pick` | Reserve an available port with temporary lease | `node "<cli>" pick --range 3000-3999 --count 1 --lease-ms 20000 --json` | | `claim` | Consume an existing port lease | `node "<cli>" claim --lease-id <id> --json` | | `scan` | List currently listening ports and services | `node "<cli>" scan --protocol both --json` | | `who` | Identify process owning a specific port | `node "<cli>" who 3000 --json` | | `doctor` | Diagnose configuration issues and port conflicts | `node "<cli>" doctor --json` | | `free` | Terminate process holding a target port | `node "<cli>" free 3000 --yes --json` | | `init` | Create default port configuration | `node "<cli>" init --dry-run --json` | | `config` | View or migrate PortPilot configuration | `node "<cli>" config migrate --json` | ## Workflow 1. **Map user intent**: Identify the matching subcommand using [references/intent-map.md](references/intent-map.md).
Details
- Skill name
portpilot-assistant- Repository
- lingengyuan/my-skills
- Path
.claude/skills/portpilot-assistant/SKILL.md- License
- MIT
- Repo updated
- 14 November 2026
FAQ
What does the Portpilot Assistant skill do?
Inspect, diagnose, allocate, and free local development ports using the bundled PortPilot CLI. Use when finding available ports, inspecting port listeners, resolving port conflicts, freeing ports, or managing PortPilot configuration.
How do I install the Portpilot Assistant skill?
skills CLI (Claude Code, Cursor, Codex and more): npx skills add lingengyuan/my-skills --skill portpilot-assistant. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.
Is Portpilot Assistant popular?
It lives in lingengyuan/my-skills, which has 9 GitHub stars and 1 forks.
Related skills
Brief Output
9lingengyuan/my-skills
精简回答、技术说明与工程文档,删除冗余信息与 AI 味表达,只保留完成任务所需的必要事实与技术决策。适用于精简输出、压缩改写、去除 AI 腔调以及全文一致性修订。
Google Go Style
9lingengyuan/my-skills
按 Google Go Style 编写、重构或审查 Go 代码。用于命名、注释、接口、错误处理、并发、包组织与可维护性决策。
Insight Collector
9lingengyuan/my-skills
Analyze URLs, source code, images, technical documents, or notes, and archive reusable insights, code snippets, and architecture patterns into a knowledge base. Use when collecting knowledge, archiving technical articles, saving reusable code, or recording insights (收录, 记录一下).
Warden
10thatmike1/claude-skills
All-day accountability on request. Build a flexible day plan together, keep the current block visible, and check in through T3 Code with desktop reminders.
Pele
9lingengyuan/my-skills
Render Mermaid diagrams as SVG with Pele. Use its JavaScript API for custom rendering, theming and browser integration.
AI Native CLI
3ChaosRealmsAI/agent-cli-spec
AI-Native CLI design spec. Use when building CLI tools, designing command-line interfaces, or scaffolding new CLI projects. Covers structured JSON output, error handling, input contracts, safety guardrails, exit codes, and agent self-description. Includes an audit protocol for verifying CLI compliance.
Browse the most popular Claude skills, all software development skills, or write your own with the skills generator.