fleet

Create and converge FLEET.md registries mapping sibling repository checkouts, groups, and ports.

5|1|Updated Mar 7, 2026
One-click install
npx skills add https://github.com/ai-hero/hero-skills --skill fleet-ai-hero
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: fleet
Source: https://github.com/ai-hero/hero-skills/tree/main/skills/fleet
Command: npx skills add https://github.com/ai-hero/hero-skills --skill fleet-ai-hero

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Developers working across multiple sibling repository checkouts lose track of which repos belong together, which host ports each dev stack claims, and whether the registry has drifted from what is actually on disk. This Skill maintains FLEET.md as the single local map of the folder so port collisions and stale rows are caught before they cause conflicts. ## Core Features & Use Cases - Bootstrap and converge: The sync mode scans a folder of git checkouts, proposes rows (name, group, port, description), and writes FLEET.md only after user confirmation. - Read-only drift review: The review mode reports findings such as unlisted checkouts, missing repos, port mismatches, and port collisions without writing anything. - Fleet-aware fan-out: Sends the ## Fleet section to each member repo as an inbox message so each repo lands the change in its own PR. - Use Case: You clone a new service next to your existing stack and run the sync mode to add it to FLEET.md, claim a free port from the configured range, and notify the other repos. ## Quick Start Run the fleet skill with the sync argument from the folder that holds my repository checkouts to scan them and propose a FLEET.md registry.

Frequently Asked Questions about fleet

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

FAQPage Schema
How do I create a FLEET.md registry for my repos?

Run the skill with the sync argument from the folder holding your checkouts. It scans for git repositories, asks for the fleet name, org, groups, and port range, then proposes rows and writes FLEET.md only after you confirm.

How do I check for port conflicts between local dev stacks?

Run the skill with the review argument, or no argument, from the fleet folder. It compares each row's claimed port against the repo's compose file and reports PORT_MISMATCH, PORT_COLLISION, and related findings without modifying anything.

Does the fleet sync edit my repositories directly?

No. Sync writes only FLEET.md at the fleet root. Repo-side changes like the AGENTS.md fleet section or port fixes are sent as inbox messages so each repo lands them in its own PR under its own review gates.

What happens when a checkout is added or removed from the folder?

The review scan reports UNLISTED for new checkouts not in FLEET.md and MISSING or NOT_GIT for rows whose folders disappeared. Sync then proposes adding or dropping those rows after asking for confirmation.

Can I run the fleet skill outside a git repository?

Yes, it is designed to run from the folder containing the checkouts, not inside a repo. It deliberately avoids the git root fallback so it never writes FLEET.md into a checkout by mistake.